Como levar códigos de verificação franceses (+33) ao seu fluxo de QA e lançamento

Vamos lançar na França no próximo trimestre. Como testar a etapa de telefone?

Um lançamento francês costuma vir com uma longa lista de localização: textos traduzidos, formatação em euros, um novo banner de consentimento e um fluxo de onboarding que agora espera um número +33. A etapa de telefone é a que tende a quebrar em silêncio. Validadores escritos para outro mercado rejeitam o 0 inicial, o modelo de SMS ainda está em inglês, ou o botão de reenvio se comporta de outro jeito quando entra uma rota de operadora francesa de verdade.

Um número de verificação da França do OTP Gateway permite que a equipe exercite essa etapa antes dos clientes. Peça uma linha +33 para o serviço em teste, rode o fluxo, leia o código e siga em frente. Funciona igualmente bem para uma equipe de growth que checa um funil de indicação e para uma agência que valida o app de um cliente antes da entrega; veja a página de agências e revendedores para esse caso de uso.

Como é, na prática, o fluxo da API de OTP da França?

Use o ID de país fr com os endpoints padrão em https://otproute.com/api/v1:

• GET /api/v1/countries e GET /api/v1/services devolvem os IDs que podem ser combinados.
• GET /api/v1/prices?country=fr&service=<id> informa o preço atual daquele par.
• POST /api/v1/activations com {"service": "<id>", "country": "fr"} reserva um número +33 e devolve um ID de ativação.
• GET /api/v1/activations/{id} informa o status e o código assim que chega; POST /api/v1/activations/{id}/cancel interrompe um pedido de que você não precisa mais.

A maioria dos pipelines de CI prefere o webhook assinado ao polling. Registre um endpoint, escute activation.sms_received, activation.expired e activation.cancelled, verifique o HMAC de X-OTPRoute-Signature com o segredo do seu endpoint e rejeite qualquer coisa com timestamp antigo. As chaves usam o prefixo or_live_, e cada conta tem até 10 delas, com um teto de 300 requisições por minuto. A página de solução de CI/CD mostra como as equipes ligam isso às execuções noturnas.

Que serviços podem entregar códigos a números franceses?

A lista ao vivo de fr inclui mais de 2.300 serviços. As equipes que localizam para a França costumam começar por WhatsApp, Google (Gmail & YouTube), Uber, Airbnb, Amazon, Instagram, Facebook, Snapchat, LinkedIn, Telegram, Microsoft & Outlook, Netflix, eBay e ChatGPT (OpenAI). Como nossas operadoras parceiras atualizam o estoque ao longo do dia, consulte a disponibilidade pela API na hora do pedido, em vez de fixar suposições no código.

Que detalhes dos números franceses atrapalham os validadores?

A França usa +33 e um prefixo de tronco 0. Um celular escrito localmente como 06 12 34 56 78 ou 07 12 34 56 78 vira +33 6 12 34 56 78 na forma internacional; portanto, o número significativo nacional tem nove dígitos depois que o zero é removido. Armazene em E.164 (+336... ou +337...), exiba agrupado em pares para usuários franceses e remova o 0 quando alguém digitar a forma doméstica depois de selecionar +33.

Departamentos ultramarinos como Guadalupe, Martinica e Reunião têm seus próprios códigos de país (+590, +596 e +262); por isso, um formulário que presume "cliente francês é igual a +33" os tratará mal. Os textos de verificação para números franceses costumam chegar em francês quando o serviço localiza pelo número ou pelo idioma da conta, o que faz dessas rotas uma boa checagem de que os seus próprios modelos de SMS e o texto dentro do app combinam.

Um colega não técnico pode fazer isso pelo navegador?

Pode. Depois de criar uma conta com um código por e-mail ou com o login do Google, abra o OTP Gateway no painel, escolha a França e o serviço, confira o preço e confirme. O número +33 aparece imediatamente, e o código surge ao lado do pedido assim que o SMS chega. Gerentes de produto que fazem uma checagem rápida de aceitação no staging raramente precisam de mais que isso.

E se o SMS nunca chegar ao número +33?

Cada ativação fica aberta por 20 minutos, e você só paga se o código realmente chegar. Quando isso não acontecer:

1. Dê à janela a chance de correr, em vez de cancelar após um minuto.
2. Confirme se o serviço aceita enviar para números virtuais; alguns os recusam por princípio.
3. Peça de novo um pouco mais tarde ou tente outra rota, por exemplo o mesmo serviço em um número da Bélgica, se o caso de teste permitir.
4. Evite repetir o pedido em um laço apertado; novas tentativas espaçadas são mais gentis com o limite de requisições e com o serviço de destino.

Ativações expiradas e canceladas são reembolsadas automaticamente na carteira.

Existe uma linha francesa de longo prazo e como funciona o pagamento?

Não existe linha francesa de longo prazo self-service. Os Números Dedicados, que você mantém enquanto são renovados e que oferecem SMS de entrada, SMS de saída e chamadas pelo navegador, existem apenas para os EUA e o Canadá, a partir de $1.95/mês. Se você precisa de uma linha +33 duradoura para operações, escreva para [email protected]; a disponibilidade depende das regras francesas e não é garantida.

Todo o gasto no OTP Gateway sai de uma carteira pré-paga em USD. Não há mensalidade nem plano, você recarrega com cartão ou USDT/USDC, e cada recarga gera uma fatura em PDF por e-mail, o que simplifica os relatórios de despesas de entidades da UE. Uma conta de desenvolvimento também pode ser passada para sandbox sob solicitação, para que a integração rode contra números simulados. Os detalhes estão na página de preços.

Perguntas frequentes

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

Sim. Peça um número +33 no OTP Gateway para o serviço que você está testando e leia o código no painel ou pela API.

Que ID de país a OTP Route usa para a França?

A França é fr em toda chamada da API, incluindo consultas de preço e requisições de ativação.

Quanto custa um número de verificação da França?

A OTP Route cobra a partir de $0.20 por código; o preço exato varia conforme o serviço e é mostrado antes de você pedir.

Os números de OTP franceses cobrem Guadalupe ou Reunião?

Não, os departamentos ultramarinos têm seus próprios códigos de país e aparecem como países separados na lista ao vivo.

Serei cobrado se o código expirar?

Não. Quando uma ativação passa da janela de 20 minutos sem SMS, ou você a cancela, o valor integral volta para a sua carteira.

Há regras sobre como posso usar esses números?

Use-os apenas para as suas próprias contas e produtos legítimos, siga os termos de cada serviço e respeite a Política de Uso Aceitável da OTP Route.

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.