Como receber códigos SMS do Zoho para testes e contas empresariais

A situação: uma tela do Zoho está pedindo um número de celular

As equipes encontram essa etapa de algumas maneiras previsíveis. Uma pessoa desenvolvedora de integrações precisa de uma conta nova do Zoho para testar uma conexão OAuth com CRM, Books ou Desk. Uma agência configura o Zoho Mail e o Zoho One para um cliente e não quer o telefone pessoal de um funcionário ligado ao login de administrador. Uma líder de QA precisa provar que o fluxo de cadastro se comporta do mesmo jeito para um usuário em Dubai e para outro em Sydney. Em todos os casos, o obstáculo é a mesma mensagem de texto, e quem precisa dela raramente tem à mão um chip do país certo.

A OTP Route transforma essa mensagem em algo que a sua ferramenta pode solicitar, aguardar e ler.

Onde o Zoho usa a verificação por telefone?

O Zoho costuma pedir um número de celular quando uma conta nova é criada e pode usar o SMS como segundo fator no login, ao lado do seu app autenticador. Um número verificado também serve para recuperar a conta quando a senha é perdida. O momento exato em que um código é solicitado depende do produto, da região da conta e das configurações de segurança escolhidas por um administrador; por isso, crie testes que tolerem o aparecimento ou não do pedido.

Como escolher o país para um número do Zoho

O serviço zoho tem rota hoje em 198 países. Combine o número com o mercado da conta que você está criando ou testando, porque o país afeta o código de discagem que o Zoho espera, o idioma da mensagem e, às vezes, em qual data center regional a conta é criada.

As rotas mais escolhidas incluem Índia, Estados Unidos, Reino Unido, Emirados Árabes Unidos, Austrália e Alemanha. Outros da lista são Canadá, Brasil, México, Singapura, Arábia Saudita, África do Sul, Países Baixos, Espanha, França, Japão, Indonésia, Malásia e Quênia. A disponibilidade muda ao longo do dia; por isso, leia-a em GET /api/v1/countries quando a execução começar.

Como integrar a API de código de verificação do Zoho aos seus testes

As chamadas vão para https://otproute.com/api/v1 com uma chave Bearer do Developer console.

1. Consulte o preço com GET /api/v1/prices?country=<id>&service=zoho.
2. Crie a ativação: POST /api/v1/activations com {"service": "zoho", "country": "<id>"}.
3. Faça sua automação de navegador digitar o número retornado no formulário do Zoho e solicitar o código.
4. Aguarde o evento activation.sms_received, identificado pelo id de ativação, no seu endpoint de webhook.

Dois hábitos deixam o handler confiável. Primeiro, confira X-OTPRoute-Signature calculando um HMAC-SHA256 sobre "<t>.<raw body>" com o segredo do endpoint e rejeite timestamps antigos. Segundo, deixe o handler idempotente: registre o id de ativação e ignore uma entrega repetida, para que o código nunca seja enviado duas vezes. Se o seu runner de testes não puder receber tráfego de entrada, faça polling em GET /api/v1/activations/{id} e fique abaixo de 300 requisições por minuto. O guia de captura por webhook mostra os dois padrões.

Fazendo manualmente no painel

Para configurações pontuais, abra o OTP Gateway, escolha Zoho, selecione o país, confira o preço exibido e confirme. Copie o número para o Zoho, clique no botão que envia o código e mantenha a ativação aberta. O código aparece na tela quando chegar. Você tem 20 minutos; se nada chegar, ou se você cancelar, o valor integral volta para a sua carteira.

Por que um OTP do Zoho pode não chegar

Um código ausente costuma ter uma causa comum:

• O Zoho pode recusar números virtuais em algumas regiões ou para certos tipos de conta. Essa é uma decisão dele e é o motivo de os reembolsos serem automáticos.
• A rota daquele país pode estar congestionada naquele momento. Tente mais tarde ou com outro país que sirva para o teste.
• Pedidos repetidos de uma mesma sessão de navegador podem sofrer limitação de taxa do próprio Zoho; por isso, espace as tentativas.
• Criar novas ativações em um laço apertado não ajuda e consome o seu orçamento de API.

Deixe a janela expirar antes de concluir que uma rota falhou.

Quando um Dedicated Number é a melhor escolha

Uma ativação de uso único é a certa para criar e testar contas. É a ferramenta errada para um login de administrador que vai pedir SMS de novo no mês que vem, porque esse número não será mais seu. Nesse caso, um Dedicated Number a partir de $1.95/month dá a você uma linha dos EUA ou do Canadá que você mantém enquanto ela for renovada, com SMS recebidos no painel e encaminhados ao seu webhook. As linhas dedicadas são oferecidas apenas nesses dois países. Saiba mais em números virtuais.

Como usar números do Zoho com responsabilidade

Siga os termos do Zoho. Crie uma conta por pessoa real ou empresa e use a OTP Route para testar e operar os seus próprios produtos e as contas legítimas de clientes, nunca para produzir cadastros em massa. A OTP Route não é afiliada ao Zoho, cujo nome é marca registrada de seu titular, e a Política de Uso Aceitável vale para cada ativação. Agências que gerenciam vários clientes podem ler a página de soluções para agências.

Perguntas frequentes

Como recebo um OTP do Zoho por uma API?

Crie uma ativação com o id de serviço zoho e o país escolhido, e depois leia o código no webhook activation.sms_received ou por polling da ativação.

Posso usar um número virtual para a verificação por SMS do Zoho em testes?

Muitas vezes sim, mas o Zoho pode recusar números virtuais em alguns casos. Se nenhum código chegar em 20 minutos, o valor é reembolsado.

Quanto custa um número de telefone do Zoho para um código?

A partir de $0.20 por código. O preço em tempo real por país é retornado pelo endpoint de preços e exibido no painel.

Qual país devo escolher para uma conta de teste do Zoho?

Escolha o país do usuário ou do mercado que você está testando, para que o código de discagem e o idioma da mensagem correspondam ao caso real.

Posso manter o mesmo número para futuros logins no Zoho?

Não com uma ativação de uso único. Um Dedicated Number dos EUA ou do Canadá é a opção para uma conta que precisa verificar de novo mais tarde.

Posso testar o fluxo sem gastar saldo da carteira?

Sim. Uma conta de desenvolvimento pode ser colocada em sandbox sob solicitação, o que devolve números e códigos simulados. Veja os detalhes na documentação.

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.