Neste conteúdo (7 partes)
Como funciona o código de verificação pelo WhatsApp?
Quando um site ou aplicativo pede 'digite o código que enviamos por WhatsApp', o que está por trás é um template de autenticação enviado pela API oficial. É a categoria que a Meta reserva ao OTP (senha de uso único). O sistema da empresa gera o código, entrega o pedido de envio para a API e o cliente recebe a mensagem no WhatsApp. Quem gera e valida o código é sempre o sistema da empresa; o WhatsApp só entrega a mensagem.
A mensagem é tratada de forma diferente das outras categorias. O texto vem de um modelo da biblioteca da Meta, o que dá um formato padronizado, e o código vem acompanhado do botão de OTP. A visão das três categorias, com exemplos, está em categorias de template do WhatsApp.
Quais são as regras da Meta para o template de autenticação?
| Regra | O que significa na prática |
|---|---|
| Categoria exclusiva para OTP | Só código de verificação usa autenticação. Qualquer outro conteúdo precisa de utilidade ou marketing |
| Template da biblioteca | Você parte de um modelo pronto da Meta, não de um texto livre |
| Botão de OTP | O código vai com o botão de OTP do próprio modelo, no formato definido pela biblioteca da Meta |
| Sem URL, mídia ou emoji | Nada de link, imagem, vídeo, documento nem emoji no modelo |
| Mal classificado é rejeitado | Template de autenticação que na verdade não é OTP vira Rejeitado no primeiro dia do mês seguinte, sem recurso; é preciso refazer pela biblioteca |
| Sem dados financeiros completos | A política veda pedir ou compartilhar número de cartão ou de conta financeira completos |
As regras têm uma consequência direta: o código não é lugar para propaganda. Pela regra da Meta, conteúdo misto é tratado como marketing, e um template cadastrado como autenticação que não é só código acaba rejeitado. Quem precisa dos dois assuntos envia dois templates, em momentos separados.
Em quais situações vale usar o código por WhatsApp?
| Caso de uso | Como funciona | Cuidado |
|---|---|---|
| Login | A pessoa informa o número, recebe o código e entra | Limite as tentativas e o tempo de validade no seu sistema |
| Cadastro | Confirma que o número informado é da própria pessoa | Mostre na tela qual número receberá o código para evitar digitação errada |
| Confirmação de compra | Valida uma transação sensível antes de concluir | Não peça dado de cartão completo por mensagem |
| Troca de senha | Autoriza a redefinição de credenciais | Avise por outro canal quando a senha for alterada |
| Aceite de mensagens (opt-in) | Confirma que o número digitado no formulário de aceite é da própria pessoa | O aceite deve citar o nome da empresa, e a mensagem que confirma o aceite é de utilidade, não de autenticação |
O último caso tem relação direta com disparo em massa. A política da Meta só permite contatar quem deu o número e aceitou receber mensagens daquela empresa, e a confirmação por código pode ajudar a provar que o número pertence à pessoa certa. O assunto completo está em opt-in no WhatsApp e em registro de consentimento.
Como colocar o código de verificação por WhatsApp no ar?
- 1Tenha acesso à API oficial
Você precisa de portfólio empresarial, número conectado e provedor ou integração direta. O caminho está em como conseguir a API oficial do WhatsApp.
- 2Crie o template de autenticação pela biblioteca
Escolha o modelo de OTP e mantenha o conteúdo simples: sem link, mídia ou emoji.
- 3Espere a aprovação
A análise pode levar até 24 horas, então não deixe para criar o modelo na véspera do lançamento.
- 4Gere e valide o código no seu sistema
Defina tamanho, prazo e número de tentativas. Esse controle é seu, não do WhatsApp.
- 5Monitore o status de entrega
Acompanhe os eventos de envio e falha, que chegam por webhook, para oferecer outro caminho quando o código não chegar. Veja webhook do WhatsApp API.
ANTES [ ] API oficial ativa e número conectado [ ] Template de autenticação criado pela biblioteca [ ] Template aprovado (a análise pode levar até 24 horas) [ ] Webhook de status ligado NO SEU SISTEMA [ ] Código gerado e guardado pelo servidor, nunca pelo aplicativo do cliente [ ] Prazo de validade definido: ______ [ ] Limite de tentativas definido: ______ [ ] Limite de pedidos de novo código por pessoa: ______ [ ] Tela mostra para qual número o código foi enviado [ ] Alternativa quando o código não chega: ______ REGRAS DA META [ ] Sem URL, mídia ou emoji no template [ ] Nenhuma promoção misturada ao código [ ] Nenhum pedido de cartão ou conta completos por mensagem
Quais erros mais atrapalham o envio de código?
- Misturar promoção com código. Conteúdo misto é tratado como marketing e não cabe no template de autenticação.
- Cadastrar como autenticação o que não é só código. Autenticação mal classificada é rejeitada no primeiro dia do mês seguinte, sem recurso.
- Número digitado errado. O código vai para outra pessoa. Peça confirmação do número antes do envio.
- Pedido repetido sem limite. Quem tenta de novo várias vezes enche o cliente de mensagens; limite os reenvios.
- Sem alternativa de entrega. Se o código não chega, a pessoa precisa de outro caminho.
- Tratar o WhatsApp como único canal. O código por WhatsApp complementa o atendimento e não substitui a segurança do seu sistema.
Onde a AD PRO entra nesse fluxo?
Se a sua dúvida é sobre campanhas para quem já autorizou receber mensagens, veja o guia de disparo em massa e como fazer disparo em massa no WhatsApp.
Perguntas frequentes
O que é o código de verificação pelo WhatsApp?
É um código de uso único (OTP) que uma empresa envia ao cliente pela API oficial, usando um template de autenticação. A pessoa digita ou copia o código para concluir um login, cadastro ou confirmação. O código é gerado e validado pelo sistema da empresa.
Como enviar código de verificação por WhatsApp?
Crie um template de autenticação pela biblioteca da Meta, espere a aprovação (a análise pode levar até 24 horas) e dispare o envio pelo seu sistema ou provedor, conectado à API oficial. Mantenha o texto sem link, mídia ou emoji.
Posso colocar promoção no template de autenticação?
Não. A categoria de autenticação é só para código de verificação. Conteúdo misto vira marketing, e um template de autenticação mal classificado é rejeitado no primeiro dia do mês seguinte, sem recurso. Para a oferta, use um template de marketing separado.
O código de verificação do WhatsApp aceita link ou emoji?
Não. As regras da Meta para a categoria de autenticação são: template da biblioteca, botão de OTP e sem URL, mídia ou emoji. Link ou oferta vão em outro template, de outra categoria.
Código de verificação é cobrado como mensagem de marketing?
Não, ele tem categoria própria. A Meta cobra por mensagem entregue, por categoria e país, e oferece desconto por volume para utilidade e autenticação, não para marketing. A tabela de valores muda, então confira a página oficial de preços. Veja preço da API oficial do WhatsApp.
- Meta for Developers, categorização de templates (consultado em 31/10/2026)
- Meta for Developers, componentes de template (consultado em 31/10/2026)
- Meta for Developers, preços da WhatsApp Business Platform (consultado em 31/10/2026)
- Meta for Developers, revisão de templates (consultado em 31/10/2026)
- WhatsApp, Política de Mensagens do WhatsApp Business (atualizada em 23/09/2026) (consultado em 31/10/2026)
- Meta for Developers, como obter o opt-in no WhatsApp (consultado em 31/10/2026)