Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
A resposta curta: no registo, peça o número, envie um código com POST /v1/sms/otp e só marque o número como confirmado quando POST /v1/sms/otp/{id}/verify responder valid: true. Assim sabe que o telemóvel é mesmo de quem se está a registar, e não de um vizinho, de um concorrente ou de um robô. O número pode vir com ou sem o indicativo, porque o sistema reconhece o país pelo primeiro algarismo: 841234567 vai para Moçambique e 923456789 para Angola. Assim, +258 84 123 4567 e 258841234567 são o mesmo número que 841234567.
O fluxo, passo a passo
|
|
|
|
|
|
Os campos que interessam no registo
| Campo | Sugestão para o registo | Limites |
| number | O número que o cliente escreveu, tal como está | Telemóveis de Moçambique e Angola |
| length | 6, a omissão: fácil de escrever, difícil de adivinhar | 4 a 8 algarismos |
| expires_in | 5 a 10 minutos: o cliente está ali, à espera | 1 a 60 minutos |
| max_attempts | 3 a 5 | 1 a 10 |
| text | O nome do seu serviço, {code} e «Não o partilhe» | Até 300 caracteres |
| sender | O seu Sender ID, se o tiver | Aprovado para o país do número |
Conta criada antes ou depois do código?
As duas maneiras funcionam. Se criar a conta logo, deixe-a num estado «número por confirmar» e não lhe dê acesso ao que depende do telemóvel. Se criar só depois do código, guarde os dados do formulário na sessão até valid: true. O que nunca deve fazer é dar o número como confirmado só porque o SMS saiu.
| Responda da mesma maneira, exista ou não uma conta com aquele número. Uma mensagem como «Este número já está registado» diz a qualquer pessoa quem é seu cliente. Prefira «Se o número for válido, vai receber um código» e trate o caso de quem já tem conta depois de confirmar o código. |
| Teste o fluxo inteiro na Sandbox antes de abrir o registo ao público: a resposta do envio traz o código, e pode experimentar o código certo, o errado e o expirado sem gastar créditos. |
|
Quer confirmar o número de quem se regista no seu site ou aplicação? Veja o SMS de Verificação. Ver o SMS de Verificação |
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 cupão) Ver planos |
