Como rotear códigos de verificação da República do Congo (+242) para a sua pilha de testes

Quais chamadas de API buscam um código +242 do início ao fim?

Tudo fica em https://otproute.com/api/v1 e se autentica com uma chave Bearer que começa com or_live_. Gere as chaves no console do desenvolvedor; uma conta pode ter até 10, o que facilita dar ao staging, ao CI e ao notebook de um colega credenciais separadas, revogáveis de forma independente.

Uma execução de testes típica para o mercado de Brazzaville é assim:

1. Obtenha GET /api/v1/services e GET /api/v1/countries e guarde os IDs em cache. A República do Congo é cg (não confundir com o vizinho maior, que tem ID e página próprios em Congo (RDC)).
2. Peça GET /api/v1/prices?country=cg&service=<id> para ver o preço ao vivo e a disponibilidade do app que você está testando.
3. Crie a ativação com POST /api/v1/activations e um corpo como {"service": "telegram", "country": "cg"}. Você recebe um ID de ativação e um número +242.
4. Digite esse número na tela de cadastro ou login do seu próprio produto.
5. Recolha o código congolês por uma entrega de webhook ou fazendo polling em GET /api/v1/activations/{id}. Se o teste for abortado, libere-o com POST /api/v1/activations/{id}/cancel.

Rode GET /api/v1/balance antes de iniciar uma suíte, para que uma carteira vazia derrube o job logo no começo, e não no meio. O limite de 300 requisições por minuto deixa bastante folga para alguns workers em paralelo. Os formatos completos de requisição e resposta estão na documentação para desenvolvedores.

Como configurar um webhook assinado para ativações congolesas?

O polling serve para um engenheiro clicando em um fluxo; um webhook é mais gentil com uma frota de CI. Adicione um endpoint no console do desenvolvedor (são permitidos cinco por conta) e assine activation.sms_received, activation.expired e activation.cancelled.

Toda requisição traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstrua o HMAC-SHA256 de "<t>.<raw body>" usando o segredo daquele endpoint, compare com v1 em uma checagem de tempo constante e descarte tudo cujo timestamp esteja antigo. Calcule o hash dos bytes brutos antes de qualquer parse de JSON, porque um JSON reserializado raramente coincide byte a byte.

Trate os eventos como indexados pelo ID da ativação. Se o mesmo evento chegar duas vezes, o seu handler deve perceber que o ID já foi resolvido e apenas devolver um status de sucesso. O guia de captura por webhook mostra padrões de fila que evitam timeouts em executores de teste lentos.

Que serviços um número de verificação do Congo pode cobrir?

O retrato de hoje para cg inclui WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber e imo. No total, o país tem mais de 1.000 serviços no OTP Gateway.

Essa lista muda ao longo do dia, conforme rotas abrem e fecham; portanto, nunca a fixe no código. Deixe o seu harness de testes consultar o endpoint de preços para o serviço de que precisa e pule ou reagende com elegância quando a disponibilidade estiver vazia. Os apps de mensagens tendem a dominar o cenário congolês, o que combina com a forma como muitos clientes lá conhecem um produto novo: por um link compartilhado em um grupo de chat, e não por uma busca na loja de apps.

Como armazenar e normalizar números +242?

Os números da República do Congo têm nove dígitos depois do código do país e, diferentemente de muitos planos, o 0 inicial faz parte do número do assinante, e não de um prefixo de tronco. As linhas móveis costumam ser escritas como 06… ou 05… localmente e como +242 06… na forma internacional. Um normalizador copiado de uma base de código europeia que remove qualquer zero inicial vai corrompê-los em silêncio; por isso, armazene exatamente a string E.164 que a API devolve e valide o tamanho por país, em vez de usar uma regra global única.

O francês é o idioma oficial e o usual nos SMS de verificação, embora o lingala e o kituba sejam muito falados no dia a dia. Espere caracteres acentuados em alguns modelos e garanta que o seu parser extraia os dígitos com um padrão, em vez de depender de um texto fixo em inglês.

As equipes costumam testar aqui ao levar um produto para a África Central francófona, ao apoiar a equipe de operações em Brazzaville ou Pointe-Noire, ou ao atender clientes congoleses no exterior que ainda se cadastram com um número de casa. Checar o fluxo inteiro em uma rota +242 real pega problemas de formatação e de texto que um simulador deixaria passar.

E se nenhum código chegar ao número +242?

O silêncio costuma ser um problema de rota ou de aceitação, e não um bug de integração. Um roteiro sensato:

• Deixe a janela de 20 minutos correr até o fim antes de concluir algo; alguns remetentes agrupam seu tráfego de saída.
• Confirme se o serviço de destino aceita números virtuais. Vários não aceitam, e é justamente por isso que um código não recebido não custa nada.
• Tente de novo mais tarde, ou troque para outra rota de serviço, em vez de disparar novos pedidos em um laço apertado que gasta o limite de requisições.
• Cancele os números de que não precisa mais, para que o valor volte na hora, em vez de esperar a expiração.

Nosso artigo sobre como reduzir falhas na entrega de OTP trata de backoff e orçamentos de novas tentativas com mais profundidade.

Posso manter uma linha congolesa de longo prazo?

Não existe número de longo prazo self-service para a República do Congo. O OTP Gateway emite um número por código de verificação, e esse é o único produto oferecido para cg no momento.

Os Números Virtuais Dedicados da OTP Route 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 a sua equipe realmente precisa de uma linha congolesa persistente, escreva para [email protected]; o que pode ser combinado depende das regras locais, então trate como uma pergunta, e não como uma promessa. As vantagens e desvantagens estão resumidas em números temporários vs. dedicados.

Como é cobrada e testada com segurança uma configuração de roteamento de OTP do Congo?

A cobrança sai de uma única carteira pré-paga em USD, sem assinatura nem nível de plano. Recarregue com cartão ou com as stablecoins USDT/USDC, e cada recarga gera uma fatura em PDF por e-mail para o seu financeiro.

Antes de ligar dinheiro de verdade a um pipeline, peça ao suporte que mude uma conta de desenvolvimento para o modo sandbox. Ele devolve números e códigos simulados, e assim você exercita todo o caminho da API de verificação por SMS de ponta a ponta sem gastar nada. Use a OTP Route apenas nos seus próprios produtos e em contas que você tem direito de operar; os termos de cada serviço e a nossa Política de Uso Aceitável continuam valendo. Veja os preços para saber como cobranças e reembolsos aparecem na carteira.

Perguntas frequentes

Qual é o ID do país República do Congo na API da OTP Route?

É cg. A República Democrática do Congo é outro país, com ID próprio; confira bem qual deles a sua configuração referencia.

Posso testar o fluxo de cadastro congolês do meu app sem um chip local?

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

Devo remover o zero inicial ao salvar um número +242?

Não. Na República do Congo, o 0 pertence ao número de assinante de nove dígitos; portanto, mantenha o valor E.164 exatamente como a API o devolve.

Em que idioma estarão os SMS de verificação congoleses?

A maioria chega em francês, às vezes em inglês em apps internacionais. Extraia os dígitos com um padrão em vez de procurar palavras específicas.

Sou cobrado se o código não aparecer?

Não. Se a janela fechar sem SMS, ou se você cancelar antes, o valor integral volta automaticamente para a sua carteira.

Quanto custa receber um OTP por SMS do Congo?

A partir de $0.20 por código; o preço +242 de cada app é informado ao vivo, então consulte-o antes de pedir.

Existe um sandbox para montar a integração?

Sim, sob solicitação. O suporte pode colocar uma conta de desenvolvimento em modo sandbox, que devolve números e códigos simulados sem tocar nos fundos da carteira.

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.