Testando cadastros +236 quando ninguém na equipe tem um chip centro-africano

Por que uma etapa de verificação +236 é tão difícil de reproduzir do exterior?

A situação costuma ser esta: um produto chega à África Central francófona, alguém abre um bug dizendo que o código único nunca apareceu para um usuário em Bangui, e o engenheiro designado não tem como colocar um número centro-africano no formulário. Chips de roaming demoram a ser obtidos, colegas locais estão ocupados com trabalho de verdade e emuladores não geram um SMS genuíno de operadora.

Um serviço de roteamento de OTP como a OTP Route fecha essa lacuna, e a sua API de OTP da República Centro-Africana é a mesma usada em qualquer outro país. Em vez de enviar hardware de um lado para o outro, você pede uma linha +236 por uma chamada de API, digita-a na sua própria tela de cadastro e lê o código de volta por programa. A mesma requisição funciona numa sessão de notebook, num job de regressão noturno ou na aba do navegador de um engenheiro de suporte, o que faz um mercado de difícil acesso se comportar como mais uma linha da sua matriz de testes.

Quais serviços podem receber códigos SMS da República Centro-Africana hoje?

O retrato atual de cf lista mais de 900 serviços. Entre as rotas populares estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) e Uber.

A disponibilidade muda ao longo do dia conforme nossos parceiros de operadora giram o estoque, então trate qualquer lista de uma página web como ponto de partida, não como promessa. Antes de cada execução, consulte GET /api/v1/prices?country=cf&service=<id> para saber o preço atual e se a rota está aberta. Alguns apps do catálogo também recusam linhas virtuais por completo; essa é uma decisão do app, não da rede, e é exatamente por isso que pedidos sem resposta são reembolsados.

Como um backend pede um número +236 para testes?

Tudo fica sob https://otproute.com/api/v1 e se autentica com uma chave Bearer de prefixo or_live_, emitida no console de desenvolvedor. Uma sessão mínima da API de verificação por SMS é assim:

1. Consulte os identificadores uma vez com GET /api/v1/services e GET /api/v1/countries; a República Centro-Africana é cf.
2. Confirme preço e disponibilidade com GET /api/v1/prices.
3. Crie o pedido com POST /api/v1/activations e um corpo como {"service": "viber", "country": "cf"}.
4. Envie o número +236 retornado para a tela em teste.
5. Receba o código pelo webhook activation.sms_received ou consulte GET /api/v1/activations/{id} a cada poucos segundos.
6. Se o teste for interrompido, libere a linha com POST /api/v1/activations/{id}/cancel.

As chamadas de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>. O seu receptor deve reconstruir o HMAC-SHA256 de <t>.<raw body> com o segredo daquele endpoint, comparar com v1 em tempo constante e descartar qualquer entrega com timestamp antigo. O guia de captura por webhook mostra um handler completo, e a referência está na documentação da API.

O que devemos saber sobre números de telefone centro-africanos e o idioma das mensagens?

Os números da República Centro-Africana seguem um plano fechado de oito dígitos e sem prefixo de tronco, então as formas nacional e internacional diferem apenas pelo código do país. Armazene todos os valores em E.164, por exemplo +236 seguido dos oito dígitos locais, e remova espaços ou hifens na entrada. Uma validação que exija zero inicial, ou dez dígitos, vai rejeitar usuários reais em silêncio.

Francês e sango são os idiomas oficiais. A maioria dos apps internacionais envia o texto de verificação em francês ou inglês, conforme o idioma da conta, então faça seu parser procurar os dígitos em vez de uma frase específica. As equipes costumam testar aqui ao expandir um lançamento na África Ocidental ou Central, ao operar ferramentas de ONGs e de operações de campo ou ao atender clientes com família na região.

Quem não programa consegue obter um número de verificação da República Centro-Africana?

Sim. Gerentes de produto, líderes de suporte e a equipe de agências podem fazer tudo pelo navegador:

• Crie uma conta com um código por e-mail ou login do Google e ative a autenticação em dois fatores TOTP.
• Abra o OTP Gateway, escolha o serviço e selecione República Centro-Africana.
• Confira o preço atual exibido antes de pedir e confirme.
• Cole o número +236 no app e espere o código aparecer na tela.

A ativação fica aberta por 20 minutos. Você só paga se um código chegar; se cancelar ou deixar a janela fechar, o valor integral volta para a carteira.

E se o código nunca aparecer na linha +236?

Um número silencioso geralmente significa que o app limitou a requisição, recusou uma linha virtual ou que a rota estava ocupada. Siga com calma:

• Deixe a janela correr até o fim antes de decidir que falhou; alguns remetentes enfileiram mensagens.
• Cancele e tente de novo mais tarde, ou troque para outra rota do mesmo serviço, se houver.
• Verifique se o serviço é conhecido por rejeitar números virtuais; se for, nenhuma nova tentativa vai ajudar.
• Evite refazer o pedido em loop apertado. Tentativas repetidas podem acionar limites de taxa no app e do nosso lado (300 requisições por minuto por conta).

Há mais padrões em como reduzir falhas na entrega de OTP.

Existe uma linha +236 de longo prazo e como o uso é cobrado?

Não. Os Dedicated Numbers em autoatendimento existem apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, então não há uma linha centro-africana permanente para comprar no painel. Se um projeto realmente precisa de uma, escreva para [email protected]; se é possível providenciar depende das regras locais e não é algo que possamos prometer.

A cobrança do OTP Gateway sai de uma única carteira pré-paga em USD, sem mensalidade. A recarga é feita por cartão ou por stablecoins USDT/USDC, e cada recarga dispara uma fatura em PDF por e-mail. Quem quer ensaiar uma integração sem gastar pode pedir o modo sandbox, que devolve números e códigos simulados. Os valores completos estão na página de preços. Siga os termos de cada app; a Política de Uso Aceitável da OTP Route vale para todos os pedidos.

Perguntas frequentes

Como recebo códigos SMS OTP da República Centro-Africana sem um chip local?

Basta pedir um número +236 no OTP Gateway, digitá-lo no seu app e ler o código no painel, por um webhook ou pelo endpoint de ativações.

Qual é o id da República Centro-Africana na API?

É cf. Use-o na consulta de preços e no corpo da ativação.

Quanto custa um número +236 para testes?

Os códigos começam em $0.20 cada, e o valor exato depende do serviço. O valor atual de uma rota +236 aparece no painel e no endpoint de preços antes do pedido.

Um pedido +236 é cobrado se o texto de verificação não chegar?

Não. Se nenhuma mensagem chegar durante a janela de 20 minutos, ou se você cancelar antes, o valor integral é devolvido automaticamente à sua carteira.

Devo armazenar números centro-africanos com um zero inicial?

Não. O plano não tem prefixo de tronco, então mantenha a forma E.164 com +236 e os oito dígitos locais.

Posso manter o mesmo número +236 para logins futuros?

Não por autoatendimento. Cada número do OTP Gateway serve a um código, e as linhas de longo prazo são um produto dos EUA e do Canadá; você pode escrever ao suporte para perguntar sobre outras opções.

Há como testar a integração sem pagar?

Sim. Sob solicitação, uma conta de desenvolvimento pode passar para o sandbox, que simula números e códigos de ponta a ponta.

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.