Receber códigos SMS do LINE em números da OTP Route: checklist e passos

Para que o LINE usa um número de telefone?

O LINE vincula uma conta a um número de telefone. Um novo registro é confirmado com um código por SMS, e o aplicativo pode pedir o número de novo quando a conta é movida para um novo aparelho ou quando alguém entra depois de reinstalar. O número também tem papel na recuperação do acesso, então importa com qual número a conta foi criada.

Esse último ponto define a escolha do produto: um número de uso único serve a uma única etapa de verificação, enquanto uma conta que precisará entrar de novo meses depois exige um número que você ainda controle.

Checklist antes de pedir um número do LINE

• Uma chave de API do console do desenvolvedor (prefixo or_live_); até 10 chaves por conta.
• Saldo suficiente na carteira, confirmado com GET /api/v1/balance.
• Um país escolhido conforme o mercado da conta ou do caso de teste.
• Uma consulta de preço atual para esse par, porque os preços variam por país.
• Um endpoint de webhook registrado e a verificação de assinatura testada, ou um loop de consulta pronto.
• Uma decisão sobre se essa conta precisará entrar de novo mais tarde; se sim, leia a seção sobre Número Dedicado abaixo.
• Uma releitura rápida dos termos do LINE para o tipo de conta que você está criando.

Quais países posso escolher para o LINE e por que isso importa?

O serviço do LINE está disponível em 197 países. O aplicativo tem suas maiores bases de usuários em partes do Leste e do Sudeste Asiático, então equipes que lançam produtos por lá costumam começar com Japão, Tailândia, Taiwan, Indonésia, Hong Kong ou Malásia. Outras opções incluem Singapura, Filipinas, Vietnã, Coreia do Sul, Austrália, Estados Unidos, Reino Unido, Alemanha, Brasil e Romênia.

Escolha o país de onde vêm os seus usuários reais. Uma build para o mercado tailandês deve ser verificada com um número tailandês, para que o código do país, o formato do telefone e eventuais telas regionais de onboarding se comportem como em produção. Cobrir vários mercados exige pouco esforço extra, porque só o valor de country muda entre as execuções.

Passo a passo: o fluxo da API de código de verificação do LINE

1. Chame GET /api/v1/prices?country=<id>&service=linemessenger e confirme que a rota está disponível.
2. Crie a ativação com POST /api/v1/activations e um corpo como {"service": "linemessenger", "country": "th"}.
3. Informe o número retornado na tela de verificação de telefone do LINE.
4. Aguarde activation.sms_received ou consulte GET /api/v1/activations/{id} a cada poucos segundos, dentro do limite de 300 requisições por minuto.
5. Se a execução for abandonada, chame POST /api/v1/activations/{id}/cancel.

Os detalhes dos endpoints estão na documentação para desenvolvedores.

Como o handler de webhook deve tratar os eventos do LINE?

Leia o cabeçalho X-OTPRoute-Signature, no formato t=<unix>,v1=<hex>, calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte tudo que tiver um timestamp antigo. Depois use o id da ativação como chave do processamento, para que uma entrega repetida atualize o mesmo registro em vez de disparar o seu passo de teste duas vezes. Trate activation.expired e activation.cancelled como desfechos normais na mesma tabela. O guia de HMAC traz um passo a passo completo.

Pedindo um número do LINE pelo painel

Entre, abra o OTP Gateway, escolha o LINE e um país, confira o preço exibido e faça o pedido. Digite o número no LINE e mantenha o cartão da ativação aberto; o código aparece ali quando for recebido. Gerentes de produto e agentes de suporte costumam usar essa tela para verificar à mão um onboarding localizado do LINE antes de a suíte automatizada assumir. Valem a mesma janela de 20 minutos e a mesma regra de reembolso.

Solução de problemas: por que um código do LINE pode não chegar

O LINE pode recusar alguns números virtuais, e uma rota que funcionou antes pode ficar indisponível mais tarde no dia. Se nenhum SMS chegar, a ativação é reembolsada integralmente quando a janela se fecha ou quando você cancela. Depois disso:

• tente outro país que ainda combine com o caso de teste;
• tente de novo mais tarde em vez de refazer o pedido em um loop apertado;
• confirme que o número foi digitado com o código de país correto.

Quando um Número Dedicado é a melhor opção para o LINE?

Se uma conta de staging ou um login compartilhado da equipe precisa continuar entrando, um número de uso único é a ferramenta errada. Os Números Dedicados nos Estados Unidos e no Canadá começam em $1.95/mês, recebem SMS no painel e no seu webhook via number.sms_received e renovam pela carteira até você liberá-los. Os detalhes estão na página de números virtuais.

Use a OTP Route apenas para os seus próprios produtos e contas legítimos: uma conta por pessoa ou empresa real, respeitando os termos do LINE e seguindo a Política de Uso Aceitável.

Perguntas frequentes

Qual id de serviço a OTP Route usa para o LINE?

O id é linemessenger. Use-o na consulta de preços e no campo service ao criar uma ativação.

Posso fazer a verificação por SMS do LINE para testes sem um chip físico?

Sim. Um número do OTP Gateway recebe o código do LINE, que você lê pela API, por um webhook ou no painel.

Qual país devo escolher para um número virtual do LINE?

Escolha o mercado ao qual pertencem os seus usuários ou o seu caso de teste, por exemplo Japão ou Tailândia para um lançamento por lá.

O LINE aceitará todos os números da OTP Route?

Nem sempre. O LINE pode rejeitar alguns números virtuais, e quando nenhum código chega você é reembolsado automaticamente.

Quanto custa receber um OTP do LINE?

A partir de $0.20 por código, dependendo do país; o preço atual vem de GET /api/v1/prices.

Posso manter o mesmo número do LINE para logins futuros?

Somente com um Número Dedicado, disponível nos EUA e no Canadá. Os números de uso único servem a um único código.

Preciso de um webhook para receber códigos OTP do LINE ou a consulta periódica basta?

Consultar GET /api/v1/activations/{id} funciona bem para execuções pequenas. Os webhooks escalam melhor quando muitas ativações rodam em paralelo.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.