Como criar um modelo de mensagem na API do WhatsApp, do nome ao botão

Para que serve um modelo de mensagem

Na API oficial do WhatsApp, a empresa só pode mandar mensagem livre para quem escreveu nas últimas 24 horas. Para todo o resto (lembrete de consulta, aviso de pedido, cobrança, retomada de conversa, promoção), é preciso um modelo de mensagem aprovado pela Meta. A documentação oficial resume: modelos são o único tipo de mensagem que pode ser enviado fora de uma janela de atendimento.

Modelos são ativos da conta de mensagens da empresa. Eles podem ser criados de três jeitos:

O conteúdo e as regras são os mesmos nos três.

Passo 1: nome, categoria e idioma

Nome

O nome é só para você e para o sistema; o cliente não vê. Regras oficiais: até 512 caracteres, só letras minúsculas, números e sublinhado. Nomes não precisam ser únicos: você pode ter "lembrete_consulta" em português e "lembrete_consulta" em espanhol.

Dica de organização: comece pelo uso e termine pela versão. Exemplos: lembrete_consulta_v1, pedido_enviado_v2, retomada_orcamento_v1.

Categoria

Marketing, utilidade ou autenticação. A categoria define preço e regras, e a Meta confere pelo conteúdo. Para números do Brasil, desde 1º de outubro de 2026: marketing R$ 0,3217, utilidade e autenticação R$ 0,035 por mensagem entregue. Regra prática: se tem qualquer intenção de vender, é marketing.

Idioma

Você escolhe o código do idioma (para o Brasil, português do Brasil). A Meta não traduz nada: se quiser o mesmo modelo em outro idioma, cria outra versão com o mesmo nome e outro idioma, e cada versão conta no limite de modelos.

Passo 2: o cabeçalho (opcional)

O cabeçalho aparece no topo da mensagem. Tipos:

A mídia de exemplo enviada na criação também passa pela análise. Use uma imagem real, legível e coerente com o texto. O cabeçalho de localização só existe em utilidade e marketing e mostra um mapa; localização em tempo real não é aceita. Não use formatação de markdown no cabeçalho de texto.

Passo 3: o corpo (obrigatório)

O corpo é o texto principal, com até 1.024 caracteres e quantas variáveis forem necessárias. É a única parte obrigatória.

Variáveis numeradas ou nomeadas

Nas variáveis nomeadas, o nome é único, em minúsculas e com sublinhado ({{primeiro_nome}}). Nas numeradas, a ordem começa em 1 e não pode pular.

Regras que reprovam o corpo

• Começar ou terminar com variável.
• Variável com símbolo dentro das chaves (cerquilha, cifrão ou outro caractere especial junto do número ou do nome).
• Muitas variáveis para pouco texto.
• Texto igual (corpo e rodapé) ao de outro modelo da conta.

Como escrever um bom corpo

1. Primeira frase com quem fala e por quê: "Olá, {{1}}. Aqui é da Clínica Sorriso, sobre a sua consulta."
2. O fato principal: data, valor, número do pedido.
3. A ação: o que o cliente faz (confirmar, pagar, responder).
4. Nada a mais. Mensagem curta lê mais.

Formatação básica do WhatsApp funciona no corpo: *negrito* com asteriscos, _itálico_ com sublinhado.

Passo 4: o rodapé (opcional)

Texto curto em cinza, até 60 caracteres, sem variável. Bom para:

• identificar a empresa: "Clínica Sorriso, Centro";
• dar a saída: "Responda SAIR para não receber mais";
• aviso legal curto.

Passo 5: os botões (opcionais)

Um modelo pode ter até 10 botões no total, com limites por tipo:

Regras que confundem:

• O texto de cada botão tem até 25 caracteres.
• Se usar resposta rápida junto com outros tipos, os botões precisam ficar agrupados: primeiro todas as respostas rápidas e depois os outros, ou o contrário. Misturar (resposta, link, resposta) dá erro.
• Com mais de 3 botões, o WhatsApp mostra 2 e esconde o resto atrás de "Ver todas as opções".
• Modelos com 4 ou mais botões, ou com resposta rápida junto de outro tipo, não aparecem no WhatsApp do computador; o cliente é orientado a abrir no celular.
• Variável no botão de link: caracteres especiais (espaço, ç, ñ) precisam ser codificados no envio, ou o envio falha.

O botão de resposta rápida é o mais valioso: o toque do cliente é uma mensagem dele, e isso abre a janela de 24 horas, liberando conversa livre a partir dali.

Passo 6: exemplos e envio para análise

Toda variável precisa de um valor de exemplo, e todo cabeçalho de mídia precisa de uma mídia de exemplo. A Meta usa os exemplos para visualizar como o cliente vai ver a mensagem. Use exemplos realistas:

Depois, envie. A análise usa sistemas automáticos e revisão humana e leva até 24 horas. Aprovado, o modelo fica "Ativo, qualidade pendente" e já pode ser enviado.

Passo a passo no Gerenciador do WhatsApp

1. Entre em business.facebook.com e abra o Gerenciador do WhatsApp.
2. No menu Ferramentas da conta (ícone de maleta), clique em Modelos de mensagem.
3. Se tiver mais de uma conta de mensagens, escolha a certa no canto superior direito.
4. Clique em Criar modelo.
5. Escolha a categoria e, se aparecer, o tipo de modelo (padrão, catálogo, Flow, etc.).
6. Dê o nome e escolha o idioma.
7. Preencha cabeçalho, corpo, rodapé e botões.
8. Clique em Adicionar exemplo e preencha os valores.
9. Confira a prévia à direita.
10. Clique em Enviar.

Limites da conta

Cada versão de idioma conta como um modelo.

O atalho: a biblioteca de modelos da Meta

Antes de escrever do zero, vale olhar a biblioteca de modelos do Gerenciador do WhatsApp. Ela tem modelos prontos de utilidade (lembrete de pagamento, atualização de entrega e outros usos comuns) e de autenticação, já categorizados pela Meta. O texto fixo não pode ser editado; você só ajusta as variáveis, como o nome do cliente e o nome da empresa.

Vantagens:

• Categoria garantida: o modelo já nasce como utilidade ou autenticação.
• Aprovação imediata quando você não personaliza o texto. Se escolher "Personalizar modelo", ele passa pela análise normal.
• Menos erro de formato: as variáveis já estão no lugar certo.

O cuidado é com os valores das variáveis: os modelos da biblioteca checam o tipo de cada variável na hora do envio (endereço válido, data, valor, telefone, e-mail, número), e um valor fora do formato faz o envio falhar. Alguns modelos da biblioteca são formulários (pesquisa de satisfação, falha na entrega) e só aparecem para contas que já tiveram o limite de mensagens aumentado.

Para achar: no Gerenciador do WhatsApp, em Modelos de mensagem > Criar modelo > Navegar pela biblioteca de modelos, use a busca por assunto.

Como testar antes de mandar para muita gente

Modelo aprovado não é modelo testado. Antes de usar numa campanha ou numa rotina automática:

1. Mande para o seu próprio celular e para dois ou três colegas, com variáveis reais.
2. Confira no celular e no computador: modelos com 4 ou mais botões, ou com resposta rápida junto de outro tipo, não aparecem no WhatsApp do computador.
3. Toque em cada botão: o link abre a página certa? A variável do link está codificada (sem espaço, sem acento)?
4. Mande para um lote pequeno de clientes engajados e acompanhe a leitura e as respostas nas primeiras horas.
5. Só depois amplie. A própria Meta controla o ritmo de modelos novos, observando a reação dos primeiros clientes antes de liberar tudo.

Como organizar a biblioteca da sua empresa

Com o tempo, a conta acumula dezenas de modelos. Algumas regras simples evitam bagunça:

Os status do modelo depois de criado

Cinco modelos completos para copiar

1. Lembrete de horário (utilidade)

• Cabeçalho (texto): "Lembrete do seu horário"
• Corpo: "Olá, {{1}}. Seu horário em {{2}} está marcado para {{3}} às {{4}}. Toque em um botão para confirmar ou remarcar."
• Rodapé: "Responda SAIR para não receber lembretes"
• Botões (resposta rápida): Confirmar; Remarcar

2. Pedido enviado (utilidade)

• Cabeçalho (texto): "Seu pedido saiu"
• Corpo: "{{1}}, o pedido {{2}} saiu para entrega hoje. Previsão de chegada: {{3}}."
• Botão (link com variável): Acompanhar pedido → https://suaempresa.com.br/rastreio/{{1}}

3. Segunda via de boleto (utilidade)

• Cabeçalho (documento): o PDF do boleto
• Corpo: "Olá, {{1}}. Segue a segunda via da mensalidade de {{2}}, com vencimento em {{3}}. Se já pagou, desconsidere."

4. Retomar orçamento (marketing)

• Corpo: "Oi, {{1}}! Aqui é {{2}}, da {{3}}. Seu orçamento de {{4}} continua disponível. Quer conversar sobre ele?"
• Botões (resposta rápida): Quero conversar; Agora não; Parar de receber

5. Cupom de volta (marketing)

• Cabeçalho (imagem): foto do produto
• Corpo: "{{1}}, faz um tempo que você não passa na {{2}}. Separamos um cupom para a sua próxima compra, válido até {{3}}."
• Botões: Copiar código (cupom); Ver loja (link)

Erros de quem cria o primeiro modelo

1. Escrever o modelo como se fosse uma conversa, com "kkk", abreviações e várias perguntas. Modelo bom é objetivo.
2. Variável no começo, porque a frase "{{1}}, tudo bem?" parece natural. Reprova.
3. Marcar utilidade e colocar desconto. Vira marketing.
4. Esquecer a saída. Sem "parar de receber", o cliente bloqueia, e o bloqueio derruba a qualidade.
5. Criar dez versões quase iguais. Duplicados são rejeitados e bagunçam a conta.
6. Usar o modelo para quem está dentro da janela. Quem escreveu nas últimas 24 horas pode receber texto livre, mais barato.

Diagnóstico: quais modelos a sua empresa precisa

Comece pelos de utilidade: são mais baratos, mais aprovados e geram menos bloqueio.

Como criar modelos na Certu

Na Certu, os modelos são criados na tela "Meus modelos": você escreve, escolhe a categoria, e o painel envia para a análise da Meta e mostra o status que volta (em análise, aprovado, rejeitado, pausado, desativado). Os aprovados aparecem na caixa de entrada para reabrir conversas com a janela fechada, no agendamento de mensagens para daqui a dias e nas campanhas. Toda conta conectada pela API já começa com um modelo de retomada de conversa aprovado.

O plano Start custa R$ 299 por mês e o Pro, R$ 599. A gente monta tudo pra você e as primeiras 200 mensagens, em até 7 dias, são por nossa conta. Conecte o número em certu.com.br/aprender e crie o seu primeiro lembrete.

Fontes

• Meta for Developers: Fundamentos de modelos (nomes, idiomas, variáveis, limites, status), lida em 23/10/2026
• Meta for Developers: Componentes de modelos (cabeçalho, corpo, rodapé, botões), lida em 23/10/2026
• Meta for Developers: Análise de modelos, lida em 23/10/2026
• Meta for Developers: Biblioteca de modelos, lida em 23/10/2026
• Meta for Developers: Pausa de modelos, lida em 23/10/2026
• Meta for Developers: Preços na Plataforma do WhatsApp Business (tabela em BRL, em vigor 1º/10/2026), lida em 23/10/2026

Leia também

• por que o modelo é rejeitado
• categorias de modelo
• modelos de utilidade prontos
• modelos de marketing prontos
• janela de 24 horas