Um checklist para receber códigos SMS do TikTok em testes e operações

Para que o TikTok envia códigos por SMS?

O TikTok permite criar uma conta com número de telefone, entrar com um código de uso único em vez de senha, ativar a verificação em duas etapas e recuperar o acesso quando a senha é esquecida. Cada um desses momentos pode gerar um código por SMS, e cada um é uma etapa que equipes que trabalham com o TikTok podem precisar reproduzir: uma agência confirmando uma conta de marca que administra, um engenheiro de QA verificando uma integração de login social ou uma equipe de operações que mantém o perfil da empresa fora do celular pessoal de um funcionário.

Um número virtual para o TikTok atende a esses casos, sendo a verificação por SMS do TikTok para testes o mais frequente. Todos são legítimos quando a conta pertence a você ou ao seu cliente e respeita os termos do TikTok.

Checklist pré-voo antes de pedir

Dez minutos nestes pontos antes do primeiro pedido do TikTok poupam horas de busca por códigos que não chegam:

• Escolha o mercado. O país do número deve corresponder à região da conta ou ao caso de teste que você está reproduzindo.
• Confira preço e disponibilidade. GET /api/v1/prices?country=<id>&service=tiktok retorna os dois, ao vivo.
• Abasteça a carteira. GET /api/v1/balance no início da execução falha rápido, em vez de falhar no meio do teste.
• Decida a forma de entrega. Webhook para CI e jobs em paralelo, consulta periódica para verificações manuais rápidas.
• Pense antes em um novo login. Se a conta precisar entrar de novo no mês que vem, um número de uso único é a ferramenta errada (veja a última seção).
• Conheça as regras. Uma conta por pessoa ou empresa real, os termos do TikTok e a Política de Uso Aceitável da OTP Route.

De qual país deve vir o número de telefone do TikTok?

A rota do TikTok está aberta em 202 países. Escolhas comuns incluem Estados Unidos, Canadá, Reino Unido, Alemanha, França, Brasil, México, Indonésia, Filipinas, Vietnã, Tailândia, Turquia, Arábia Saudita, Paquistão, Nigéria e Quênia.

A escolha do país não é cosmética. O TikTok adapta conteúdo, recursos e verificações de cadastro por região, então um caso de QA para um lançamento no Brasil deve usar um número +55, e um teste de localização nas Filipinas, um +63. Descombinar o número e o mercado da conta é um motivo comum para um fluxo se comportar de forma diferente do que os usuários veem.

Passo a passo: a API de código de verificação do TikTok

Autentique-se em https://otproute.com/api/v1 com uma chave Bearer começando com or_live_, obtida no console do desenvolvedor.

1. Descubra o id do país com GET /api/v1/countries; o id do serviço é tiktok.
2. Leia o preço atual: GET /api/v1/prices?country=br&service=tiktok.
3. Crie a ativação com POST /api/v1/activations e {"service": "tiktok", "country": "br"}. Guarde o id da ativação que vem na resposta.
4. Digite o número retornado na tela de telefone do TikTok e peça o código.
5. Obtenha-o pelo evento activation.sms_received ou consulte GET /api/v1/activations/{id} a cada poucos segundos.
6. Se o cenário for abandonado, chame POST /api/v1/activations/{id}/cancel para que o saldo volte imediatamente.

O limite da conta é de 300 requisições por minuto, de sobra para consultar várias ativações ao mesmo tempo. A documentação da API lista os formatos completos de requisição e resposta.

Montando o receptor de webhook

Registre um endpoint HTTPS no console do desenvolvedor (até 5 por conta) e assine activation.sms_received, activation.expired e activation.cancelled. Depois reforce a segurança:

• Separe X-OTPRoute-Signature em t e v1, calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint e compare em tempo constante.
• Rejeite timestamps com mais de alguns minutos para bloquear repetições maliciosas (replays).
• Trate o id da ativação como chave de idempotência, para que um evento reenviado não atualize nada duas vezes.
• Responda rápido com um 2xx e passe o trabalho demorado para uma fila.

Mantenha a consulta periódica como plano B no desenvolvimento local, onde não há URL pública. Nosso guia sobre como proteger webhooks de OTP percorre o código de verificação.

Solução de problemas: um código do TikTok que nunca aparece

O silêncio do TikTok costuma ter uma causa comum:

1. Deixe a janela correr. A ativação fica aberta por 20 minutos; se nada chegar, o valor integral é reembolsado automaticamente.
2. Aceite que alguns números são recusados. O TikTok pode recusar números virtuais em algumas regiões ou situações, e a regra de reembolso cobre esse caso.
3. Mude uma variável. Tente de novo mais tarde, ou com outro país que ainda sirva ao seu teste.
4. Vá mais devagar. Pedir códigos repetidamente em pouco tempo pode acionar os limites do próprio TikTok; espace as tentativas.
5. Confira o seu lado. Verifique se o número foi digitado no formato internacional completo e se o seu webhook devolveu um 2xx.

Quando uma linha dedicada dos EUA ou do Canadá é melhor?

Uma ativação de uso único serve para uma única verificação. Uma conta de marca que precisa entrar de novo, recuperar o acesso ou passar por verificações em duas etapas meses depois precisa de um número que a sua equipe mantenha. Os Números Dedicados atendem a esse caso nos Estados Unidos e no Canadá a partir de $1.95/mês, com SMS recebidos no painel e no seu webhook via number.sms_received; veja números virtuais. Linhas de longo prazo por autoatendimento não estão disponíveis em outros países.

Todo o gasto sai de uma única carteira pré-paga em USD, recarregada por cartão ou USDT/USDC, com fatura em PDF para cada recarga. Uma conta sandbox pode ser ativada mediante pedido para testes de integração com códigos simulados.

Perguntas frequentes

Como faço para que um código do TikTok seja entregue ao meu backend automaticamente?

Peça uma ativação com o id de serviço tiktok e receba o código pelo webhook assinado activation.sms_received ou consultando GET /api/v1/activations/{id}.

Posso testar a verificação por SMS do TikTok em um país específico?

Sim. Escolha o país ao criar a ativação; a rota do TikTok cobre hoje 202 países, e a disponibilidade atual vem do endpoint de preços.

Quanto custa um OTP do TikTok?

A partir de $0.20 por código, variando por país. O valor exato aparece no painel e em GET /api/v1/prices antes de você pedir.

O que acontece quando o TikTok rejeita o número virtual?

Nenhum SMS chega, então a ativação expira após 20 minutos ou você a cancela, e o valor integral volta para a sua carteira.

Um número de uso único basta para uma conta de marca que administramos a longo prazo?

Em geral, não. Para logins repetidos e recuperação, use um Número Dedicado dos EUA ou do Canadá que a sua equipe mantenha enquanto ele renova.

Posso usar a OTP Route para criar muitas contas do TikTok?

Não. A OTP Route serve para testar e operar suas próprias contas e produtos legítimos; siga os termos do TikTok e mantenha uma conta por pessoa ou empresa real.

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.