Principal WhatsApp Oficial (API Cloud) Modelos de mensagem do WhatsApp (templates)

Modelos de mensagem do WhatsApp (templates)

Última atualização em Oct 29, 2026

No WhatsApp Oficial (API Cloud), a Meta exige modelos de mensagem aprovados (templates) para:

  • Iniciar uma conversa com um cliente;
  • Responder quando já se passaram mais de 24 horas desde a última mensagem do cliente;
  • Enviar campanhas.

Dentro das 24 horas após a última mensagem do cliente, você conversa normalmente, com mensagens livres.

Categorias

Cada modelo tem uma categoria, que define o preço cobrado pela Meta:

  • Marketing — ofertas, novidades, convites.
  • Utilidade — confirmações de pedido, atualizações de entrega, lembretes.
  • Autenticação — códigos de verificação.

Ver e sincronizar os modelos

Vá em Configurações → Modelos de Mensagem. A lista mostra os modelos de cada caixa do WhatsApp Oficial com a categoria, o idioma e o status (Aprovado, Pendente, Rejeitado...). Filtre por caixa, status e categoria, ou busque pelo nome ou conteúdo.

Modelos de mensagem

  • Sincronizar Modelos — busca na Meta os modelos novos ou alterados (por exemplo, criados direto no Gerenciador do WhatsApp).
  • Habilitado para envio — a chave de cada modelo define se ele aparece para os agentes na hora de enviar.

Criar um modelo

🔒 Disponível para administradores e tipos de agente com a permissão de gerenciar modelos.

  1. Clique em Criar Modelo.
  2. Em Informações Básicas, preencha o Nome do Modelo (apenas letras minúsculas, números e sublinhado — ex.: confirmacao_pedido), escolha a(s) caixa(s) de entrada, a Categoria e o Idioma.
  3. Escolha o Formato de Parâmetros: Positional ({{1}}, {{2}}) ou Named ({{nome}}).
  4. Avance para o Conteúdo: cabeçalho (texto, imagem, vídeo ou documento), corpo da mensagem com as variáveis, rodapé e botões (resposta rápida, link, telefone). A pré-visualização mostra como o cliente vai ver.
  5. Confira a etapa Visualização e clique em Enviar Modelo. O modelo vai para aprovação da Meta, que costuma responder em minutos, mas pode levar até 24 horas.

Criando um modelo

💡 Dicas para aprovação: escreva de forma clara, sem erros, e dê exemplos realistas para as variáveis. Modelos de marketing disfarçados de utilidade costumam ser reclassificados ou rejeitados.

Enviar um modelo na conversa

Quando a janela de 24 horas está fechada, a conversa mostra o aviso "Você só pode responder a esta conversa usando um modelo de mensagem" e o botão Enviar Template:

Conversa fora da janela de 24 horas

  1. Clique em Enviar Template.
  2. Escolha o modelo (filtre por categoria, idioma ou tipo).

Escolhendo o modelo

  1. Preencha as variáveis — por exemplo, o nome do cliente e o número do pedido. A pré-visualização mostra a mensagem final. Os campos aceitam as mesmas variáveis das respostas prontas, como {{contact.first_name}}, que são trocadas pelos dados do contato no envio. Isso vale também para modelos enviados por campanhas e pela API.
  2. Clique em Enviar Mensagem.

Preenchendo as variáveis

Quando o cliente responder, a janela de 24 horas abre de novo e você volta a conversar livremente.

Para iniciar uma conversa nova, use Nova Mensagem no contato, escolha a caixa do WhatsApp Oficial e selecione o modelo.

Histórico do modelo

O botão Histórico de cada modelo mostra tudo o que aconteceu com ele: criação, envio para a Meta, análise, aprovação, mudanças de categoria e de qualidade, com quem fez cada coisa. Quando a Meta muda a categoria de um modelo, você recebe um alerta. Veja Histórico dos modelos do WhatsApp e alertas de categoria.

Qualidade dos modelos

A Meta avalia a qualidade de cada modelo pela reação dos clientes (bloqueios, denúncias). Modelos com qualidade baixa podem ser pausados. Veja Notificações de qualidade e status do WhatsApp.