Números de verificação do Quênia (+254) para equipes de QA e lançamentos de mercado

Por que as equipes de produto testam o mercado queniano?

Nairóbi é um dos polos de tecnologia mais movimentados da África Oriental, e os usuários quenianos são totalmente mobile-first. Para muitos deles, o número de telefone é a principal identidade por trás de mensagens, transporte por app, e-commerce e, sobretudo, dinheiro móvel; por isso um fluxo de cadastro que trata mal um número +254 perde clientes no primeiro dia.

O inglês e o suaíli são idiomas oficiais. A maioria dos apps globais envia códigos em inglês, enquanto produtos localizados para a região podem passar ao suaíli, o que vale conferir se os seus próprios modelos estão traduzidos. Motivos comuns para testar aqui:

• lançar um produto de fintech, entregas ou marketplace na África Oriental;
• verificar o texto em suaíli nos modelos de SMS e nas telas de onboarding;
• operar contas de suporte ou de operações para clientes quenianos sem expor os números dos funcionários.

Nossa página de onboarding fintech trata do padrão mais amplo.

Como um celular queniano é escrito em E.164?

Localmente, os celulares são escritos com o prefixo de tronco 0, como em 07XX XXX XXX ou 01XX XXX XXX. Internacionalmente o zero é removido: +254 seguido de um número de assinante de nove dígitos.

O defeito clássico é manter esse zero depois do código do país, produzindo uma string inválida +2540... que o remetente rejeita sem um erro claro. Normalize toda entrada antes de ela chegar ao banco de dados:

1. Remova espaços, hifens e parênteses.
2. Se o valor começar com 0, remova-o e adicione +254 na frente.
3. Se começar com 254 sem o sinal de mais, adicione o +.
4. Armazene o resultado como string E.164 e valide o tamanho depois de normalizar.

Um número +254 para testes facilita provar cada ramo dessa lógica contra um SMS de entrada real.

Quais serviços estão na rota do Quênia agora?

O Quênia tem um dos catálogos mais amplos, com mais de 2.800 serviços no retrato atual. Entre os mais pedidos estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Uber, LinkedIn, Signal e Netflix.

A disponibilidade pode mudar de hora em hora, e é por isso que a API a informa em tempo real em vez de uma lista fixa.

Como integrar a API OTP do Quênia a uma suíte de testes?

Autentique-se em https://otproute.com/api/v1 com uma chave Bearer prefixada por or_live_ do console de desenvolvedor. O id do país Quênia é ke.

Uma etapa típica de CI primeiro chama GET /api/v1/balance, para que a execução falhe rápido com uma carteira vazia. Depois verifica GET /api/v1/prices?country=ke&service=<id>, faz o pedido com POST /api/v1/activations usando um corpo como {"service": "uber", "country": "ke"} e digita o número +254 retornado no app em teste. O código volta pelo webhook activation.sms_received ou por polling em GET /api/v1/activations/{id} a cada poucos segundos, com folga dentro do limite de 300 requisições por minuto.

Nos webhooks, registre até 5 endpoints e verifique X-OTPRoute-Signature calculando HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, rejeitando timestamps antigos. Indexe seu handler pelo id da ativação para que uma entrega repetida seja inofensiva. O guia de testes em CI mostra como isso se encaixa em um pipeline, e a documentação traz a referência completa.

Dá para pedir um número +254 sem escrever código?

Sim. No painel, abra o OTP Gateway, escolha o Quênia, selecione o serviço e confirme o preço exibido. O número aparece na hora; cole-o no formulário de cadastro ou de login, e o código surge ao lado da ativação assim que for recebido. Agentes de suporte e gerentes de contas podem trabalhar assim enquanto os engenheiros usam a API na mesma carteira.

O que ajuda quando um código queniano está atrasado ou ausente?

Toda ativação tem uma janela de 20 minutos. Você só paga se o código chegar; quando a janela se esgota vazia, ou você cancela com POST /api/v1/activations/{id}/cancel, o valor volta para a sua carteira sem abrir chamado.

Antes de tentar de novo, dê tempo à janela, já que alguns remetentes enfileiram mensagens. Se ainda assim falhar, tente de novo mais tarde ou por outra rota de serviço e verifique se o app aceita números virtuais, porque alguns não aceitam. Evite martelar o endpoint de pedidos em um loop apertado; muitos remetentes limitam requisições repetidas ao mesmo fluxo. Nosso artigo sobre como reduzir entregas de OTP com falha reúne outras correções. Mantenha todo teste dentro dos termos do serviço de destino; a Política de Uso Aceitável da OTP Route se aplica.

Linhas de longo prazo, carteira e sandbox para projetos no Quênia

A OTP Route não vende um número queniano de longo prazo em autoatendimento. As linhas dedicadas são oferecidas apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS de entrada, SMS de saída e chamadas pelo navegador. As equipes que precisam de uma linha +254 contínua podem escrever para [email protected] e perguntar, embora a disponibilidade dependa das regras locais.

O pagamento é conforme o uso, a partir de uma única carteira em USD, recarregada com cartão ou com as stablecoins USDT ou USDC, e cada recarga gera uma fatura em PDF. Não há mensalidade; veja os preços para saber como os custos são exibidos. Uma conta de desenvolvimento pode ser migrada para o sandbox sob solicitação, devolvendo números e códigos simulados para testes de integração de ponta a ponta sem custo para a carteira.

Perguntas frequentes

Posso testar o cadastro queniano do meu app de fora do Quênia?

Sim. Peça um número +254 no OTP Gateway e leia o código recebido no painel ou pela API, de onde sua equipe estiver.

Qual id de país envio para o Quênia?

Envie ke na consulta de preços e no corpo da ativação, por exemplo {"service": "whatsapp", "country": "ke"}.

Devo armazenar os números quenianos com o zero inicial?

Não. Remova o prefixo de tronco 0 e armazene o número como +254 seguido de nove dígitos.

Os textos de verificação do Quênia chegam em suaíli?

Em geral chegam em inglês, mas um app localizado para o Quênia pode enviar em suaíli; confira os dois se os seus modelos estão traduzidos.

O que acontece com meu dinheiro se o código nunca chegar?

Ele volta para a carteira automaticamente quando a janela de 20 minutos fecha sem SMS, ou imediatamente quando você cancela.

Webhook ou polling: qual é melhor para códigos +254?

Os webhooks escalam melhor para jobs de teste paralelos, enquanto o polling em GET /api/v1/activations/{id} é mais simples para um único script. Ambos leem a mesma ativação.

Posso ter um número queniano que eu mantenha todo mês?

Não em autoatendimento. Os números dedicados se limitam aos EUA e ao Canadá; escreva para [email protected] se precisar de uma linha queniana.

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.