Resumo
Este guia explica como enviar uma senha de uso único (OTP) via WhatsApp usando a API da Wati. Você aprenderá como criar um modelo de autenticação, obter aprovação e acionar mensagens OTP usando a API /sendTemplateMessage.
Observação: Broadcasts agora são Campaigns – os mesmos recursos poderosos, nome atualizado!
Disponibilidade
Os modelos de autenticação estão disponíveis para os clientes Wati nos planos Growth, Pro e Business.
Se você estiver em um plano legado da Wati, os modelos de autenticação estarão disponíveis nos planos Standard e Professional.
Instruções
Consulte este passo a passo em vídeo para aprender sobre o envio de OTPs no WhatsApp via Wati:
Etapa 1: Criar um modelo de autenticação
Antes de enviar OTPs, você precisa criar um modelo de mensagem 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 predefinido contendo o espaço reservado para OTP.
<VERIFICATION_CODE>é 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.
Notas importantes
URLs, mídia e emojis não são compatíveis em modelos de autenticação.
Esses modelos reduzem o risco de serem pausados, pois consistem apenas em texto e botões predefinidos.
Depois de enviar o modelo, aguarde a aprovação do WhatsApp antes de prosseguir para a próxima etapa.
Etapa 2: Enviar OTP usando a API
Uma vez aprovado, você pode acionar o OTP usando a API /sendTemplateMessage da Wati. Esta API permite que seu sistema envie a mensagem de autenticação pré-aprovada aos usuários.
Endpoint da API:
https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessageObservação: Para os comerciantes que usam a API da Wati para enviar mensagens OTP de autenticação, você pode habilitar o fallback de SMS para ajudar a garantir a entrega do OTP e manter as operações comerciais tranquilas, mesmo que as mensagens do WhatsApp falhem.
Configurar o fallback de SMS se o OTP do WhatsApp falhar
Siga estas etapas para configurar o SMS como um fallback se uma mensagem OTP do WhatsApp falhar:
Etapa 1: Fazer upgrade para o plano Wati Business
O fallback de SMS está disponível apenas no plano Business.
Etapa 2: Conectar a Wati ao Twilio
Na Wati, vá para Mais → Integrações.
Adicione sua conta Twilio e ative Enviar SMS automatizado para campanha com falha.
Etapa 3: Criar um modelo de OTP do WhatsApp
Na Wati, crie o modelo de mensagem que será usado para a autenticação OTP do WhatsApp.
Etapa 4: Criar um modelo de OTP por SMS
Crie um modelo de SMS correspondente e mapeie-o para o modelo de OTP do WhatsApp que você criou na Etapa 3.
Etapa 5: Enviar o OTP do WhatsApp usando a API da Wati
Quando seu sistema chama a API da Wati para enviar o modelo de OTP do WhatsApp, a Wati enviará automaticamente o fallback de SMS por meio do Twilio se a entrega do WhatsApp falhar.
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 através da Wati. Inclui um espaço reservado para OTP, texto de verificação predefinido 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?
Deve conter uma mensagem de verificação com o espaço reservado para OTP. Os campos opcionais incluem um aviso de segurança e um aviso de expiração. Também deve incluir um botão como Copiar código ou Preenchimento automático com um toque.
3. Os modelos de autenticação podem incluir URLs, mídia ou emojis?
Não. URLs, mídia e emojis não são compatíveis 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.
Envio de OTP através da API da Wati
5. Como envio mensagens OTP usando a Wati?
Depois que seu modelo de autenticação for aprovado, você poderá enviar OTPs usando a API /sendTemplateMessage da 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 da Wati oferecem suporte a modelos de autenticação?
Eles são suportados nos planos Growth, Pro e Business. Nos planos legados, eles são suportados nos planos Standard e Professional.
8. O que é o fallback de SMS e quem pode usá-lo?
O fallback de SMS garante a entrega do OTP enviando um SMS se o OTP do WhatsApp falhar. Ele está disponível apenas no plano Wati Business.
9. Como habilito o fallback de SMS na Wati?
Conecte sua conta Twilio na Wati em Mais → Integrações e habilite o SMS automatizado para campanha com falha. Você também deve criar modelos de OTP de WhatsApp e SMS e mapeá-los para que o fallback funcione automaticamente.