Verificação por SMS na Tunísia (+216): um checklist para desenvolvedores

O que entra no checklist prévio antes de pedir um número +216?

Percorra esta lista uma vez e a maioria das execuções de teste na Tunísia correrá bem:

• Chave de API pronta. Crie uma chave Bearer no Developer console; as chaves live começam com or_live_.
• Carteira com saldo. O OTP Gateway desconta do seu saldo pré-pago em USD; GET /api/v1/balance o confirma a partir de um script.
• Webhook acessível. Registre um endpoint HTTPS, guarde o segredo dele e confirme que o relógio do seu servidor está correto para que as verificações de timestamp passem.
• Preço conferido. Chame GET /api/v1/prices?country=tn&service=<id> para o serviço exato que você pretende testar.
• Campo de telefone testado. Garanta que o seu formulário aceite um número nacional tunisiano de oito dígitos e um internacional +216 colado.
• Parser tolerante. Confirme que a extração do código funciona para mensagens em árabe, francês e inglês (veja abaixo).
• Termos revisados. Você está testando o seu próprio produto ou operando a sua própria conta legítima, de acordo com as regras do serviço e com a Política de Uso Aceitável da OTP Route.

Como os números tunisianos são formatados em E.164?

A Tunísia usa um plano de numeração fechado: todo número de assinante tem oito dígitos e não há prefixo de tronco, então nada precisa ser removido antes de acrescentar o código de país. A forma E.164 é simplesmente +216 seguido desses oito dígitos. Os locais costumam escrever os números em grupos como xx xxx xxx, então remova espaços, pontos e hifens ao normalizar. Evite validar contra uma lista fixa de dígitos iniciais; a verificação de comprimento mais uma biblioteca de telefones confiável é mais segura do que uma tabela de faixas escrita à mão.

Em que idiomas chegam os textos de verificação tunisianos?

O árabe é o idioma oficial, o árabe tunisiano é o que as pessoas falam no dia a dia, e o francês é comum nos negócios, na administração e em muitos apps. Por isso, uma única execução de teste pode receber códigos em francês, inglês ou árabe, conforme o remetente e a configuração regional do dispositivo.

As mensagens em árabe viajam como SMS Unicode e podem conter marcas de direção da direita para a esquerda em volta dos dígitos. Uma regex que captura a primeira sequência de quatro a oito dígitos ASCII, depois de remover as marcas invisíveis, sobrevive aos três idiomas. As equipes costumam incluir a Tunísia na matriz para lançamentos no norte da África francófono, ao lado do Marrocos e da Argélia, para o QA de localização de layouts da direita para a esquerda ou porque atendem clientes tunisianos que vivem na Europa; um número +216 para testes cobre cada um desses casos.

Passo a passo: recebendo um OTP da Tunísia pela API

O levantamento atual lista mais de 1.700 serviços para a Tunísia, incluindo Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail e YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft e Outlook, Amazon e Uber. A disponibilidade muda ao longo do dia, então deixe que a sua lógica de roteamento de OTP a leia de GET /api/v1/services e GET /api/v1/countries quando uma execução começar.

1. Envie POST /api/v1/activations com {"service": "facebook", "country": "tn"} e salve o id da ativação.
2. Digite o número retornado no app que você está testando e dispare o código.
3. Trate activation.sms_received no seu webhook: verifique o X-OTPRoute-Signature (HMAC-SHA256 do timestamp, um ponto e o corpo bruto), rejeite timestamps antigos e ignore duplicatas de um id de ativação que você já processou.
4. Sem webhook, faça polling em GET /api/v1/activations/{id}, ficando bem abaixo do limite de 300 requisições por minuto.
5. Chame POST /api/v1/activations/{id}/cancel se o teste for abortado.

A documentação da API lista todos os campos, e o guia de testes em CI mostra como encaixar isso em um pipeline.

Passo a passo pelo painel

1. Crie uma conta com seu e-mail e um código de seis dígitos, ou com o login do Google, e ative o TOTP de dois fatores.
2. Adicione fundos por cartão ou USDT/USDC.
3. Escolha a Tunísia, depois o serviço, e confira o preço exibido.
4. Faça o pedido, copie o número +216 e solicite o código no app de destino.
5. Copie o código tunisiano do painel assim que ele aparecer e conclua o cadastro que você está testando.

Solução de problemas: e se o código +216 nunca aparecer?

Cada ativação dura 20 minutos, e você só paga quando um código chega. Se a janela expirar ou você cancelar, o valor integral volta para a carteira.

• Nada chegou: deixe a janela se esgotar e depois tente de novo mais tarde ou com a rota de outro serviço, se o teste permitir.
• O serviço recusou o número: alguns serviços rejeitam números virtuais; o reembolso cobre esse caso.
• O webhook está mudo, mas o painel mostra o código: provavelmente a sua verificação de assinatura está falhando; compare com o corpo bruto, e não com um JSON reserializado, e verifique o desvio do relógio.
• Várias falhas seguidas: adicione um back-off; refazer o pedido em um laço apertado raramente ajuda.

Linhas de longo prazo, cobrança e sandbox para a Tunísia

Não existe número tunisiano de longo prazo em autoatendimento. Os Números Dedicados são um produto de EUA e Canadá, a partir de $1.95/mês; se você precisa de uma linha +216 duradoura, escreva para [email protected], tendo em mente que a disponibilidade depende das regras locais.

A carteira funciona conforme o uso, sem mensalidade, e cada recarga recebe uma fatura em PDF por e-mail. Contas de desenvolvimento podem pedir o modo sandbox, em que números e códigos simulados permitem comprovar a integração sem gastar saldo.

Perguntas frequentes

Posso testar um fluxo de cadastro da Tunísia sem um chip tunisiano?

Sim. Use um número +216 do OTP Gateway e colete o código no painel ou pela API de verificação por SMS e pelos webhooks.

Os números tunisianos têm um prefixo de tronco a remover?

Não. Os números tunisianos têm oito dígitos e nenhum prefixo de tronco, então a forma E.164 é apenas +216 mais esses dígitos.

Qual é o id de país da Tunísia na API de OTP?

Use tn na consulta de preços e no corpo da requisição de POST /api/v1/activations.

Quanto custa um número de verificação da Tunísia?

A partir de $0.20 por código; o valor exato depende do serviço e aparece no painel e no endpoint de preços antes de você pedir. Veja preços.

O meu parser falha em mensagens de OTP em árabe. O que devo mudar?

Remova as marcas de direção Unicode e busque a sequência de dígitos em vez das palavras ao redor, para que a mesma regra funcione com mensagens em árabe, francês e inglês.

Posso manter um número +216 para logins futuros?

Não por autoatendimento. Um número do Gateway cobre um único código, e as linhas de longo prazo disponíveis na hora existem apenas nos EUA e no Canadá.

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.