DOCS

Cadastro de modelos de mensagem WhatsApp

Como criar, revisar, aprovar e manter modelos de WhatsApp para retomadas, transmissões, fluxos, automações e follow-ups na Agilize.

AdministradorGestor

Cadastro de modelos de mensagem WhatsApp

Modelos de mensagem WhatsApp são mensagens pré-aprovadas usadas quando a operação precisa iniciar ou retomar contato ativo com o cliente. Eles são essenciais para conversas fora da sessão de 24 horas, transmissões em massa, fluxos do bot, automações de CRM, lembretes, avaliações e follow-ups comerciais.

Use este guia para cadastrar modelos claros, aprováveis e reutilizáveis, sem perder contexto nem gerar mensagens genéricas.

Ciclo de vida do modelo
Carregando diagrama...
Um modelo nasce como configuração, passa por aprovação do canal e depois pode ser usado em operações controladas.

Quando usar modelos

Use modelos de WhatsApp quando a operação precisa:

  • iniciar um primeiro contato ativo;
  • retomar uma conversa fora da sessão de 24 horas;
  • enviar follow-up comercial depois de uma etapa do funil;
  • confirmar agenda, reunião, protocolo, solicitação ou atendimento;
  • enviar transmissão em massa por WhatsApp;
  • acionar cliente por fluxo do bot;
  • executar automação de CRM;
  • solicitar avaliação depois do atendimento;
  • padronizar mensagens recorrentes sem perder personalização.

Não use modelos para substituir uma conversa humana simples quando a sessão está aberta. Dentro da janela de resposta livre, a equipe pode responder pelo Flow com contexto da conversa.

Antes de começar

Confirme os pré-requisitos:

Pré-requisitoPor que importa
Perfil WhatsApp conectadoO modelo precisa estar vinculado ao WhatsApp/Business correto.
Número habilitadoO modelo só será útil se houver número disponível para envio.
Permissão administrativaO cadastro de modelos é uma configuração sensível.
Finalidade definidaModelos genéricos tendem a ser rejeitados ou usados fora de contexto.
Variáveis planejadasToda variável precisa ter valor no momento do envio.
Categoria corretaA categoria influencia aprovação, finalidade e uso permitido.

O caminho público para cadastro é https://my.agilize.app/messenger/chat/messageTemplate.

Campos do cadastro

Ao clicar em Adicionar, a tela de cadastro reúne as decisões principais do modelo: nome, perfil WhatsApp, idioma, categoria, cabeçalho, corpo, rodapé, variáveis e botões.

CampoComo preencher
Nome / AtalhoUse nome estável, descritivo, em letras minúsculas e com underline. Exemplo: retorno_comercial_proposta.
Perfil WhatsAppSelecione o perfil/número que será dono do modelo.
IdiomaEscolha o idioma do conteúdo, como pt_BR para português do Brasil.
CategoriaEscolha MARKETING, UTILITY ou AUTHENTICATION, conforme a finalidade.
CabeçalhoOpcional. Pode ser texto, imagem, vídeo, documento ou nenhum cabeçalho.
Corpo da mensagemConteúdo principal. Deve explicar o motivo do contato e pode usar variáveis.
RodapéOpcional. Use para informação curta de apoio.
BotõesOpcional. Use resposta rápida, link, telefone ou pagamento quando o cenário exigir ação direta.

Depois que o modelo é criado e enviado para processamento, trate perfil, idioma e categoria como decisões de governança. Se a finalidade mudar muito, prefira criar uma nova versão em vez de reaproveitar um modelo antigo para outro contexto.

Limites e comportamentos do editor

Alguns limites são aplicados pelo editor da Agilize antes do envio do modelo para avaliação do canal.

Parte do modeloLimite ou comportamento
Nome / AtalhoAceita letras minúsculas e underline. O nome é normalizado para o padrão exigido na integração.
IdiomaO cadastro permite pt_BR e en. Use pt_BR para modelos em português do Brasil.
CorpoAté 1024 caracteres. Pode usar variáveis numéricas como {{1}}, {{2}} e {{3}}.
Cabeçalho de textoAté 60 caracteres e no máximo uma variável.
Cabeçalho de imagemArquivo jpg, jpeg ou png, até 5 MB no upload do editor.
Cabeçalho de vídeoArquivo mp4, até 15 MB no upload do editor.
Cabeçalho de documentoArquivo pdf, até 5 MB no upload do editor.
RodapéAté 60 caracteres. Não deve carregar a informação principal da mensagem.
Botões de resposta rápidaAté 3 botões.
Botões de chamada para açãoAté 2 botões, podendo ser link URL ou telefone.
Botão de pagamentoAté 1 botão, quando o cenário de cobrança estiver preparado.
AutenticaçãoUsa estrutura própria para código de verificação; não deve ser tratada como modelo livre de marketing ou utilidade.

Esses limites não substituem as políticas da Meta. Eles ajudam a criar um modelo tecnicamente válido, mas a aprovação continua dependendo da finalidade, do texto e da categoria escolhida.

Escolha a categoria correta

CategoriaQuando usarExemplos
MARKETINGRelacionamento comercial, campanhas, reativação, convite e comunicação promocional ou de nutrição.Reativar lead, apresentar condição comercial, convidar para ação.
UTILITYComunicação transacional, operacional ou de acompanhamento de uma solicitação existente.Confirmar atendimento, lembrar reunião, atualizar protocolo, avisar andamento.
AUTHENTICATIONAutenticação, código ou validação de acesso quando aplicável.Código de verificação ou confirmação de identidade.

Evite escolher categoria apenas pela chance de aprovação. A categoria deve representar a finalidade real do contato.

As categorias seguem a lógica da WhatsApp Business Platform da Meta: modelos de Marketing, Utilidade e Autenticação têm finalidades diferentes e podem impactar aprovação, cobrança, qualidade e entrega. Em caso de dúvida, confira também as diretrizes oficiais de modelos da Meta.

Como aumentar a chance de aprovar como Utilidade

Um modelo de utilidade precisa estar ligado a uma solicitação, transação, atendimento, agendamento, protocolo ou ação já existente. Ele deve ajudar o cliente a acompanhar algo que ele espera receber, não criar uma nova intenção comercial.

Use UTILITY quando a mensagem:

  • confirma uma ação que o cliente acabou de realizar;
  • informa andamento de atendimento, suporte, pedido, entrega, agenda ou solicitação;
  • lembra um compromisso já combinado;
  • pede complemento necessário para concluir um processo em aberto;
  • comunica status, protocolo, prazo, disponibilidade ou resolução de uma demanda existente.

Evite classificar como UTILITY quando a mensagem:

  • tenta vender, reativar interesse ou apresentar uma nova oferta;
  • contém desconto, condição comercial, cupom, promoção ou campanha;
  • mistura confirmação operacional com convite para comprar outro produto;
  • usa linguagem vaga, como “podemos conversar?” sem contexto transacional;
  • pede uma resposta para iniciar uma nova negociação, e não para concluir uma solicitação atual.

Padrões que ajudam:

Melhor práticaPor quê
Cite o contexto da solicitação.A Meta tende a avaliar melhor mensagens com motivo claro.
Use protocolo, data, assunto ou nome do atendimento quando existir.Mostra que a mensagem está ligada a uma interação específica.
Mantenha uma única finalidade.Misturar atualização operacional com oferta comercial pode deslocar o modelo para marketing.
Evite linguagem promocional.Termos como desconto, promoção, oferta, novidade e oportunidade sugerem marketing.
Use chamada de ação operacional.Prefira “responda para complementar o atendimento” em vez de “responda para conhecer nossas condições”.

Exemplo mais adequado para utilidade:

Olá, {{1}}. Seu atendimento sobre {{2}} foi atualizado.
Se precisar complementar alguma informação, responda esta mensagem.

Exemplo que tende a ser marketing, mesmo com aparência de follow-up:

Olá, {{1}}. Temos uma condição especial para você concluir sua contratação.
Responda esta mensagem para aproveitar.

Se o objetivo real for reativar lead, oferecer condição, apresentar produto ou gerar nova oportunidade, use MARKETING. Forçar esse conteúdo como utilidade aumenta o risco de recategorização, rejeição ou queda de qualidade.

Escreva o nome do modelo

O nome deve ser fácil de encontrar e seguro para manutenção. Use um padrão consistente:

Bom padrãoEvite
confirmacao_atendimentoteste
retorno_comercial_propostamensagem_1
lembrete_reuniao_agendadanovo_modelo
avaliacao_pos_atendimentocliente_responde

Boas práticas:

  • use letras minúsculas;
  • separe palavras com underline;
  • inclua objetivo e contexto;
  • evite datas, nomes de pessoas e campanhas muito temporárias;
  • não crie um modelo novo para pequenas variações que podem ser resolvidas com variáveis.

Monte o corpo da mensagem

O corpo é a parte principal do modelo. Ele deve responder três perguntas:

  1. Quem está falando?
  2. Por que o cliente está recebendo a mensagem?
  3. O que o cliente deve fazer agora?

Exemplo:

Olá, {{1}}. Passando para confirmar seu atendimento sobre {{2}}.
Se ainda precisar de ajuda, responda esta mensagem e nossa equipe continuará o acompanhamento.

Nesse exemplo:

VariávelExemplo de valor
{{1}}Nome do cliente
{{2}}Assunto, protocolo, produto ou solicitação

Evite textos vagos como:

Olá, tudo bem? Podemos conversar?

Esse tipo de mensagem não explica o motivo do contato e tende a gerar baixa resposta.

Use variáveis com cuidado

Variáveis tornam o modelo versátil, mas também aumentam o risco de envio incompleto. A Agilize permite inserir variáveis no corpo e, quando o cabeçalho é texto, também no cabeçalho.

Fontes comuns de variável:

FonteUso recomendado
Nome do clienteSaudação personalizada.
TelefoneConfirmações específicas quando necessário.
Nome do colaboradorAssinatura ou referência do responsável.
Valor manualAssunto, protocolo, empresa, data, etapa, link ou descrição específica.

Boas práticas:

  • preencha exemplos realistas para as variáveis;
  • evite variável sem contexto ao redor;
  • não deixe o sentido da mensagem depender apenas da variável;
  • valide se automações e transmissões terão dados para preencher todos os campos;
  • revise a prévia antes de enviar.

Configure o cabeçalho

O cabeçalho é opcional. Use apenas quando ele melhora a compreensão da mensagem.

Tipo de cabeçalhoQuando usarAtenção
NenhumMensagens simples e objetivas.É a opção mais segura para modelos recorrentes.
TextoReforçar o assunto da mensagem.O texto é curto e aceita no máximo uma variável.
ImagemEnviar referência visual aprovada.Use arquivo leve e diretamente relacionado ao conteúdo.
VídeoExplicar algo visualmente quando necessário.Use com parcimônia; arquivos grandes dificultam aprovação e envio.
DocumentoEnviar proposta, boleto, instrução ou anexo padronizado.Confirme se o arquivo é o mesmo para todos ou se será preenchido no envio.

Se usar mídia, selecione um exemplo adequado para análise. O arquivo precisa representar o conteúdo real que será enviado pelo modelo.

Configure rodapé e botões

O rodapé é opcional e curto. Use para informação de apoio, como identificação da empresa ou orientação simples.

Botões podem acelerar a ação do cliente:

Tipo de botãoQuando usarLimite prático
Resposta rápidaQuando o cliente deve escolher uma resposta simples.Até 3 botões.
Link URLQuando a ação leva para página externa, agenda, formulário ou pagamento.Até 2 botões de chamada para ação.
TelefoneQuando o cliente deve ligar para um número.Até 2 botões de chamada para ação.
PagamentoQuando o fluxo usa cobrança ou detalhe de pedido.Use apenas quando o cenário operacional estiver preparado.

Não misture botões com objetivos diferentes no mesmo modelo. Se a mensagem pede confirmação de reunião, não inclua também link de proposta, telefone e pagamento no mesmo texto.

Envie para aprovação e acompanhe

Ao salvar o modelo, a Agilize envia a configuração para processamento na integração do WhatsApp. O modelo só deve ser usado em atendimento, transmissão, fluxo ou automação depois de aprovado.

Antes de cadastrar, revise:

  • nome e finalidade do modelo;
  • perfil WhatsApp correto;
  • idioma compatível com o texto;
  • categoria coerente com a finalidade;
  • exemplos preenchidos para todas as variáveis manuais;
  • mídia de cabeçalho compatível com o conteúdo real;
  • botões coerentes com a ação esperada;
  • ausência de texto promocional em modelos de utilidade.

Acompanhe status e qualidade

A listagem de modelos mostra nome, perfil WhatsApp, cabeçalho, corpo, categoria e status.

Status comuns:

StatusSignificado prático
PROCESSINGA Agilize está processando o modelo para envio ao canal.
PENDINGO modelo foi enviado e aguarda avaliação.
APPROVEDO modelo pode ser usado nos cenários permitidos.
REJECTEDO modelo foi recusado ou não pôde ser integrado. Revise o motivo antes de recriar ou ajustar.

O canal também pode atualizar categoria, motivo de rejeição e qualidade do modelo ao longo do tempo. Revise modelos importantes periodicamente, principalmente os usados em transmissão e automações.

Onde o modelo será usado

Um modelo aprovado pode aparecer em diferentes rotinas:

UsoExemplo
Primeiro contato ativoOperador inicia conversa pelo WhatsApp.
Retomada fora da sessãoCliente ficou sem responder e a janela livre expirou.
Transmissão em massaCampanha por WhatsApp para uma lista revisada.
Fluxo do botNode envia modelo em etapa automatizada.
Automação de CRMRegra envia WhatsApp após evento de funil, tarefa ou lead.
Follow-up comercialRetorno de proposta, reunião ou oportunidade parada.
Pós-atendimentoPedido de avaliação ou confirmação de resolução.

Antes de usar em automações e transmissões, confirme se o modelo está APPROVED e se as variáveis podem ser preenchidas automaticamente.

Exemplos recomendados

Confirmação de atendimento

Olá, {{1}}. Seu atendimento sobre {{2}} foi registrado.
Se precisar complementar alguma informação, responda esta mensagem.

Use como UTILITY. Variáveis: nome do cliente e assunto/protocolo.

Retorno comercial

Olá, {{1}}. Aqui é {{2}} da Agilize.
Estou retomando nosso contato sobre {{3}}. Posso seguir com os próximos passos?

Use como MARKETING quando for ação comercial ativa. Variáveis: nome do cliente, responsável e assunto.

Lembrete de reunião

Olá, {{1}}. Passando para lembrar da nossa reunião em {{2}}.
Se precisar remarcar, responda esta mensagem.

Use como UTILITY. Variáveis: nome do cliente e data/horário.

Atualização de solicitação

Olá, {{1}}. Temos uma atualização sobre sua solicitação {{2}}.
Responda esta mensagem caso queira falar com nossa equipe.

Use como UTILITY. Variáveis: nome do cliente e protocolo/assunto.

Pedido de avaliação

Olá, {{1}}. Seu atendimento foi concluído.
Pode avaliar sua experiência pelo botão abaixo?

Use com botão de resposta rápida ou link quando houver pesquisa configurada.

Reativação de lead

Olá, {{1}}. Ainda posso te ajudar com {{2}}?
Se fizer sentido retomar, responda esta mensagem e seguimos daqui.

Use como MARKETING. Variáveis: nome do cliente e interesse/produto.

Erros comuns

SituaçãoO que verificar
Modelo não aparece para envioPerfil WhatsApp correto, status APPROVED, idioma, categoria e vínculo com o número usado.
Modelo foi rejeitadoMotivo do contato, clareza do texto, categoria, variáveis sem exemplo, mídia e políticas do canal.
Modelo ficou pendenteAguarde avaliação e evite recriar duplicado sem necessidade.
Variável chega em brancoFonte da variável, dado no cadastro, automação, transmissão ou preenchimento manual.
Modelo aprovado não serve para transmissãoConfirme se ele tem poucas variáveis, sem cabeçalho variável e se está elegível para uso em massa.
Cliente não entende a mensagemRevise contexto, motivo do contato e chamada de ação.
Operador usa modelo erradoMelhore nome/atalho, separe por finalidade e remova modelos antigos.

Governança recomendada

  • Tenha modelos por finalidade: atendimento, comercial, suporte, reunião, avaliação, reativação e aviso operacional.
  • Revise modelos antes de campanhas e automações.
  • Desative ou substitua modelos antigos que geram baixa resposta.
  • Evite duplicar modelos quase iguais.
  • Use nomes padronizados para facilitar busca.
  • Documente quem pode criar e aprovar novos modelos internamente.
  • Teste cada modelo em cenário controlado antes de colocar em cadência ou transmissão.

Próximos passos