O código de verificação por SMS não chegou: o que conferir, do seu lado e do lado do cliente

WhatsApp e APIs·· 16 visualizações· 3 min de leitura

A resposta curta: quando um cliente diz que o código não chegou, confira primeiro o seu lado: a chave (uma chave Sandbox não envia nada), a resposta do pedido, o número e o saldo de SMS. Depois veja o estado do código com GET /v1/sms/otp/{id}. Só então passe ao celular do cliente: rede, SIM, mensagens bloqueadas. E não deixe reenviar sem parar: cada código novo anula o anterior.

Do seu lado

Conferir Como Se for isto
A chave é de Sandbox? A resposta traz "mode": "sandbox" e "simulated": true Nenhum SMS sai na Sandbox. Use uma chave prod_
O pedido foi aceite? O código HTTP: 201 é aceite Um 403 ou 422 não enviou nada; leia error.code e details
O número está certo? O campo to mostra o número tapado Um algarismo trocado vai para outra pessoa. Só há envios para Moçambique e Angola
Há créditos? GET /v1/sms/balance Compre créditos na página SMS do My MozOut
O remetente está aprovado? GET /v1/sms/senders O sender tem que estar aprovado para o país do número; sem ele sai o NETMSG
Saiu outro código depois? GET /v1/sms/otp/{id}: estado cancelled O cliente está olhando para um SMS antigo; só o mais recente vale

Os códigos de verificação não aparecem na lista de mensagens da API (GET /v1/sms/messages). Para saber de um código, use sempre GET /v1/sms/otp/{id} com o id que guardou.

Do lado do cliente

1 Rede. Sem rede móvel o SMS espera. Não precisa de internet nem de aplicações, mas precisa de rede.
2 O SIM certo. Num celular com dois cartões, o código vai para o número que escreveu, que pode não ser o do cartão principal.
3 Mensagens bloqueadas ou filtradas. Algumas aplicações de SMS escondem mensagens de remetentes desconhecidos numa pasta à parte.
4 Memória cheia ou caixa de mensagens no limite, em celulares mais antigos.
5 Esperar um pouco antes de pedir outro. Clicar em «Reenviar» várias vezes faz chegar vários SMS, e só o último funciona.
O reenvio também tem regras. /resend só funciona com códigos pending ou expired, e as tentativas já gastas não voltam. Se o código falhou ou foi cancelado, peça um novo com POST /v1/sms/otp. Veja reenviar, cancelar e substituir um código.
Se nada disto explicar, abra um pedido de suporte com o id do código (otp_...), a hora do envio e o X-Correlation-ID da resposta. Nunca envie a chave da API: o suporte não precisa dela.

Um código continua sem chegar depois de conferir tudo? Abra um pedido de suporte com o id do código.

Abrir pedido de suporte

VEJA TAMBÉM

Reenviar, cancelar e substituir um código de verificação: o que acontece ao anterior

Estados de um código de verificação: pending, verified, expired, failed e cancelled

Ler as respostas da API de verificação: valid false, 409, 422 e 429

A tela do código: o campo, a contagem decrescente, as tentativas que restam e mensagens claras

Testar a verificação por SMS na Sandbox: o código vem na resposta

Erros e estados das mensagens na API de SMS: o que significa cada um e o que fazer

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde $6.60/mês (plano de 3 anos, com cupom)

Ver planos
Esta resposta foi útil? Sua resposta nos ajuda a melhorar este artigo.

Artigos Relacionados

WhatsApp e APIs 1.275 Pôr o WhatsApp no seu site: o link, o botão e a mensagem já escrita Em Moçambique, o WhatsApp é onde as conversas de negócio acontecem. Um formulário de contato dá uma mensagem que alguém...
WhatsApp e APIs 1.153 WhatsApp normal, Business ou a API: qual serve o seu negócio Chamamos «WhatsApp» a quatro coisas diferentes, e escolher a errada custa dinheiro ou custa o número. Uma é gratuita e c...
WhatsApp e APIs 1.302 WhatsApp no negócio: os riscos, e as práticas que os evitam O WhatsApp tornou-se o canal de venda de muita empresa em Moçambique, e isso trouxe um risco que poucos ponderam: o núme...
WhatsApp e APIs 1.237 WhatsApp, e-mail ou SMS: vantagens, desvantagens, riscos e para quem serve cada um WhatsApp, e-mail e SMS servem para falar com clientes, e a pergunta «qual é melhor» não tem resposta - porque servem par...
WhatsApp e APIs 1.053 WhatsApp normal no negócio: vantagens, desvantagens, riscos e para quem é A aplicação com que quase todo mundo começa - a mesma do uso pessoal - usada para o negócio. É a opção mais comum e a me...
WhatsApp e APIs 37 Pôr a verificação por SMS no seu site: exemplos em PHP, Node.js e Python A resposta curta: são dois pedidos POST com JSON e a chave no cabeçalho Authorization: Bearer: um para /v1/sms/otp com o...