Resumo
Este guia explica como enviar uma Senha de Uso Único (OTP) via WhatsApp usando a API do 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!
Instruções
Por favor, consulte este vídeo 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 a aprovação do WhatsApp. Este modelo garante um formato consistente para as mensagens de autenticação.
Elementos Necessá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 o 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: Seja 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.
Estes modelos reduzem o risco de serem pausados, pois consistem apenas em texto predefinido e botões.
Depois de enviar o modelo, aguarde a aprovação do WhatsApp antes de prosseguir para a próxima etapa.
Passo 2: Envie OTP Usando a API
Uma vez aprovado, você pode acionar 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 saber mais sobre a API.
Disponibilidade
Os modelos de autenticação estão disponíveis para clientes Wati nos planos Growth, Pro e Business. Se você estiver em um plano legado do Wati, os modelos de autenticação estarão disponíveis nos planos Standard e Professional.
Para mais detalhes, consulte o guia oficial Modelos de Autenticação da API de Gerenciamento de Empresas do WhatsApp.
Observação: Para comerciantes que usam a API do 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 operações comerciais tranquilas, mesmo que as mensagens do WhatsApp falhem.
Siga estas etapas para configurar o SMS como fallback se uma mensagem WhatsApp OTP falhar:
Passo 1: Faça um Upgrade para o Plano Wati Business
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 Twilio e ative Enviar SMS automático para campanhas com falha.
Passo 3: Crie um Modelo WhatsApp OTP
No Wati, crie o modelo de mensagem que será usado para a autenticação OTP do WhatsApp.
Passo 4: Crie um Modelo SMS OTP
Crie um modelo SMS correspondente e mapeie-o para o modelo WhatsApp OTP 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 WhatsApp OTP, 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 o 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?
Ele deve conter uma mensagem de verificação com o espaço reservado para o 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. Os 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.
Envio de OTP através da API do Wati
5. Como envio mensagens OTP usando o Wati?
Depois que seu modelo de autenticação for aprovado, você poderá 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 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 no Wati?
Conecte sua conta Twilio no Wati em Mais → Integrações e habilite o SMS automático para campanhas com falha. Você também deve criar modelos WhatsApp e SMS OTP e mapeá-los juntos para que o fallback funcione automaticamente.