AULA 5: API Oficial - Como criar Modelos de Mensagens para envio fora da janela de 24h

Como Criar Templates de Mensagem no BotConversa para WhatsApp

Aprimore a comunicação com seus clientes através da API Oficial do WhatsApp integrada ao BotConversa. Com esta poderosa combinação, você poderá otimizar seu atendimento de maneira eficiente e agilizar seus processos empresariais.

🎯 O que você vai aprender neste guia

Neste artigo completo, você vai descobrir:

  • ✅ O que são templates de mensagem e por que são essenciais
  • ✅ Como funcionam as categorias de templates (Marketing, Utilidade, Autenticação)
  • ✅ Passo a passo detalhado para criar templates na Meta
  • ✅ Informações sobre precificação e custos
  • ✅ Dicas práticas para aprovação rápida
  • ✅ Como usar templates no BotConversa

📱 O que são Templates de Mensagem?

Templates de mensagem (também chamados de "modelos de mensagem") são mensagens pré-aprovadas pela Meta que permitem que empresas iniciem conversas com clientes no WhatsApp fora da janela de 24 horas.

Por que templates são necessários?

A regra de ouro do WhatsApp Business API é simples:

SituaçãoTipo de mensagem permitidaCusto
Dentro das 24 horas após o cliente enviar uma mensagemMensagens livres (qualquer texto) ou templates de utilidadeGRATUITO ✅
Fora das 24 horas (cliente não enviou mensagem recentemente)Apenas templates pré-aprovadosPAGO 💰

💡 Importante: Sem templates aprovados, você não consegue enviar mensagens proativas para seus clientes!

🏷️ Categorias de Templates: Entendendo as Diferenças

A Meta divide os templates em três categorias principais. Desde fevereiro de 2023, todas as mensagens template se enquadram em apenas três categorias: Marketing, Utilidade ou Autenticação. Escolher a categoria correta é crucial para aprovação e custos.

📢 1. Templates de Marketing

Objetivo: Promover produtos, serviços, ofertas e aumentar engajamento e vendas.

Quando usar Marketing:

  • ✅ Anúncios de novos produtos ou serviços
  • ✅ Promoções e ofertas especiais
  • ✅ Descontos e cupons
  • ✅ Lembretes de carrinho abandonado
  • ✅ Convites para eventos
  • ✅ Conteúdo promocional em geral
  • ✅ Campanhas de reengajamento

Exemplos práticos:

🎉 Olá {{1}}! Aproveite 30% OFF em toda a loja! 
Use o cupom PROMO30. Válido até hoje!
🔥 {{1}}, você deixou itens no carrinho! 
Complete sua compra agora e ganhe frete grátis.
💝 Novidade na loja! Confira nossa nova coleção de verão. 
Clique aqui: {{2}}

⚠️ Atenção importante:

Qualquer mensagem que não se qualifique como utilidade ou autenticação é classificada automaticamente como marketing. Se você misturar conteúdo promocional com informações transacionais, a Meta classificará como marketing.

Exemplo do que NÃO fazer:

❌ "Seu pedido #1234 foi enviado! Aproveite 10% OFF na próxima compra!"

Isso seria classificado como Marketing (não Utilidade) por causa da oferta.

🔧 2. Templates de Utilidade

Objetivo: Fornecer atualizações transacionais, confirmações e informações essenciais relacionadas a ações do cliente.

Quando usar Utilidade:

  • ✅ Confirmações de pedido
  • ✅ Atualizações de envio e rastreamento
  • ✅ Lembretes de agendamento/consulta
  • ✅ Alertas de pagamento e faturas
  • ✅ Atualizações de conta
  • ✅ Notificações de status de transação
  • ✅ Alertas de segurança críticos (fraude, recalls)

Características essenciais de templates de Utilidade:

Templates de utilidade devem ser estritamente não-promocionais e fornecer detalhes específicos sobre uma transação, conta ou interação atual.

  1. Específico: Deve incluir detalhes como números de pedido, datas específicas, valores
  2. Transacional: Relacionado a uma ação concreta do cliente
  3. Não-promocional: Sem ofertas, descontos ou linguagem persuasiva
  4. Solicitado ou Essencial: Acionado por uma ação do usuário ou crítico para segurança

Exemplos práticos:

✅ Olá {{1}}! Seu pedido #{{2}} foi confirmado. 
Previsão de entrega: {{3}}. 
Acompanhe aqui: {{4}}
✅ Olá {{1}}, seu agendamento está confirmado para {{2}} às {{3}}h. 
Endereço: {{4}}.
✅ Alerta de segurança: Detectamos uma tentativa de login não autorizada 
em sua conta em {{1}}. Se não foi você, altere sua senha imediatamente.

💰 Grande vantagem:

Templates de utilidade enviados dentro da janela de 24 horas são GRATUITOS! Isso torna os templates de utilidade ideais para confirmações e atualizações de pedidos.

🔐 3. Templates de Autenticação

Objetivo: Verificar identidade de usuários com códigos de verificação e senhas temporárias.

Quando usar Autenticação:

  • ✅ Códigos OTP (One-Time Password)
  • ✅ Verificação de conta
  • ✅ Recuperação de senha
  • ✅ Autenticação de dois fatores (2FA)
  • ✅ Códigos de autorização de transação

Regras especiais para Autenticação:

Você deve usar os templates de autenticação predefinidos do WhatsApp, que incluem avisos de segurança opcionais e botões de senha de uso único (copiar código ou um toque).

Restrições de conteúdo:

  • ❌ URLs, mídias e emojis não são permitidos
  • ❌ Parâmetros limitados a 15 caracteres
  • ✅ Use apenas formatos pré-aprovados da Meta

Exemplo prático:

🔒 {{1}} é seu código de verificação. 
Válido por 10 minutos. Não compartilhe este código.

💰 Entendendo a Precificação de Templates

A partir de 1º de julho de 2025, a Meta mudou para o modelo de precificação por mensagem (ao invés de por conversa). Isso significa que cada template enviado é cobrado individualmente.

Como funciona a cobrança:

Tipo de TemplateCustoObservações
Marketing💰 SEMPRE PAGOCobrado por mensagem entregue, independente da janela de 24h
Utilidade🆓 GRÁTIS dentro das 24h<br>💰 PAGO fora das 24hMelhor custo-benefício para atualizações transacionais
Autenticação💰 SEMPRE PAGOCobrado por mensagem, mesmo dentro das 24h
Mensagens livres (resposta dentro das 24h)🆓 SEMPRE GRÁTISNão requer template

💡 Dica de economia:

Templates de utilidade são gratuitos quando enviados dentro da janela de serviço ao cliente de 24 horas. Use isso a seu favor! Envie confirmações de pedido e atualizações de status logo após o cliente fazer uma compra ou enviar uma mensagem.

Precificação por região:

🔗 Onde encontrar preços atualizados:

  • Calculadora oficial de preços do WhatsApp
  • Pricing Explainer PDF da Meta

📋 Pré-Requisitos

Antes de criar templates, certifique-se de ter:

✅ Um número conectado na API Oficial do WhatsApp ✅ Número integrado na plataforma BotConversa ✅ Acesso ao Meta Business Manager ✅ Negócio verificado na Meta (recomendado)

💡 Se você ainda não conectou seu número, consulte nosso guia: Como Conectar a API Oficial do WhatsApp ao BotConversa

🎨 Passo a Passo: Criando Templates na Meta

Passo 1: Acessar Configurações > Conexão > Modelos de Mensagem

Passo 2: Clique em Criar  e Selecione o Tipo De Modelo

📂 Categoria

Escolha a categoria que melhor corresponde ao propósito da sua mensagem:

  • Marketing: Para promoções, ofertas, novidades
  • Utility (Utilidade): Para atualizações transacionais

⚠️ Dica crítica: A Meta verifica automaticamente se os templates estão categorizados corretamente. Templates classificados incorretamente podem ser recategorizados automaticamente ou rejeitados. Se você tentar enviar conteúdo promocional como "utilidade" para economizar, a Meta pode:

  • Recategorizar automaticamente para Marketing
  • Enviar um aviso
  • Restringir seu uso de mensagens de utilidade por 7 dias

Passo 3: Definir Nome e Idioma

Você verá um formulário com três campos principais:

✏️ Nome

Crie um nome descritivo para identificar a mensagem internamente. O cliente não vê este nome.

Boas práticas:

  • Use nomes claros:
  • Use letras minúsculas e underscores (sem espaços)
  • Seja específico para facilitar localização futura

🌍 Idioma

⚠️ ATENÇÃO IMPORTANTE: Selecione "Portuguese (BR)" - Português do Brasil

🚨 Erro comum: Existem dois idiomas com "Portuguese":

  • ❌ Portuguese (PT) - Portugal
  • ✅ Portuguese (BR) - Brasil

Se você selecionar o idioma errado, o template não será reconhecido pelo BotConversa e dará erro ao tentar utilizá-lo.

Após preencher todos os campos, clique em "Continuar".

Passo 4: Personalizar a Mensagem

Agora vem a parte criativa! Você tem várias opções para personalizar sua mensagem:

🏷️ Cabeçalho (Header) - Opcional

O cabeçalho aparece no topo da mensagem e pode ser:

  • Texto: Uma frase de impacto (até 60 caracteres)
  • Imagem: Banner promocional ou logo
  • Vídeo: Conteúdo multimídia (até 16 MB)
  • Documento: PDF, planilha, etc.

Exemplos de cabeçalhos eficazes:

🎉 OFERTA EXCLUSIVA PARA VOCÊ!
📦 Atualização do Seu Pedido
⚡ Código de Verificação

📝 Corpo da Mensagem (Body) - Obrigatório

O texto principal da sua mensagem (até 1.024 caracteres).

Usando variáveis dinâmicas:

Você pode inserir variáveis usando o formato {{1}}, {{2}}, {{3}}, etc. Essas variáveis serão substituídas por informações reais quando você enviar a mensagem.

Exemplo:

Olá {{1}}! 👋

Seu pedido #{{2}} foi confirmado com sucesso!

📦 Itens: {{3}}
💰 Total: R$ {{4}}
📅 Previsão de entrega: {{5}}

Agradecemos pela preferência!

Quando enviada, ficaria assim:

Olá Maria! 👋

Seu pedido #12345 foi confirmado com sucesso!

📦 Itens: Tênis Nike Air Max
💰 Total: R$ 299,90
📅 Previsão de entrega: 25/10/2025

Agradecemos pela preferência!

👣 Rodapé (Footer) - Opcional

Uma linha adicional no final da mensagem (até 60 caracteres), geralmente usada para:

  • Nome da empresa
  • Informações legais
  • Texto de desativação

Exemplos:

© 2025 Sua Empresa - Todos os direitos reservados
Para cancelar, responda SAIR

🔘 Botões (Buttons) - Opcional

Adicione até 3 botões de ação para facilitar a interação do cliente:

Tipos de botões disponíveis:

  1. Call to Action (Visitar site)
  2. Call to Action (Ligar)
  3. Quick Reply (Resposta Rápida)

Exemplo de configuração de botões:

Botão 1: [Ver Pedido] → https://seusite.com/pedido/{{1}}
Botão 2: [Falar com Suporte] → +55 11 9 9999-9999
Botão 3: [OK, Entendi] → Resposta Rápida

Passo 5: Visualizar e Enviar

Antes de enviar, você verá uma prévia de como sua mensagem aparecerá no WhatsApp do cliente.

✅ Revise cuidadosamente:

  • Ortografia e gramática
  • Variáveis estão nos lugares corretos
  • Botões funcionam conforme esperado
  • Categoria está correta

Quando estiver satisfeito, clique em "Enviar" (ou "Submit").

Passo 6: Confirmar Idioma

A Meta pedirá para você confirmar o idioma selecionado. Verifique novamente que está como "Portuguese (BR)" e confirme.

Passo 7: Aguardar Aprovação

⏳ Tempo de aprovação: Normalmente leva até 3 dias úteis, mas pode levar até 24 horas para templates simples.

Durante este período, o status do template aparecerá como:

  • 🟡 Pending (Pendente) - Aguardando revisão
  • 🟢 Approved (Aprovado) - Pronto para usar
  • 🔴 Rejected (Rejeitado) - Necessita correções

Você receberá uma notificação por e-mail quando o status mudar.

⚠️ Principais Motivos de Rejeição

Sua mensagem pode ser rejeitada se:

❌ Categoria incorreta: Conteúdo promocional categorizado como "utilidade" ❌ Gramática e ortografia: Erros de português ❌ Conteúdo enganoso: Promessas falsas ou clickbait ❌ Violação de políticas: Conteúdo proibido (álcool, tabaco, armas, etc.) ❌ Formatação inadequada: Uso excessivo de emojis, CAPS LOCK, ou símbolos ❌ Variáveis mal posicionadas: Variáveis que não fazem sentido no contexto ❌ Falta de contexto: Mensagem muito vaga ou genérica

💡 Dicas para Aprovação Rápida

✅ Dicas de Conteúdo:

  1. Seja claro e objetivo: Vá direto ao ponto
  2. Use linguagem profissional: Evite gírias ou linguagem muito informal
  3. Personalize com variáveis: Torna a mensagem mais relevante
  4. Inclua call-to-action claro: Diga ao cliente o que fazer
  5. Respeite a categoria: Não misture conteúdo promocional em utilidade

✅ Dicas de Formatação:

  1. Emojis com moderação: Use 1-3 emojis relevantes, não exagere
  2. Evite CAPS LOCK: Não use texto todo em maiúsculas
  3. Quebre em parágrafos: Facilita a leitura
  4. Use espaçamento: Deixe a mensagem respirar
  5. Teste as variáveis: Certifique-se de que fazem sentido

✅ Dicas de Categoria:

Para garantir que seu template seja categorizado corretamente:

Se sua mensagem contém...Use esta categoria
Ofertas, promoções, descontos📢 Marketing
"Aproveite", "Garanta já", CTAs persuasivos📢 Marketing
Número de pedido, status de envio🔧 Utilidade
Lembrete de consulta com data específica🔧 Utilidade
Código numérico de verificação🔐 Autenticação

Se sua mensagem mistura conteúdo promocional com informações transacionais, ela será classificada como marketing.

🚀 Como Usar Templates no BotConversa

Depois que seu template for aprovado pela Meta, você poderá utilizá-lo no BotConversa de várias formas:

1. Envios em Massa (Broadcasts)

Envie campanhas de marketing para milhares de contatos simultaneamente.

Passo a passo:

  1. Acesse Broadcasts no menu do BotConversa
  2. Clique em "Novo Broadcast"
  3. Selecione o template aprovado
  4. Escolha os contatos de destino (por tags, segmentos, etc.)
  5. Preencha as variáveis do template
  6. Agende ou envie imediatamente

2. Automações

Configure fluxos automáticos que enviam templates baseados em gatilhos.

Exemplos de automações:

  • Enviar confirmação de pedido automaticamente após compra
  • Lembrete de consulta 24h antes do horário agendado
  • Recuperação de carrinho abandonado após 2 horas

3. Chat Manual

Envie templates manualmente durante conversas individuais:

  1. Abra a conversa com o cliente
  2. Clique no ícone de "Templates"
  3. Selecione o template desejado
  4. Preencha as variáveis
  5. Envie

4. Integrações via API

Use a API do BotConversa para enviar templates a partir de:

  • Seu site ou aplicativo
  • Sistema de e-commerce
  • CRM
  • Outros sistemas integrados

Este artigo foi útil?

AULA 4: Visão Geral do BotConversa
AULA 6: API Oficial - Como usar o bloco "Enviar Mensagem" para configurar Automações.