Levando códigos de verificação do Chade (+235) para a sua pilha

Qual é a sequência de chamadas de uma requisição à API de OTP do Chade?

As requisições do Chade usam a mesma URL base de qualquer outro mercado, https://otproute.com/api/v1, autenticadas com uma chave Bearer or_live_. Você cria chaves no console de desenvolvedor; uma conta pode ter até 10 delas e fazer 300 requisições por minuto.

Uma execução típica do Chade leva quatro chamadas:

1. GET /api/v1/countries e GET /api/v1/services para confirmar que td está na lista e descobrir o id do serviço que o seu teste usa.
2. GET /api/v1/prices?country=td&service=<id> para ler o preço atual desse par antes de gastar qualquer coisa.
3. POST /api/v1/activations com um corpo como {"service": "telegram", "country": "td"}. A resposta traz um id de ativação e o número +235 para digitar no app em teste.
4. Aguarde o código e deixe a ativação se completar, ou chame POST /api/v1/activations/{id}/cancel se o teste for interrompido antes.

Vale chamar GET /api/v1/balance no início de um job de CI para que o pipeline falhe de forma clara com a carteira vazia, em vez de estourar o tempo no meio. A referência completa está na documentação para desenvolvedores.

Como um receptor de webhook deve tratar os códigos +235?

Consultar GET /api/v1/activations/{id} a cada poucos segundos funciona para um único script. Quando vários executores de teste compartilham uma chave, um webhook é mais limpo. Registre um endpoint (cinco por conta) e assine activation.sms_received, activation.expired e activation.cancelled.

Cada requisição inclui um cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Reconstrua a string <t>.<raw body>, assine-a com HMAC-SHA256 usando o segredo do endpoint e compare com v1 em tempo constante. Rejeite qualquer coisa com timestamp antigo; isso fecha a porta para requisições reenviadas. Nosso guia sobre como proteger webhooks de OTP com HMAC mostra o processo em várias linguagens.

Trate o id da ativação como chave de idempotência. Se o mesmo evento for entregue duas vezes, a segunda gravação não deve mudar nada, e o seu handler deve devolver um 2xx rapidamente e deixar o trabalho lento para depois.

Quais apps podem enviar códigos a um número de verificação do Chade?

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

A disponibilidade não é estática. As rotas abrem e fecham ao longo do dia conforme nossos parceiros de operadora deslocam capacidade, então um serviço visível de manhã pode sumir à tarde. Leia o catálogo em tempo de execução em vez de fixá-lo no código e mantenha um segundo serviço no seu plano de testes, caso o primeiro esteja temporariamente indisponível para o Chade.

Como armazeno e normalizo um número +235?

O Chade usa um plano de numeração fechado: os números nacionais têm oito dígitos e não há prefixo de tronco para remover, então a forma E.164 é simplesmente +235 seguido desses oito dígitos. Isso faz do Chade um dos mercados mais fáceis de validar.

• Armazene a string E.164 completa em uma única coluna, em vez de separar o código do país e o número de assinante.
• Se o seu formulário aceita espaços ou o agrupamento de dois em dois que as pessoas costumam digitar, remova-os antes de salvar.
• Verifique nos testes que um valor com um 0 inicial perdido seja rejeitado ou limpo, já que usuários vindos de outros planos às vezes o acrescentam por hábito.

Francês e árabe são os idiomas oficiais. A redação de um SMS de verificação, porém, segue o idioma configurado no app ou na conta, então uma suíte de localização deve conferir separadamente os modelos em francês, árabe e inglês.

Por que as equipes de produto fazem testes no Chade?

Poucas equipes de engenharia ficam em N'Djamena, e é justamente por isso que um número +235 remoto é útil. Motivos comuns que vemos:

• Lançamentos na África Central francófona, em que um produto já no ar em mercados vizinhos acrescenta o Chade ao seletor de país do cadastro e precisa provar que o fluxo funciona.
• QA de localização em árabe e francês, incluindo o layout da direita para a esquerda na tela de entrada do código.
• Clientes da diáspora que mantêm um número chadiano morando no exterior, o que afeta como as suas regras antifraude leem o código do país.
• Equipes de operações que gerenciam contas de mensagens empresariais para parceiros regionais.

O padrão mais amplo é descrito em roteamento de OTP por país.

E se o código do Chade nunca chegar?

Um número silencioso costuma ser um problema de rota ou de aceitação, não um bug no seu código. Siga nesta ordem:

• Dê à janela de 20 minutos a chance de correr; alguns remetentes agrupam suas mensagens.
• Verifique se o serviço de destino aceita números virtuais. Alguns não aceitam, e é por isso que o reembolso existe.
• Tente de novo mais tarde, ou com outro serviço no mesmo país, em vez de refazer o pedido em loop apertado. Repetições rápidas podem acionar os limites do próprio remetente.
• Confirme que o seu handler verificou a assinatura corretamente; um webhook rejeitado parece um código ausente.

Se a janela fechar ou você cancelar, o valor integral volta para a carteira sem abrir chamado de suporte. Há mais táticas em como reduzir falhas na entrega de OTP.

Existe uma linha de longo prazo no Chade e como ela é cobrada?

Não há número de longo prazo em autoatendimento para o Chade. Os Dedicated Numbers são um produto dos Estados Unidos e do Canadá, a partir de $1.95/mês, com SMS de entrada e saída e chamadas pelo navegador. Se você precisa de uma linha +235 duradoura, escreva para [email protected]; a disponibilidade depende das regras locais e não é algo que possamos prometer.

As cobranças dos códigos +235 saem de um único saldo pré-pago em USD; não há nível de assinatura nem mensalidade. A recarga é feita por cartão ou por stablecoins USDT/USDC, e uma fatura em PDF chega à sua caixa de entrada após cada depósito. Os valores atuais aparecem na página de preços. Para trabalho de integração, peça a troca para o sandbox: ele devolve números e códigos simulados para você ensaiar o fluxo sem tocar nos fundos da carteira. Abrir uma conta nova leva um código de seis dígitos por e-mail, ou o login do Google, se a sua equipe preferir.

Perguntas frequentes

Qual é o id do Chade na API da OTP Route?

Use td no campo country de POST /api/v1/activations e na consulta de preços.

Posso testar o fluxo de cadastro do meu app no Chade sem um chip local?

Sim. Peça um número +235 no OTP Gateway, digite-o no seu app e leia o código no painel, pela API ou por um webhook.

Por quanto tempo um número +235 fica utilizável?

Uma ativação fica aberta por 20 minutos e cobre um único código. Depois disso, peça um novo.

Pago se o SMS nunca chegar?

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

Os números do Chade precisam ter um prefixo de tronco removido?

Não. O Chade não tem prefixo de tronco, então a forma armazenada é +235 mais o número nacional de oito dígitos.

Posso manter um número do Chade para logins futuros?

Não por autoatendimento. Os Dedicated Numbers de longo prazo existem apenas nos EUA e no Canadá; para o Chade, escreva à equipe para perguntar o que é possível.

Há regras de uso?

Sim. Siga os termos de cada serviço e a Política de Uso Aceitável da OTP Route; o gateway serve para testar e operar seus próprios produtos e contas legítimos.

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.