Um código de login parece uma coisa pequena. Até você construir: gerar um número seguro, guardá-lo sem deixá-lo à vista, enviá-lo, reenviá-lo quando o cliente não o vê, expirá-lo, limitar as tentativas erradas e impedir que alguém o use para encher de mensagens o telefone de outra pessoa.
Agora o Boom cuida de tudo isso. Você faz duas chamadas de API: uma para pedir o código e outra para validar o que o seu cliente digitou.
Como funciona
- Peça o código. Seu backend chama
POST /api/v1/otp/sendcom o telefone do seu cliente ou com o ID externo dele. O Boom cria o código, envia pelo WhatsApp e responde com umotpId. - Seu cliente recebe no WhatsApp com um botão Copiar código e o digita no seu app.
- Valide. Seu backend chama
POST /api/v1/otp/verifycom ootpIde o código. O Boom responde se ele é válido.
O que um código válido libera continua no seu app: o Boom só diz se o código está certo.
Do que o Boom cuida
- Reenvios sem código novo. Se você pedir outro enquanto o anterior ainda vale, o Boom reenvia o mesmo código com o mesmo
otpId, então a primeira mensagem continua servindo. - Limites contra abuso. Uma espera entre reenvios e um máximo de envios por número a cada hora. Depois de várias tentativas erradas, o código é bloqueado.
- Expiração. O código vence quando o seu modelo de WhatsApp indica.
- Telefones compartilhados. Se dois pacientes ou clientes usam o mesmo número, cada um recebe o seu próprio código.
- O código não fica à vista. Ele é guardado criptografado só enquanto pode ser usado. Na caixa de entrada e para os seus agentes de IA ele aparece oculto, e o agente continua podendo responder se o seu cliente responder a mensagem.
- Chega mesmo para quem não quer mensagens. Um código é algo que a pessoa acabou de pedir, não uma mensagem de marketing, então ele chega mesmo se ela estiver na sua lista de Não Contatar. Cada um desses envios fica registrado.
Configure em minutos
Acesse Transacionais › Códigos de uso único:
- Escolha o número de WhatsApp de onde os códigos são enviados.
- Escolha ou crie o modelo do código. O WhatsApp escreve o texto; você escolhe o idioma, a expiração e se inclui a linha de segurança. A aprovação costuma levar alguns minutos, e a página verifica sozinha.
- Ajuste as regras do código: tamanho, tentativas erradas antes de bloquear, espera entre reenvios e envios por hora.
- Envie um código de teste para o seu telefone e valide na mesma página.
O cartão Conecte seu app mostra as duas chamadas prontas para copiar. Qualquer chave de API do seu espaço de trabalho serve.
Quanto custa
Cada código que o WhatsApp entrega é cobrado como uma mensagem de modelo de autenticação, assim como cada reenvio entregue. O código de teste da página também é um envio real e é cobrado.
Já está disponível
Os códigos de uso único estão disponíveis em todos os espaços de trabalho. Você só precisa de um número de WhatsApp conectado. Por enquanto os códigos são enviados pelo WhatsApp; a documentação traz cada resposta e cada erro.
