# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-05-28T23:48:48.984Z ## Página - Título: Cadastro de modelos de mensagem WhatsApp - URL humana: https://agilize.app/docs/configuracao/canais-whatsapp-integracoes/cadastro-de-modelos-de-mensagem-whatsapp - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Como criar, revisar, aprovar e manter modelos de WhatsApp para retomadas, transmissões, fluxos, automações e follow-ups na Agilize. ## Seções - Quando usar modelos - Antes de começar - Campos do cadastro - Limites e comportamentos do editor - Escolha a categoria correta - Como aumentar a chance de aprovar como Utilidade - Escreva o nome do modelo - Monte o corpo da mensagem ## Conteúdo da página # 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. --- title: "Ciclo de vida do modelo" caption: "Um modelo nasce como configuração, passa por aprovação do canal e depois pode ser usado em operações controladas." definition: | flowchart LR A[Planejar finalidade] --> B[Cadastrar modelo] B --> C[Enviar para processamento] C --> D{Status do WhatsApp} D -->|Aprovado| E[Usar em atendimento, fluxo, automação ou transmissão] D -->|Rejeitado| F[Ajustar conteúdo ou criar nova versão] D -->|Pendente| G[Acompanhar status] E --> H[Revisar uso e qualidade periodicamente] --- ## 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é-requisito | Por que importa | | --- | --- | | Perfil WhatsApp conectado | O modelo precisa estar vinculado ao WhatsApp/Business correto. | | Número habilitado | O modelo só será útil se houver número disponível para envio. | | Permissão administrativa | O cadastro de modelos é uma configuração sensível. | | Finalidade definida | Modelos genéricos tendem a ser rejeitados ou usados fora de contexto. | | Variáveis planejadas | Toda variável precisa ter valor no momento do envio. | | Categoria correta | A categoria influencia aprovação, finalidade e uso permitido. | O caminho público para cadastro é [https://my.agilize.app/messenger/chat/messageTemplate](https://my.agilize.app/messenger/chat/messageTemplate). ## Campos do cadastro ![Tela de modelos de mensagem WhatsApp com listagem e ações de cadastro](/docs/screenshots/config-modelos-whatsapp.png) 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. ![Tela de cadastro de modelo de mensagem WhatsApp com campos de nome, perfil, idioma, categoria, cabeçalho, corpo, rodapé e botões](/docs/screenshots/config-modelos-whatsapp-cadastro.png) | Campo | Como preencher | | --- | --- | | Nome / Atalho | Use nome estável, descritivo, em letras minúsculas e com underline. Exemplo: `retorno_comercial_proposta`. | | Perfil WhatsApp | Selecione o perfil/número que será dono do modelo. | | Idioma | Escolha o idioma do conteúdo, como `pt_BR` para português do Brasil. | | Categoria | Escolha `MARKETING`, `UTILITY` ou `AUTHENTICATION`, conforme a finalidade. | | Cabeçalho | Opcional. Pode ser texto, imagem, vídeo, documento ou nenhum cabeçalho. | | Corpo da mensagem | Conteúdo principal. Deve explicar o motivo do contato e pode usar variáveis. | | Rodapé | Opcional. Use para informação curta de apoio. | | Botões | Opcional. 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 modelo | Limite ou comportamento | | --- | --- | | Nome / Atalho | Aceita letras minúsculas e underline. O nome é normalizado para o padrão exigido na integração. | | Idioma | O cadastro permite `pt_BR` e `en`. Use `pt_BR` para modelos em português do Brasil. | | Corpo | Até 1024 caracteres. Pode usar variáveis numéricas como `{{1}}`, `{{2}}` e `{{3}}`. | | Cabeçalho de texto | Até 60 caracteres e no máximo uma variável. | | Cabeçalho de imagem | Arquivo `jpg`, `jpeg` ou `png`, até 5 MB no upload do editor. | | Cabeçalho de vídeo | Arquivo `mp4`, até 15 MB no upload do editor. | | Cabeçalho de documento | Arquivo `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ápida | Até 3 botões. | | Botões de chamada para ação | Até 2 botões, podendo ser link URL ou telefone. | | Botão de pagamento | Até 1 botão, quando o cenário de cobrança estiver preparado. | | Autenticação | Usa 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 | Categoria | Quando usar | Exemplos | | --- | --- | --- | | `MARKETING` | Relacionamento comercial, campanhas, reativação, convite e comunicação promocional ou de nutrição. | Reativar lead, apresentar condição comercial, convidar para ação. | | `UTILITY` | Comunicação transacional, operacional ou de acompanhamento de uma solicitação existente. | Confirmar atendimento, lembrar reunião, atualizar protocolo, avisar andamento. | | `AUTHENTICATION` | Autenticaçã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](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/). ## 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ática | Por 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: ```text 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: ```text 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ão | Evite | | --- | --- | | `confirmacao_atendimento` | `teste` | | `retorno_comercial_proposta` | `mensagem_1` | | `lembrete_reuniao_agendada` | `novo_modelo` | | `avaliacao_pos_atendimento` | `cliente_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: ```text 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ável | Exemplo de valor | | --- | --- | | `{{1}}` | Nome do cliente | | `{{2}}` | Assunto, protocolo, produto ou solicitação | Evite textos vagos como: ```text 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: | Fonte | Uso recomendado | | --- | --- | | Nome do cliente | Saudação personalizada. | | Telefone | Confirmações específicas quando necessário. | | Nome do colaborador | Assinatura ou referência do responsável. | | Valor manual | Assunto, 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çalho | Quando usar | Atenção | | --- | --- | --- | | Nenhum | Mensagens simples e objetivas. | É a opção mais segura para modelos recorrentes. | | Texto | Reforçar o assunto da mensagem. | O texto é curto e aceita no máximo uma variável. | | Imagem | Enviar referência visual aprovada. | Use arquivo leve e diretamente relacionado ao conteúdo. | | Vídeo | Explicar algo visualmente quando necessário. | Use com parcimônia; arquivos grandes dificultam aprovação e envio. | | Documento | Enviar 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ão | Quando usar | Limite prático | | --- | --- | --- | | Resposta rápida | Quando o cliente deve escolher uma resposta simples. | Até 3 botões. | | Link URL | Quando a ação leva para página externa, agenda, formulário ou pagamento. | Até 2 botões de chamada para ação. | | Telefone | Quando o cliente deve ligar para um número. | Até 2 botões de chamada para ação. | | Pagamento | Quando 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: | Status | Significado prático | | --- | --- | | `PROCESSING` | A Agilize está processando o modelo para envio ao canal. | | `PENDING` | O modelo foi enviado e aguarda avaliação. | | `APPROVED` | O modelo pode ser usado nos cenários permitidos. | | `REJECTED` | O 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: | Uso | Exemplo | | --- | --- | | Primeiro contato ativo | Operador inicia conversa pelo WhatsApp. | | Retomada fora da sessão | Cliente ficou sem responder e a janela livre expirou. | | Transmissão em massa | Campanha por WhatsApp para uma lista revisada. | | Fluxo do bot | Node envia modelo em etapa automatizada. | | Automação de CRM | Regra envia WhatsApp após evento de funil, tarefa ou lead. | | Follow-up comercial | Retorno de proposta, reunião ou oportunidade parada. | | Pós-atendimento | Pedido 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 ```text 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 ```text 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 ```text 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 ```text 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 ```text 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 ```text 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ção | O que verificar | | --- | --- | | Modelo não aparece para envio | Perfil WhatsApp correto, status `APPROVED`, idioma, categoria e vínculo com o número usado. | | Modelo foi rejeitado | Motivo do contato, clareza do texto, categoria, variáveis sem exemplo, mídia e políticas do canal. | | Modelo ficou pendente | Aguarde avaliação e evite recriar duplicado sem necessidade. | | Variável chega em branco | Fonte da variável, dado no cadastro, automação, transmissão ou preenchimento manual. | | Modelo aprovado não serve para transmissão | Confirme 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 mensagem | Revise contexto, motivo do contato e chamada de ação. | | Operador usa modelo errado | Melhore 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 - Entenda a [Sessão de 24 horas no WhatsApp](/docs/usuarios/flow-e-atendimento/sessao-de-24-horas-no-whatsapp). - Revise [Canais e integrações](/docs/configuracao/canais-whatsapp-integracoes/canais-e-integracoes) para confirmar se o WhatsApp está configurado. - Use [Transmissão em massa por WhatsApp e Voz](/docs/usuarios/transmissoes-e-telefonia/transmissao-em-massa-por-whatsapp-e-voz) quando o modelo for usado em disparos. - Consulte [Guia geral de fluxos do bot](/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot) para uso em fluxos. - Consulte [Automações de CRM](/docs/configuracao/fluxos-automacoes/automacoes-de-crm) para uso em cadências e regras.