Resumo
Este guia explica como enviar um Código de Verificação Único (OTP) via WhatsApp usando a API do WATI. Você aprenderá como criar um modelo de autenticação, obter aprovação e disparar mensagens OTP usando a API /sendTemplateMessage.
Instruções
Consulte este vídeo tutorial para aprender sobre o envio de OTPs no WhatsApp via WATI:
Passo 1: Crie um Modelo de Autenticação
Antes de enviar OTPs, você precisa criar uma mensagem de modelo de autenticação e obter aprovação do WhatsApp. Este modelo garante um formato consistente para mensagens de autenticação.
Elementos Obrigatórios no Modelo de Autenticação:
Um modelo de autenticação com botões OTP deve incluir:
Mensagem de verificação: Um texto pré-definido contendo o espaço reservado para OTP.
<VERIFICATION_CODE>é o seu código de verificação.Aviso de segurança (opcional): Para sua segurança, não compartilhe este código.
Aviso de expiração (opcional): Este código expira em
<NUM_MINUTES>minutos.Botão: Um botão Copiar Código ou Preenchimento Automático com Um Toque.
Observações Importantes:
URLs, mídia e emojis não são suportados em modelos de autenticação.
Esses modelos reduzem o risco de serem pausados, pois consistem apenas de texto pré-definido e botões.
Depois de enviar o modelo, aguarde a aprovação do WhatsApp antes de prosseguir para a próxima etapa.
Passo 2: Enviar OTP Usando a API
Após a aprovação, você pode disparar o OTP usando a API /sendTemplateMessage do WATI. Esta API permite que seu sistema envie a mensagem de autenticação pré-aprovada para os usuários.
Endpoint da API:
https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage
Clique aqui para ler mais sobre a API.
Disponibilidade
Modelos de autenticação estão disponíveis para clientes do Wati nos planos Growth, Pro e Business. Se você estiver em um plano legado do Wati, os modelos de autenticação estão disponíveis nos planos Standard e Professional.
Para mais detalhes, consulte o guia oficial WhatsApp Business API Authentication Templates.
Nota: Para comerciantes que utilizam a API do Wati para enviar mensagens OTP de autenticação, você pode habilitar fallback de SMS para ajudar a garantir a entrega de OTP e manter operações comerciais suaves, mesmo que as mensagens do WhatsApp falhem.
Siga estas etapas para configurar o SMS como fallback se uma mensagem OTP do WhatsApp falhar:
Passo 1: Atualize para o plano Business do Wati
O fallback de SMS está disponível apenas no plano Business.
Passo 2: Conecte o Wati ao Twilio
No Wati, vá para Mais → Integrações.
Adicione sua conta do Twilio e ative Enviar SMS automatizados para transmissão falhada.
Passo 3: Crie um modelo de OTP do WhatsApp
No Wati, crie o modelo de mensagem que será usado para autenticação OTP do WhatsApp.
Passo 4: Crie um modelo de OTP de SMS
Crie um modelo de SMS correspondente e mapeie-o para o modelo de OTP do WhatsApp que você criou no Passo 3.
Passo 5: Envie o OTP do WhatsApp usando a API do Wati
Quando seu sistema chamar a API do Wati para enviar o modelo de OTP do WhatsApp, o Wati enviará automaticamente o fallback de SMS via Twilio se a entrega do WhatsApp falhar.
Perguntas Frequentes (FAQs)
Modelos de autenticação e OTP
1. O que é um modelo de autenticação para OTP?
É um formato de mensagem pré-aprovado exigido pelo WhatsApp para enviar OTPs através do Wati. Ele inclui um espaço reservado para OTP, texto de verificação pré-definido e um botão como Copiar Código ou Preenchimento Automático com Um Toque.
2. Quais elementos devem ser incluídos em um modelo de autenticação?
Ele deve conter uma mensagem de verificação com o espaço reservado para OTP. Campos opcionais incluem um aviso de segurança e um aviso de expiração. Ele também deve incluir um botão como Copiar Código ou Preenchimento Automático com Um Toque.
3. Modelos de autenticação podem incluir URLs, mídia ou emojis?
Não. URLs, mídia e emojis não são suportados em modelos de autenticação.
4. Modelos de autenticação precisam de aprovação do WhatsApp?
Sim. Você deve enviar o modelo e aguardar a aprovação do WhatsApp antes de enviar mensagens OTP.
Enviar OTP através da API do Wati
5. Como enviar mensagens OTP usando o Wati?
Depois que seu modelo de autenticação for aprovado, você pode enviar OTPs usando a API /sendTemplateMessage do Wati.
6. Qual é o endpoint da API para enviar mensagens OTP?
O endpoint é: https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage
Disponibilidade e configuração de fallback
7. Quais planos do Wati suportam modelos de autenticação?
Eles são suportados nos planos Growth, Pro e Business. Em planos legados, eles são suportados nos planos Standard e Professional.
8. O que é fallback de SMS e quem pode usá-lo?
O fallback de SMS garante a entrega de OTP enviando uma SMS se o OTP do WhatsApp falhar. Ele está disponível apenas no plano Business do Wati.
9. Como habilitar o fallback de SMS no Wati?
Conecte sua conta do Twilio no Wati em Mais → Integrações e habilite SMS automatizados para transmissão falhada. Você também deve criar modelos de OTP do WhatsApp e SMS e mapeá-los juntos para que o fallback funcione automaticamente.