Como capturar códigos de verificação por telefone do Yahoo via API

Onde o Yahoo pede um número de telefone?

As contas Yahoo reúnem Mail, notícias, finanças e fantasy sports sob um único login, e o número de telefone fica no centro dessa identidade. Em fluxos conhecidos, ele aparece em vários pontos:

• Criação da conta, em que um número de celular é solicitado e confirmado com um código por SMS.
• Login, incluindo opções sem senha que enviam um código ou um aviso em vez de pedir a senha.
• Recuperação, quando alguém esqueceu a senha e a conta recorre ao telefone cadastrado.
• Verificação em duas etapas, que adiciona um código como segundo fator após a senha.

Para uma equipe de QA, cada um desses momentos é um caso de teste separado. Um teste de cadastro precisa de um número novo uma vez; um teste de recuperação ou de duas etapas precisa que o mesmo número possa ser alcançado de novo mais tarde, o que influencia qual produto da OTP Route você escolhe.

O país do número importa para o Yahoo?

Importa. O Yahoo é usado no mundo todo, e um número do mercado ao qual a conta pertence dá o teste mais fiel de textos localizados, telas de cadastro regionais e formatação de números. Os códigos do Yahoo podem ser recebidos hoje em 198 países, entre eles Estados Unidos, Reino Unido, Canadá, Índia, Filipinas, México, Brasil, Alemanha, França, Indonésia, Nigéria, África do Sul, Austrália, Espanha e Taiwan.

Combine o país do número com o caso de teste: uma agência que administra a caixa de entrada Yahoo de um cliente em Manila deve verificar por uma rota das Filipinas, enquanto uma equipe que testa o onboarding em espanhol aprende mais com um número mexicano ou espanhol do que com um dos EUA.

Como é o fluxo da API para o id de serviço yahoo?

As requisições vão para https://otproute.com/api/v1 e se autenticam com uma chave Bearer or_live_ do Developer console. As contas podem ter 10 chaves e 5 endpoints de webhook, com limite de 300 requisições por minuto.

1. Confirme quanto vai pagar: GET /api/v1/prices?country=gb&service=yahoo (troque gb por qualquer id api_country).
2. Abra a ativação com POST /api/v1/activations e o corpo {"service": "yahoo", "country": "gb"}.
3. Digite o número retornado na etapa de telefone do Yahoo.
4. Colete o código em activation.sms_received ou faça polling em GET /api/v1/activations/{id} se os webhooks ainda não estiverem configurados.
5. Cancele com POST /api/v1/activations/{id}/cancel quando o teste for abandonado.

Trate o webhook com cuidado. Recalcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare com o v1 de X-OTPRoute-Signature: t=<unix>,v1=<hex> e recuse timestamps antigos. Depois, torne o handler idempotente usando o id de ativação como chave, para que um evento reenviado não preencha o mesmo formulário do Yahoo duas vezes. Como proteger webhooks de OTP com HMAC cobre os casos limite.

Como recebo um OTP do Yahoo pelo painel?

1. Entre na conta e abra o OTP Gateway.
2. Selecione Yahoo e, em seguida, o país adequado ao seu teste.
3. Confira o preço na tela e confirme.
4. Digite o número no Yahoo e solicite o código.
5. Leia a mensagem no cartão da ativação quando ela chegar.

As regras são exatamente as mesmas da API: um código por ativação, 20 minutos de escuta e nenhuma cobrança se nada chegar ou se você cancelar.

Por que um código do Yahoo pode não chegar?

O Yahoo decide do lado dele se envia uma mensagem e para quais números. Ele pode recusar números virtuais em algumas regiões ou para certos tipos de conta, e pode limitar pedidos repetidos da mesma sessão. Quando um código não chega:

• Deixe a ativação aberta durante toda a janela; um envio atrasado ainda pode chegar.
• Tente o mesmo fluxo em outra rota de país.
• Espere um pouco antes de tentar de novo, em vez de refazer o pedido em um laço apertado.
• Trate a recusa como uma característica do serviço, não como um bug do seu código.

O reembolso automático faz com que uma tentativa fracassada não custe nada, o que mantém barato o teste exploratório.

Quando um Dedicated Number é mais adequado para o Yahoo?

Uma ativação temporária termina depois de um código. Isso serve para testes de cadastro, mas não para um telefone do Yahoo que ainda precisa receber mensagens no próximo trimestre, como a linha de recuperação de uma caixa de operações compartilhada ou uma conta de staging que faz login com códigos toda semana.

Para esses casos, um Dedicated Number mantém a mesma linha enquanto ela é renovada pela carteira, recebe SMS no painel e no seu webhook como number.sms_received e custa a partir de $1.95/month. Eles são vendidos de forma instantânea apenas nos Estados Unidos e no Canadá; a página de números virtuais compara os dois produtos.

Quais são as regras básicas para testar o Yahoo?

Use a OTP Route para testar o seu próprio produto ou para operar contas legítimas que pertencem a uma pessoa real ou a uma empresa, uma conta para cada. Siga os termos do Yahoo e lembre que a Política de Uso Aceitável da OTP Route vale para cada ativação. Yahoo é marca registrada de seu titular, e a OTP Route não tem afiliação com ele.

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. Contas de desenvolvimento podem pedir o modo sandbox, que devolve números e códigos simulados para testes de integração de ponta a ponta; o hub para desenvolvedores traz as notas de configuração.

Perguntas frequentes

Posso testar um fluxo de cadastro do Yahoo sem um chip físico?

Sim. Peça um número para o serviço yahoo na OTP Route e o código aparece no painel ou no seu webhook. Se o Yahoo não enviar nada em 20 minutos, o valor integral volta para a sua carteira.

Quanto custa um número virtual para o Yahoo?

As ativações começam em $0.20 por código, e o valor exato varia conforme o país. Chame GET /api/v1/prices com o id do país e yahoo para ver o preço em tempo real.

Devo usar um número temporário como telefone de recuperação do Yahoo?

Não. Uma ativação termina após um código, então a recuperação falharia mais tarde. Um Dedicated Number nos EUA ou no Canadá serve para recuperação e logins repetidos.

O Yahoo aceita qualquer número de telefone?

Não necessariamente. O Yahoo pode recusar números virtuais ou limitar pedidos, e é por isso que a OTP Route reembolsa as ativações que não recebem SMS.

Como evito que eventos de webhook duplicados quebrem meu teste do Yahoo?

Guarde cada id de ativação já processado e ignore as repetições. Verifique a assinatura antes de qualquer processamento.

Quais países posso escolher para um número de telefone do Yahoo?

O Yahoo está disponível hoje em 198 rotas de país. A lista em tempo real vem de GET /api/v1/countries e do painel.

Posso automatizar a verificação por SMS do Yahoo para testes em CI?

Sim. Use a API com webhook ou polling e peça o modo sandbox em uma conta de desenvolvimento, para que as execuções do pipeline usem números e códigos simulados.

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.