Como levar códigos de verificação guineenses (+224) para seus testes e ferramentas

Por que uma equipe precisaria de um número +224 para testes?

A Guiné fica na parte francófona da África Ocidental, e produtos que se expandem pela região costumam precisar provar que o cadastro funciona para assinantes guineenses antes de investir em marketing. Outros motivos comuns: um app voltado à diáspora guineense na França e em outros países, um fluxo de onboarding de fintech sendo validado para mercados francófonos, ou equipes de campo e de operações em Conacri que gerenciam contas comerciais compartilhadas. Em todos os casos, é preciso um número +224 para testes que ninguém da equipe precise carregar num celular.

A OTP Route atende a essa necessidade sem a logística de chips locais. A página de testes de QA mostra como as equipes incorporam isso aos checklists de release.

Quais serviços conseguem enviar código para um número de verificação da Guiné?

Entre os serviços populares no panorama atual da Guiné estão WhatsApp, imo, Telegram, Viber, Facebook, Instagram, TikTok, Snapchat, Signal, Google (Gmail & YouTube), Microsoft & Outlook e ChatGPT (OpenAI). Somando todas as categorias, a rota alcança mais de 1.700 serviços.

A disponibilidade nesta rota muda ao longo do dia, então consulte-a ao vivo pela API em vez de guardar uma lista em cache por semanas. Escolha o serviço de que o seu caso de teste realmente depende: se o seu onboarding envia códigos por um app de mensagens popular entre os guineenses, é esse que vale verificar, e não o primeiro que aparecer na lista.

Como funciona a sequência da API OTP para a Guiné?

Autentique-se com uma chave Bearer (prefixo or_live_) em https://otproute.com/api/v1. Primeiro consulte GET /api/v1/prices?country=gn&service=<id> para saber se o serviço está ativo para a Guiné. Depois envie POST /api/v1/activations com {"service": "<id>", "country": "gn"}, guarde o id da ativação e informe o número no app que você está testando.

A entrega chega como activation.sms_received em um webhook registrado, ou você pode consultar GET /api/v1/activations/{id} por polling. Verifique o cabeçalho X-OTPRoute-Signature (HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint), recuse timestamps antigos e ignore eventos duplicados de uma ativação que você já processou. Para abandonar uma execução, use POST /api/v1/activations/{id}/cancel. O guia de integração e a documentação aprofundam o assunto.

Qual é o caminho pelo navegador para quem não é da área técnica?

Abra o OTP Gateway, escolha Guiné, procure o serviço, confira o preço e faça o pedido. Cole o número na tela de verificação; o SMS recebido aparece no cartão da ativação no painel. Agências que cuidam de contas de clientes na Guiné costumam preferir esse caminho, porque uma única carteira compartilhada atende todos e nenhuma chave de API precisa sair da equipe de engenharia. O cadastro pede um e-mail e um código de 6 dígitos enviado por e-mail, e o login em dois fatores com aplicativo autenticador está disponível para a própria conta.

Como armazenar números +224 e em que idioma chegam os códigos?

A Guiné não tem prefixo de tronco, e os números nacionais têm nove dígitos, com os celulares geralmente começando por 6. Normalize a entrada para +224 seguido desses nove dígitos e mantenha essa única forma E.164 no banco de dados; registros antigos gravados com oito dígitos merecem ser sinalizados na limpeza de dados.

O francês é o idioma oficial, enquanto fula (pular), maninka e susu são amplamente falados. Serviços globais costumam redigir os textos de verificação em francês ou inglês, conforme a configuração de idioma da conta, então a extração do código deve se basear nos dígitos, e não nas palavras.

O que verificar quando um código da Guiné não chega?

• Deixe a janela de 20 minutos correr até o fim; você só paga se o código chegar.
• Confira se o serviço aceita números virtuais. Alguns os recusam, e o reembolso automático existe exatamente para esse caso.
• Tente de novo mais tarde ou por outra rota de serviço, já que as condições de roteamento OTP de qualquer país mudam ao longo do dia.
• Evite disparar pedidos repetidos em um laço apertado; um pequeno backoff preserva o seu limite de requisições.

Para uma comparação regional, a rota do Senegal é uma opção francófona vizinha para rodar o mesmo caso de teste.

Podemos manter um número da Guiné por tempo prolongado?

Não pelo painel. A Guiné não tem número de longo prazo de autoatendimento, e os números de ativação servem para um único código. Os Números Virtuais Dedicados são vendidos apenas para os Estados Unidos e o Canadá, a partir de $1.95/month, e incluem SMS recebidos encaminhados ao seu webhook, envio de SMS e chamadas pelo navegador. Para uma linha guineense duradoura, escreva para [email protected]; a disponibilidade depende das regras locais, e a equipe dirá com franqueza se não for possível.

Perguntas frequentes

Posso testar o cadastro do meu app na Guiné sem um chip local?

Sim. Peça um número +224 no OTP Gateway, use-o no seu formulário de cadastro e leia o código no painel ou pelo seu webhook.

Que id de país a OTP Route usa para a Guiné?

O id é gn. Coloque-o no corpo da ativação e na consulta de preços.

Quanto custa receber um SMS OTP da Guiné?

A partir de $0.20 por código; o valor exato depende do serviço e aparece antes de você fazer o pedido.

Pago por uma ativação que nunca recebe código?

Não. Se a janela de 20 minutos terminar sem SMS, ou se você cancelar, o valor integral volta automaticamente para a carteira.

O webhook é obrigatório ou posso usar polling para os códigos da Guiné?

Os dois funcionam. Webhooks combinam com suítes de teste em paralelo, enquanto o polling de GET /api/v1/activations/{id} basta para um script simples, dentro do limite de 300 requisições por minuto.

Todo serviço vai aceitar um número +224 da OTP Route?

Não. Alguns serviços recusam números virtuais, e por isso as ativações não utilizadas são reembolsadas. Siga sempre os termos do serviço e a nossa Política de Uso Aceitável.

Como pagamos e recebemos faturas?

Recarregue uma única carteira pré-paga em USD por cartão ou com USDT/USDC, sem plano nem mensalidade. Cada recarga gera uma fatura em PDF por e-mail; veja os preços.

Existe sandbox para construir a integração com a Guiné?

Sim, sob solicitação. Uma conta de desenvolvimento pode ser colocada em sandbox, que devolve números e códigos simulados para você rodar todo o fluxo da API de verificação por SMS sem gastar 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.