Números de verificação italianos (+39) para desenvolvedores e equipes de QA

O que torna os números de telefone italianos complicados para validadores?

A Itália quebra uma regra que muitos normalizadores assumem em silêncio. No resto da Europa você descarta o zero doméstico ao adicionar o código do país, mas os telefones fixos italianos o mantêm: um número de Roma se escreve +39 06 … e um de Milão, +39 02 …. Os celulares começam com 3 e costumam ter dez dígitos depois do +39, sem zero na frente.

Assim, uma biblioteca que remove o 0 inicial depois do código do país vai corromper os fixos italianos, e um validador que exige tamanho fixo pode rejeitar números válidos. Armazene a string E.164 completa exatamente como +39 mais o número nacional e inclua casos italianos nos seus testes de parsing de telefone.

Um conjunto prático de fixtures para o QA italiano deve ter pelo menos um celular, um fixo de Roma e um fixo de Milão. Passe os três pelo seu parser, pelo ciclo de ida e volta no banco de dados e por qualquer formatador de exibição, e confirme que o valor armazenado é idêntico ao que entrou.

Por que as equipes rodam testes de verificação em rotas +39?

A Itália é um dos maiores mercados da UE, então é uma parada comum quando um produto se expande de um país europeu para o seguinte. O QA de localização também importa: as mensagens de verificação aqui costumam chegar em italiano, e seus próprios modelos devem ser conferidos quanto a letras acentuadas, formatos de data e tamanho do texto. Apps de marketplace, fintech e entrega também testam o onboarding italiano antes de ativar parceiros locais de pagamento ou de entregas. As notas sobre onboarding fintech tratam desse padrão.

As equipes de operações têm motivos próprios. Agências que gerenciam perfis sociais ou de marketplace de clientes italianos preferem confirmar essas contas empresariais em um número que não seja o celular pessoal de um funcionário, e a página de equipes de operações descreve como isso se encaixa em um login compartilhado.

Quais serviços estão na lista da Itália?

Mais de 2.100 serviços podem enviar códigos para números da rota italiana neste momento. Entre os mais populares estão WhatsApp, Instagram, Facebook, Google (Gmail & YouTube), Amazon, eBay, Airbnb, Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Discord e ChatGPT (OpenAI). A lista é dinâmica, então consulte-a em vez de guardá-la em cache por muito tempo.

Como funciona o fluxo `it` pela API?

Envie as requisições para https://otproute.com/api/v1 com uma chave Bearer que comece com or_live_. Confira o custo com GET /api/v1/prices?country=it&service=<id> e depois crie o pedido com POST /api/v1/activations e {"service": "<id>", "country": "it"}. A resposta traz um id de ativação; faça polling em GET /api/v1/activations/{id} ou espere o webhook activation.sms_received, e trate activation.expired ou activation.cancelled como os outros dois desfechos.

Verifique sempre X-OTPRoute-Signature (HMAC-SHA256 de "<t>.<raw body>") e rejeite timestamps antigos; o guia de HMAC traz os detalhes. As contas permitem 10 chaves, 5 endpoints de webhook e 300 requisições por minuto.

Em um pipeline de CI é comum pedir o número em uma etapa de setup, rodar o teste de navegador que dispara o SMS e então bloquear em um listener de curta duração até o webhook chegar ou a janela fechar. Cancele na etapa de teardown para que uma execução abortada nunca deixe um número aberto.

Pedir pelo painel, em vez disso

Quem não é desenvolvedor pode fazer o mesmo pelo app web: abra o OTP Gateway, escolha o serviço, escolha a Itália, confirme o preço e copie o número +39 para o app que você está testando. O código aparece na tela assim que chega. Se não chegar, espere a janela terminar, confirme que o serviço aceita números virtuais e tente de novo mais tarde ou em outra rota, em vez de pedir repetidamente.

Anote qual serviço e qual rota você usou em cada tentativa; isso facilita bastante ver se uma falha é específica de um app ou afeta toda a rota italiana naquele horário.

Existe uma linha italiana permanente e como é a cobrança?

Não há número de longo prazo em autoatendimento para a Itália. Os Números Dedicados, a partir de $1.95/mês, existem apenas nos Estados Unidos e no Canadá; para perguntar sobre uma linha italiana, escreva para [email protected], sabendo que a disponibilidade depende das regras locais. A cobrança é uma carteira pré-paga em USD recarregada por cartão ou USDT/USDC, com faturas em PDF e sem mensalidade. Veja os preços ou cadastre-se para começar e peça o modo sandbox enquanto desenvolve.

Perguntas frequentes

Devo remover o 0 dos números italianos ao adicionar +39?

Não nos fixos: os telefones fixos italianos mantêm o 0 inicial depois do +39. Os celulares começam com 3 e não têm zero para começar.

Qual é o id da Itália na API da OTP Route?

É it, usado tanto na consulta de preços quanto no corpo da ativação.

Posso testar um cadastro italiano de fora da Itália?

Sim. Um número +39 do OTP Gateway recebe o código de onde sua equipe estiver, e você o lê no painel ou pela API.

Quanto custa um SMS OTP da Itália?

Os códigos italianos começam em $0.20 por código; a API informa a tarifa atual de cada serviço e o painel a exibe antes de você confirmar.

O que acontece se nenhum código italiano chegar?

Após 20 minutos a ativação expira e o valor é reembolsado automaticamente na sua carteira, sem precisar abrir chamado.

Posso reutilizar o mesmo número +39 no mês que vem?

Não, os números do gateway servem para uma única verificação. As linhas de longo prazo só existem nos EUA e no Canadá.

As mensagens de verificação chegam em italiano?

Muitas vezes, já que vários remetentes localizam por país, mas alguns usam o idioma configurado na conta. Construa seu parser em torno dos dígitos, e não do texto.

Há limites de uso que eu deva conhecer?

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 legítimos, não para criação em massa de contas.

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.