Resumo
Este guia explica como enviar uma Senha de Uso Único (OTP) via WhatsApp usando a API da Wati. Você aprenderá a criar um modelo de autenticação, obter aprovação e disparar mensagens OTP usando a API /sendTemplateMessage.
Disponibilidade
Os modelos de autenticação estão disponíveis para clientes Wati nos planos Growth, Pro e Business.
Se você possui um plano legado da Wati, os modelos de autenticação estão disponíveis nos planos Standard e Professional.
Instruções
Consulte este tutorial em vídeo para aprender a enviar OTPs no WhatsApp via Wati:
Passo 1: Criar um modelo de autenticação
Antes de enviar OTPs, você precisa criar uma mensagem de modelo de autenticação e obter a aprovação do WhatsApp. Esse 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 de OTP deve incluir:
Mensagem de verificação: Um texto predefinido contendo o espaço reservado para a 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 de Copiar código ou Preenchimento automático com um toque.
Notas importantes
URLs, mídia e emojis não são suportados em modelos de autenticação.
Esses modelos reduzem o risco de suspensão da conta, pois consistem apenas em texto predefinido e botões.
Após enviar o modelo, aguarde a aprovação do WhatsApp antes de prosseguir para o próximo passo.
Passo 2: Enviar OTP usando a API
Uma vez aprovado, você pode disparar a OTP usando a API /sendTemplateMessage da Wati. Essa 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/sendTemplateMessageNota: Para comerciantes que utilizam a API da Wati para enviar mensagens de autenticação OTP, é possível habilitar o fallback (alternativa) por SMS para ajudar a garantir a entrega da OTP e manter as operações comerciais funcionando perfeitamente, mesmo que as mensagens de WhatsApp falhem.
Usando a API Send Template Message V3
É possível enviar modelos de AUTENTICAÇÃO (Copiar código) via endpoint POST /api/ext/v3/messageTemplates/send?
Sim. Algumas coisas a saber ao enviar modelos de autenticação (códigos OTP) através deste endpoint:
Nome do parâmetro: Use
#{{1}}para o valor da OTP/código.Expiração do código: 90 minutos é o tempo máximo de expiração permitido pela Meta.
Configuração do modelo: Os modelos de autenticação devem ser criados usando o formato de modelo de autenticação predefinido da Meta, ou selecionados na biblioteca de modelos - eles não podem ser criados como modelos de formato livre.
Para obter os parâmetros de solicitação completos, formato de resposta e códigos de erro para o envio de modelos de mensagem (incluindo modelos de autenticação), consulte a referência da API V3 de Envio de Modelo de Mensagem.
Configurar fallback por SMS se a OTP do WhatsApp falhar
Siga estes passos para configurar o SMS como fallback caso uma mensagem OTP de WhatsApp falhe:
Passo 1: Atualize para o plano Wati Business
O fallback por SMS está disponível apenas no plano Business.
Passo 2: Conecte a Wati ao Twilio
Na Wati, vá em Mais → Integrações.
Adicione sua conta Twilio e ative Enviar SMS automático para campanhas com falha.
Passo 3: Criar um modelo de OTP para WhatsApp
Na Wati, crie o modelo de mensagem que será usado para a autenticação OTP via WhatsApp.
Passo 4: Criar um modelo de OTP para SMS
Crie um modelo de SMS correspondente e mapeie-o para o modelo de OTP de WhatsApp que você criou no Passo 3.
Passo 5: Enviar a OTP via WhatsApp usando a API da Wati
Quando seu sistema chamar a API da Wati para enviar o modelo de OTP de WhatsApp, a Wati enviará automaticamente o SMS de fallback através do Twilio caso a entrega pelo WhatsApp falhe.
Dica: Para saber mais sobre modelos de autenticação, consulte o guia oficial da Meta.
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 via Wati. Ele inclui um espaço reservado para OTP, texto de verificação predefinido e um botão como "Copiar código" ou "Preenchimento automático".
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. Deve também incluir um botão, como Copiar código ou Preenchimento automático.
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. Os 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.
Enviando OTP através da API da Wati
5. Como envio mensagens OTP usando a Wati?
Uma vez que seu modelo de autenticação esteja aprovado, você pode enviar OTPs usando a API /sendTemplateMessage da Wati.
6. Qual é o endpoint da API para envio de mensagens OTP?
O endpoint é: https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage
7. Posso enviar modelos de AUTENTICAÇÃO usando o endpoint POST /api/ext/v3/messageTemplates/send?
Sim. Você pode enviar modelos de autenticação, incluindo códigos OTP, usando o endpoint /api/ext/v3/messageTemplates/send. Use #{{1}} como parâmetro para o valor da OTP ou código. O tempo máximo de expiração permitido pela Meta é de 90 minutos. Os modelos de autenticação devem usar o formato predefinido da Meta ou ser selecionados da biblioteca de modelos; não podem ser criados como modelos de formato livre.
Para parâmetros de solicitação, formatos de resposta e códigos de erro completos, consulte a referência da API V3 de Envio de Modelo de Mensagem.
Disponibilidade e configuração de fallback
8. Quais planos da Wati suportam modelos de autenticação?
Eles são suportados nos planos Growth, Pro e Business. Em planos legados, são suportados nos planos Standard e Professional.
9. O que é o fallback por SMS e quem pode usá-lo?
O fallback por SMS garante a entrega da OTP ao enviar um SMS caso a OTP do WhatsApp falhe. Está disponível apenas no plano Wati Business.
10. Como habilito o fallback por SMS na Wati?
Conecte sua conta Twilio na Wati em Mais → Integrações e ative o SMS automático para campanhas com falha. Você também deve criar modelos de OTP tanto para WhatsApp quanto para SMS e mapeá-los para que o fallback funcione automaticamente.
Did this answer your question?