Receba SMS OTP tanzanianos (+255) no seu painel ou no seu pipeline

Por que as equipes que lançam produtos na África Oriental testam com números +255?

A Tanzânia é um dos maiores mercados móveis da África Oriental, e o celular é a principal forma de muita gente chegar a serviços online, de mensagens a dinheiro móvel. Suaíli e inglês são ambos oficiais, com o suaíli dominando a conversa cotidiana, então um produto que entra no mercado costuma lançar uma interface em suaíli junto com a em inglês.

Motivos típicos para pedir um número +255 para testes:

• Verificar se uma tela de onboarding em suaíli, as mensagens de erro e o aviso do SMS ficam naturais juntos.
• Fazer uma rodada pré-lançamento sob a perspectiva de Dar es Salaam antes de uma campanha de marketing.
• Verificar as contas empresariais da própria empresa para uma central de suporte regional sem expor os chips pessoais dos funcionários.

Nossas notas sobre verificação de apps móveis descrevem como as equipes estruturam essas verificações.

Quais serviços estão roteados para a Tanzânia agora?

A Tanzânia tem atualmente mais de 1.600 serviços disponíveis no OTP Gateway. Entre as rotas mais usadas estão WhatsApp, Telegram, Facebook, Instagram, TikTok, Snapchat, X (Twitter), Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, imo, Uber e ChatGPT (OpenAI).

O roteamento de OTP é decidido por serviço e por país, e o conjunto muda ao longo do dia, então consulte a API em vez de confiar em uma lista em cache.

Como obtenho um código tanzaniano pela API?

Aponte o seu cliente para https://otproute.com/api/v1 e envie uma chave Bearer com o prefixo or_live_, gerada no console do desenvolvedor. O id do país da Tanzânia é tz.

• Descobrir: GET /api/v1/countries e GET /api/v1/services fornecem os ids; guarde-os em cache.
• Preço: GET /api/v1/prices?country=tz&service=<id> retorna o preço ao vivo para essa combinação.
• Pedir: POST /api/v1/activations com {"service": "telegram", "country": "tz"} retorna um id de ativação e um número +255.
• Receber: escute o webhook activation.sms_received ou faça polling em GET /api/v1/activations/{id}.
• Limpar: POST /api/v1/activations/{id}/cancel quando uma execução for abandonada.

Para jobs de CI em paralelo, os webhooks respeitam melhor o limite de 300 requisições por minuto do que um polling agressivo. Torne o handler idempotente pelo id da ativação e verifique o HMAC de X-OTPRoute-Signature antes de confiar no corpo; o artigo sobre captura por webhook mostra o passo a passo. Esse fluxo da API OTP da Tanzânia é a mesma API de verificação por SMS usada em todos os outros países.

E sem escrever código?

Abra o painel, vá ao OTP Gateway, selecione a Tanzânia e o seu serviço e confirme o preço exibido. Copie o número +255 para o app que você está testando; o código aparece ao lado do pedido assim que o SMS é recebido, enquanto um cronômetro mostra quanto resta dos 20 minutos. A equipe de operações que verifica uma conta da empresa por mês costuma ficar nesse caminho, porque ele não exige mais do que um navegador e uma carteira com saldo, sem chave de API para criar ou rotacionar.

Como os números de telefone tanzanianos são escritos?

Dentro da Tanzânia, os celulares são discados com um 0 de tronco, então localmente aparecem como 07… ou 06… seguido de mais oito dígitos. No formato internacional o zero some e você obtém +255 mais nove dígitos, por exemplo um número começando com +2557.

Armazene a versão E.164 e normalize o que os usuários digitarem: remova os espaços, converta um 0 inicial em +255 e trate 00255 como +255. Formatos misturados em uma mesma tabela causam contas duplicadas e buscas que falham. Espere textos de verificação em inglês na maioria das plataformas internacionais, e em suaíli em alguns remetentes locais ou quando o idioma da conta está definido para ele.

O código +255 não chegou. E agora?

Você não é cobrado pelo silêncio. Se a janela de 20 minutos se encerrar sem SMS, ou se você cancelar, o valor integral volta para a sua carteira. Antes de tentar de novo, considere as causas habituais: o serviço pode recusar números virtuais, a entrega dele para a Tanzânia pode estar lenta naquele momento ou o número específico pode não servir para aquela plataforma. Espere a janela terminar, tente de novo mais tarde ou por outra rota de serviço e resista a refazer o pedido rapidamente. O guia de falhas de entrega traz uma lista de verificação mais longa.

Números de longo prazo, carteira e sandbox

Um número tanzaniano de longo prazo em autoatendimento não existe na OTP Route. Os Números Dedicados estão limitados aos Estados Unidos e ao Canadá, a partir de $1.95/mês; para uma linha +255 duradoura, escreva para [email protected], e a disponibilidade depende das regras locais.

Você financia tudo a partir de uma única carteira pré-paga em USD, sem planos nem mensalidade. São aceitas recargas por cartão e USDT/USDC, cada uma com uma fatura em PDF enviada por e-mail. Uma conta de desenvolvimento pode ser movida para o sandbox, sob pedido, para que números e códigos simulados exercitem primeiro a sua integração.

Perguntas frequentes

Posso verificar uma conta tanzaniana de fora da Tanzânia?

Sim. O número +255 é provisionado online e o código é mostrado no seu painel ou entregue ao seu servidor, esteja a sua equipe onde estiver.

Qual código de país a API espera para a Tanzânia?

Use tz como id do país nas consultas de preço e em POST /api/v1/activations.

Quanto custa receber um SMS OTP da Tanzânia?

A partir de $0.20 por código. O preço exato depende do serviço e é retornado ao vivo por GET /api/v1/prices.

O zero inicial deve ser mantido nos números armazenados?

Não. Armazene +255 mais o número nacional de nove dígitos e converta na entrada qualquer valor com prefixo 0.

Posso testar um fluxo de cadastro em suaíli?

Sim. Configure o seu app ou dispositivo de teste para suaíli, registre-se com um número +255 do OTP Gateway e leia o código que o seu app disparar.

Meu dinheiro é devolvido se um código nunca chegar?

Sim. Uma ativação que expira após 20 minutos ou é cancelada é reembolsada integralmente na sua carteira.

Todos os serviços tanzanianos são compatíveis com esses números?

Nem todos. Algumas plataformas rejeitam números virtuais, e você deve respeitar os termos de cada serviço e a Política de Uso Aceitável da OTP Route.

Posso ter uma linha tanzaniana mensal para uma equipe de suporte?

Não por autoatendimento. Os Números Dedicados mensais estão disponíveis apenas nos EUA e no Canadá; escreva para a equipe por e-mail para perguntar sobre a Tanzânia.

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.