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/sendTemplateMessage

Nota: 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?