Verificação por SMS do Proton Mail: checklist e fluxo de testes

Checklist antes de pedir um código do Proton Mail

A verificação por SMS do Proton Mail para testes corre bem quando a preparação é feita antes:

• Saiba por que o Proton está pedindo. Confirme que a tela oferece o SMS como opção de verificação nesta etapa de cadastro ou recuperação.
• Escolha o país de propósito. Combine com o mercado da conta ou com o cenário do seu plano de testes.
• Confira preço e disponibilidade. Chame GET /api/v1/prices?country=<id>&service=protonmail ou olhe no painel.
• Tenha um receptor pronto. Um endpoint de webhook inscrito em activation.sms_received ou um laço de polling com intervalo sensato.
• Planeje o futuro da caixa de e-mail. Se ela precisar de recuperação ou nova verificação depois, um Dedicated Number pode ser mais adequado.
• Releia as regras. Os termos do Proton e a Política de Uso Aceitável da OTP Route valem ao mesmo tempo.

Onde o Proton Mail pede um número de telefone?

O Proton Mail é um serviço de e-mail focado em privacidade e usa o telefone o mínimo possível. O momento mais comum é a verificação humana no cadastro: quando o Proton quer mais garantia de que uma conta nova pertence a uma pessoa real, ele pode oferecer um código por SMS como uma das várias opções. Os titulares também podem adicionar um número como método de recuperação. O login em duas etapas do Proton depende de apps autenticadores ou chaves de segurança, e não de SMS; por isso, um número usado uma vez no cadastro não é necessário para logins posteriores, a menos que você também o tenha salvo como telefone de recuperação.

Passo a passo: a API de código de verificação do Proton Mail

1. Autentique-se com uma chave Bearer (prefixo or_live_) criada no Developer console.
2. Consulte o preço com GET /api/v1/prices?country=de&service=protonmail, ou com outro id de país.
3. Faça o pedido por POST /api/v1/activations com {"service": "protonmail", "country": "de"}.
4. Digite o número retornado no campo de verificação do Proton.
5. Receba o código. Seu webhook recebe activation.sms_received; verifique o cabeçalho X-OTPRoute-Signature (HMAC-SHA256 do timestamp, um ponto e o corpo bruto, com o segredo do endpoint como chave) e rejeite timestamps antigos. O polling em GET /api/v1/activations/{id} é a alternativa.
6. Registre o resultado usando o id de ativação como chave, para que um webhook reenviado seja processado apenas uma vez.

Cada conta permite 10 chaves de API, 5 endpoints de webhook e 300 requisições por minuto. Para um passo a passo mais longo, veja captura de OTP por webhook.

Passo a passo: a mesma tarefa no painel

1. Entre na conta e abra o OTP Gateway.
2. Procure por Proton Mail e escolha um país.
3. Confira o preço exibido e confirme.
4. Cole o número na tela de verificação por SMS do Proton.
5. Mantenha o pedido aberto; o código aparece ao lado do número quando a mensagem chegar.
6. Cancele se o Proton nunca enviar, ou deixe a janela de 20 minutos expirar. Em qualquer dos casos, a carteira é reembolsada.

Quais países podem hospedar um número de telefone para o Proton Mail?

A rota do Proton Mail abrange hoje 197 países. Entre os exemplos estão Suíça, Alemanha, Reino Unido, Brasil, Índia, França, Espanha, México, Indonésia, Filipinas, Nigéria, Quênia, Japão, Polônia e Estados Unidos. A escolha do país importa: um teste de um fluxo de onboarding em alemão deve usar um número alemão, e uma conta operada por uma equipe no Brasil fica mais coerente com um número brasileiro. As opções em tempo real de qualquer serviço vêm de GET /api/v1/countries junto com o endpoint de preços.

Solução de problemas: o SMS do Proton Mail não chegou

• Número virtual recusado. O Proton pode recusar números que trata como virtuais. Escolha outro método de verificação humana ou outra rota; o reembolso cobre a tentativa.
• Ainda nada. Deixe a janela de 20 minutos terminar em vez de refazer o pedido na hora; pedidos repetidos em sequência raramente ajudam.
• Rota ocupada. Tente mais tarde ou escolha outro país que ainda combine com o caso de teste.
• Webhook silencioso. Verifique o segredo do endpoint, a lógica da assinatura e o relógio do seu servidor, e depois compare com um GET /api/v1/activations/{id} direto.

Quando um Dedicated Number é a melhor escolha?

Um número de uso único é o certo para uma verificação de cadastro. É a ferramenta errada para uma caixa de e-mail que sua equipe precisará recuperar meses depois, porque esse número não estará mais acessível. Se a conta precisa de um telefone de recuperação que funcione, como uma caixa de suporte compartilhada ou uma conta de staging para testes de regressão, use um Dedicated Virtual Number nos Estados Unidos ou no Canadá, a partir de $1.95/month. Você o mantém enquanto ele for renovado, recebe SMS no painel e no seu webhook por number.sms_received e pode liberá-lo quando quiser. Números de uso único versus dedicados compara os dois em profundidade.

Uso responsável e cobrança

O Proton construiu seu produto em torno da privacidade, e isso merece respeito. Use os números da OTP Route para testar o seu próprio onboarding, abrir as contas de que sua empresa realmente precisa ou manter os números pessoais da equipe fora de logins compartilhados: uma conta por pessoa real ou empresa, seguindo os termos do Proton. A cobrança é uma carteira pré-paga em USD, sem mensalidade, abastecida por cartão ou USDT/USDC, com fatura em PDF a cada recarga, e há sandbox disponível sob solicitação para trabalho de integração. A página de cadastros com privacidade em primeiro lugar trata de fluxos relacionados.

Perguntas frequentes

Como recebo códigos OTP do Proton Mail por uma API?

Crie uma ativação com o serviço protonmail e o país escolhido, digite o número no Proton e depois pegue o código no webhook activation.sms_received ou por polling da ativação.

O Proton aceitará um número virtual no cadastro do Proton Mail?

Nem sempre. O Proton decide em quais números confia e, se nenhum código chegar em 20 minutos, você é reembolsado automaticamente.

Posso usar o mesmo número depois para recuperar a conta?

Não com um número avulso do OTP Gateway. Para um telefone de recuperação que você vai manter, use um Dedicated Number, oferecido apenas nos EUA e no Canadá.

O Proton usa SMS no login com dois fatores?

Não. O login em duas etapas do Proton usa apps autenticadores ou chaves de segurança. O SMS aparece principalmente na verificação humana e como opção de recuperação.

Posso ensaiar a verificação do Proton Mail sem gastar saldo?

Sim, para trabalho de integração: peça ao suporte para colocar uma conta de desenvolvimento em sandbox, que devolve números e códigos simulados. Códigos reais do Proton ainda exigem um pedido em produção.

É permitido abrir várias contas do Proton assim?

Não. Mantenha uma conta por pessoa real ou empresa e siga os termos do Proton; a OTP Route existe para testar e operar suas próprias contas e produtos legítimos.

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.