OTPs do Senegal (+221): escolha primeiro o produto certo da OTP Route

OTP Gateway ou Número Dedicado: qual serve para o Senegal?

Antes de escrever qualquer código, defina o que você realmente precisa, porque os dois produtos resolvem problemas diferentes.

• Um código e pronto. Um teste de cadastro, uma checagem de QA de uma tela de login ou a verificação única de um perfil empresarial: isso é o OTP Gateway. Você recebe um número +221 para uma única verificação, e ele expira após a ativação.
• Um número que continua funcionando. Uma conta de staging que precisa entrar de novo no mês seguinte ou um login de equipe compartilhado que precisa de recuperação: isso pede um Número Dedicado. Eles são vendidos de forma instantânea apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês.

Para o Senegal não há número de longo prazo em autoatendimento. Se uma linha +221 duradoura é importante para você, escreva para [email protected]; o que é possível depende das regras locais. O guia sobre números temporários vs dedicados aprofunda essa troca.

O que o OTP Gateway cobre para +221?

O Senegal lista atualmente mais de 1.600 serviços. Entre os populares estão WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Netflix, Snapchat, Viber e imo.

Isso é um retrato do catálogo ativo. Quais combinações podem ser pedidas muda ao longo do dia, então verifique a disponibilidade no painel ou pela API antes de cada execução.

Como funciona o fluxo da API de OTP do Senegal com o país `sn`?

Autentique-se em https://otproute.com/api/v1 com uma chave Bearer que começa com or_live_ (até 10 chaves por conta, 300 requisições por minuto). Depois:

1. Confirme os identificadores em GET /api/v1/countries e GET /api/v1/services; o Senegal é sn.
2. Leia o preço atual com GET /api/v1/prices?country=sn&service=facebook.
3. Faça o pedido em POST /api/v1/activations com {"service": "facebook", "country": "sn"} e guarde o id da ativação.
4. Receba o código por polling em GET /api/v1/activations/{id} ou pelo evento de webhook activation.sms_received.
5. Se um teste no Senegal for abandonado no meio, libere o número com POST /api/v1/activations/{id}/cancel.

Nos webhooks, verifique o cabeçalho X-OTPRoute-Signature: calcule o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, compare com v1 e recuse timestamps antigos. Trate também activation.expired e activation.cancelled e processe cada id de ativação uma única vez. Rodar isso dentro de um pipeline é tema de testes de SMS OTP em pipelines de CI.

O que há de particular nos números e SMS senegaleses?

O código do país do Senegal é +221 e o plano de numeração não tem prefixo de tronco: um número nacional de nove dígitos é discado por inteiro, e os celulares começam com 7. A forma E.164 é simplesmente +221 mais esses nove dígitos, então a normalização consiste sobretudo em remover espaços, pontos e um prefixo internacional 00.

O francês é o idioma oficial e o wolof é falado de forma muito ampla. A maioria dos apps internacionais envia seus códigos em francês ou inglês, conforme o idioma da conta, então teste o seu parsing com texto de mensagem em francês, incluindo caracteres acentuados ao redor dos dígitos.

As empresas testam no Senegal quando abrem operação na África Ocidental francófona, localizam fluxos para usuários que falam francês ou atendem clientes que dividem a vida entre Dacar e a Europa. Equipes que cobrem a região costumam rodar as mesmas verificações também para a Costa do Marfim.

Posso receber um SMS OTP do Senegal sem usar a API?

Sim. Cadastre-se com um endereço de e-mail e um código de seis dígitos, ou com o Google, e ative a autenticação em dois fatores TOTP se quiser. Adicione saldo, abra o OTP Gateway, escolha o Senegal e o serviço, confira o preço e faça o pedido. Copie o número +221 para o app; o código aparece no seu painel quando o SMS chegar.

A ativação fica ativa por 20 minutos. Você só paga quando um código é entregue; se a janela fechar sem nada, ou se você cancelar, o valor integral volta para a carteira.

Quando um código +221 atrasa ou não chega

O tempo varia conforme o serviço e a rota, então a paciência vem primeiro. Se a ativação expirar sem mensagem:

• Espere um pouco e peça de novo, ou troque para outra rota de serviço no mesmo fluxo, se o seu produto oferecer uma.
• Verifique se o serviço aceita números virtuais; alguns os recusam, e o reembolso cobre esse resultado.
• Deixe cada janela correr até o fim em vez de cancelar e refazer o pedido em sequência rápida.
• Em suítes automatizadas, espere entre as tentativas em vez de bombardear o endpoint.

Use os números apenas em produtos e contas que você opera legitimamente, respeite os termos de cada serviço e mantenha-se dentro da Política de Uso Aceitável da OTP Route.

Carteira, faturas e um sandbox para testes de integração

A cobrança funciona a partir de uma única carteira pré-paga em USD: pague conforme o uso, sem mensalidade e sem plano. A recarga é feita por cartão ou com as stablecoins USDT/USDC, e cada recarga gera uma fatura em PDF enviada por e-mail para o seu time de contabilidade. Enquanto ainda está montando a integração, peça o modo sandbox para uma conta de desenvolvimento; ele retorna números e códigos simulados para você testar o caminho completo sem mexer no seu saldo. Os valores estão listados na página de preços.

Perguntas frequentes

Qual id de país devo enviar para o Senegal?

Envie sn, por exemplo em POST /api/v1/activations com {"service": "whatsapp", "country": "sn"}.

Há um prefixo de tronco a remover dos números do Senegal?

Não. O Senegal não tem prefixo de tronco, então o formato E.164 é +221 seguido do número nacional de nove dígitos.

Posso verificar as mensagens OTP em francês do meu app para o Senegal?

Sim. Configure a conta de teste em francês, peça um número +221 para o seu serviço e confirme que o seu parser lê o código na mensagem em francês.

Posso ter um número +221 para testes que continue sendo meu?

Não como produto de autoatendimento. Os Números Dedicados de longo prazo existem apenas para os EUA e o Canadá; escreva para [email protected] para perguntar sobre o Senegal.

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

Ele volta para a sua carteira automaticamente quando a janela de 20 minutos fecha sem SMS, ou na hora, se você cancelar.

A OTP Route cobra assinatura pelo acesso ao Senegal?

Não. Não há mensalidade nem plano; você paga por código entregue, a partir de uma carteira pré-paga.

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.