Todas as ferramentas

Tools ZionTalk · Guia gratuito

Diretrizes de templates da API Oficial do WhatsApp

Entenda como preparar templates claros para notificações, campanhas e verificações. Consulte exemplos por finalidade e revise o conteúdo antes de cadastrar sua mensagem.

A aprovação é definida pela Meta.

O que é um template do WhatsApp?

É um modelo de mensagem submetido à análise da Meta para uso na WhatsApp Business Platform. Ele pode conter texto e os componentes permitidos para o seu formato. A mensagem deve ter objetivo claro e categoria compatível com o conteúdo.

Quando preciso usar um template?

Use um template aprovado quando precisar enviar uma mensagem fora da janela de atendimento. A janela é contada a partir da mensagem mais recente do cliente.

Dentro da janela, a empresa pode responder com mensagens livres, sem template. Essas respostas são as mensagens de serviço.

Janela de atendimento não é janela gratuita. Ela define quando a empresa pode responder sem template. A cobrança é outra decisão. Veja cobrança e franquia.

Estrutura de um template

CabeçalhoOpcional. Texto ou mídia, conforme o formato.
CorpoObrigatório. Texto principal, com variáveis quando necessário.
RodapéOpcional. Texto curto de apoio.
BotõesOpcionais. Respostas rápidas ou ações, como abrir um link.

Os limites de cada componente dependem do formato e da categoria. Confira a documentação de templates da Meta.

Comece pela finalidade da mensagem

Uma atualização de pedido, uma oferta e um código de verificação têm objetivos diferentes. Escolha a categoria pelo conteúdo e pelo contexto do envio. Acrescentar uma promoção a uma atualização transacional pode mudar a classificação da mensagem.

Utilidade

Sobre uma transação ou solicitação

Mensagem específica sobre algo que o cliente fez ou pediu. O conteúdo é funcional e informativo.

Exemplos
Confirmação de pedido, status de entrega, lembrete de agendamento, aviso de vencimento, comprovante.
Não é utilidade
Ofertas, cupons, upsell ou mensagens genéricas sem dados da transação.
Ver exemplo
Marketing

Promoção, oferta ou reengajamento

Mensagem com objetivo comercial ou promocional, para contatos que aceitaram receber esse tipo de conteúdo.

Exemplos
Lançamentos, promoções, carrinho abandonado, convites para eventos, programas de fidelidade.
Atenção
Os envios estão sujeitos a limites por destinatário, que a Meta descreve como adaptativos.
Ver exemplo
Autenticação

Verificação de identidade

Códigos de verificação para login, recuperação de conta ou confirmação de operação.

Formato
Segue a estrutura específica definida pela Meta para a categoria. Não é um texto livre.
Não use para
Promoções ou informações transacionais.
Ver orientação

Conteúdo misto. Uma confirmação de pedido com cupom de desconto tem promoção e precisa ser avaliada nessa condição, ainda que inclua dados de uma transação. Em utilidade, não misture informação transacional com oferta.

Recategorização. A Meta pode alterar a categoria de um template quando o conteúdo não corresponde à categoria escolhida. O efeito mais direto é na categoria aplicada e no custo. Escolha a categoria pelo objetivo, não pela tarifa.

E serviço? Serviço não é uma quarta categoria de template. Descreve as respostas sem template enviadas dentro da janela de atendimento.

Exemplos de templates por finalidade

Os exemplos ajudam na preparação e não garantem aprovação. Adapte o texto ao seu contexto e confira o formato aceito no cadastro. As prévias mostram dados fictícios para facilitar a leitura.

Convenção das variáveis. Os exemplos usam parâmetros posicionais como {{1}} e {{2}}. A prévia substitui os parâmetros pelos dados de exemplo; a cópia mantém os parâmetros do rascunho. Não misture parâmetros posicionais e nomeados no mesmo template.

Utilidade

Estes exemplos pressupõem uma compra, cobrança ou agendamento já existente. A relação com a ação do cliente deve ser real; a sugestão de utilidade não vale para uma mensagem enviada a qualquer pessoa.

Pedido confirmado

Utilidade

Rascunho

Olá, {{1}}. Recebemos o pedido {{2}}. Assim que houver uma atualização, avisaremos por aqui.

Dados de exemplo (fictícios)

{{1}} = Ana; {{2}} = 45821

Prévia

Olá, Ana. Recebemos o pedido 45821. Assim que houver uma atualização, avisaremos por aqui.

Contexto: Confirmação de uma compra realizada.

Orientação: Não acrescentar cupom, oferta ou recomendação comercial ao mesmo texto.

Pedido enviado

Utilidade

Rascunho

Olá, {{1}}. O pedido {{2}} foi enviado. A previsão de entrega é {{3}}.

Dados de exemplo (fictícios)

{{1}} = Carlos; {{2}} = 45821; {{3}} = 8 de outubro

Prévia

Olá, Carlos. O pedido 45821 foi enviado. A previsão de entrega é 8 de outubro.

Contexto: Atualização de uma compra em andamento.

Orientação: Usar uma previsão real e não prometer entrega garantida quando houver dependência de transporte.

Lembrete de agendamento

Utilidade

Rascunho

Olá, {{1}}. Lembramos que seu agendamento na {{2}} está marcado para {{3}}, às {{4}}. Se precisar de ajuda, responda esta mensagem.

Dados de exemplo (fictícios)

{{1}} = Marina; {{2}} = Oficina Exemplo; {{3}} = 5 de outubro; {{4}} = 14h

Prévia

Olá, Marina. Lembramos que seu agendamento na Oficina Exemplo está marcado para 5 de outubro, às 14h. Se precisar de ajuda, responda esta mensagem.

Contexto: Compromisso previamente marcado.

Orientação: Não usar este modelo para convidar pessoas sem agendamento.

Lembrete de vencimento

Utilidade

Rascunho

Olá, {{1}}. A cobrança {{2}}, referente a {{3}}, vence em {{4}}. Se o pagamento já foi realizado, desconsidere este aviso.

Dados de exemplo (fictícios)

{{1}} = Paula; {{2}} = 7821; {{3}} = assinatura de outubro; {{4}} = 10 de outubro

Prévia

Olá, Paula. A cobrança 7821, referente a assinatura de outubro, vence em 10 de outubro. Se o pagamento já foi realizado, desconsidere este aviso.

Contexto: Obrigação existente e identificável.

Orientação: Não incluir dados financeiros sensíveis; atualizar o status para evitar cobranças indevidas.

Marketing

Mensagens com objetivo comercial, para contatos que aceitaram receber esse tipo de comunicação.

Oferta de campanha

Marketing

Rascunho

Olá, {{1}}. A {{2}} preparou uma condição especial: {{3}}. A oferta é válida até {{4}}. Quer saber mais? Responda esta mensagem.

Dados de exemplo (fictícios)

{{1}} = Ana; {{2}} = Loja Exemplo; {{3}} = 10% de desconto na linha de organização; {{4}} = 7 de outubro

Prévia

Olá, Ana. A Loja Exemplo preparou uma condição especial: 10% de desconto na linha de organização. A oferta é válida até 7 de outubro. Quer saber mais? Responda esta mensagem.

Contexto: Campanha para contatos que aceitaram receber ofertas.

Orientação: Confirmar condições, prazo e público autorizado. Não apresentar como utilidade.

Convite para demonstração do ZionTalk

Marketing

Rascunho

Olá, {{1}}. Sua equipe precisa organizar melhor o atendimento no WhatsApp? Conheça o ZionTalk para centralizar conversas e acompanhar a operação. Quer agendar uma demonstração? Responda esta mensagem.

Dados de exemplo (fictícios)

{{1}} = Gabriel

Prévia

Olá, Gabriel. Sua equipe precisa organizar melhor o atendimento no WhatsApp? Conheça o ZionTalk para centralizar conversas e acompanhar a operação. Quer agendar uma demonstração? Responda esta mensagem.

Contexto: Divulgação comercial.

Orientação: Trata-se de divulgação comercial. Não usar a categoria utilidade apenas por mencionar atendimento ou suporte.

Retomada de carrinho

Marketing

Rascunho

Olá, {{1}}. Os itens que você selecionou na {{2}} continuam no seu carrinho. Quer retomar a compra? Responda esta mensagem para receber ajuda.

Dados de exemplo (fictícios)

{{1}} = Lucas; {{2}} = Loja Exemplo

Prévia

Olá, Lucas. Os itens que você selecionou na Loja Exemplo continuam no seu carrinho. Quer retomar a compra? Responda esta mensagem para receber ajuda.

Contexto: Estimular a conclusão de uma compra iniciada.

Orientação: Verificar consentimento e disponibilidade real dos itens; não prometer reserva se ela não existir.

Marketing

Como oferecer saída de comunicações comerciais

Só exiba essa instrução quando a operação realmente registrar e respeitar a solicitação. Não prometa descadastro automático sem um processo funcionando.

Complemento opcional

Se não quiser receber nossas novidades, responda SAIR.

Autenticação exige um fluxo próprio

Código de verificação

Autenticação

Templates de autenticação são usados para verificação de identidade. Prepare esse fluxo com os componentes e opções oficiais disponíveis no cadastro; não trate o código como uma campanha ou uma mensagem transacional genérica.

Prévia conceitual

123456 é seu código de verificação. Não compartilhe este código.

Esta prévia não é um corpo livre para copiar e cadastrar. Use a estrutura oficial vigente, sem inventar botões, prazo de validade ou campos incompatíveis.

Exemplos que precisam de correção

Mistura de atualização e promoção

Texto a revisar

Olá, Ana. Seu pedido foi enviado! Aproveite e use o cupom VOLTE10 para comprar novamente.

Problema: A mensagem mistura atualização do pedido com incentivo comercial. Não apresentá-la como utilidade pura.

Versão proposta

Olá, {{1}}. O pedido {{2}} foi enviado. A previsão de entrega é {{3}}.

Alternativa: preparar a oferta em outro template de marketing, com as condições de envio aplicáveis.

Mensagem genérica sem contexto

Texto a revisar

Olá, {{1}}. Temos uma atualização importante. Clique aqui.

Problema: Não identifica o assunto nem a relação com uma ação real.

Versão proposta

Olá, {{1}}. O agendamento {{2}} foi alterado para {{3}}, às {{4}}. Se precisar de ajuda, responda esta mensagem.

Usar somente quando essa alteração realmente ocorreu.

Categoria baseada no preço

Texto a revisar

Seu benefício está disponível: 20% de desconto em toda a loja.

Problema: Uma oferta não vira utilidade por ser chamada de benefício. Categoria sugerida: marketing.

Versão proposta

Olá, {{1}}. A {{2}} está com {{3}} até {{4}}. Quer conferir as condições? Responda esta mensagem.

Variáveis sem exemplos claros

Texto a revisar

Olá, {{1}}. {{2}} {{3}} {{4}}.

Problema: Quase toda a mensagem depende de variáveis e o propósito fica indefinido.

Versão proposta

Olá, {{1}}. O pedido {{2}} foi confirmado. A previsão de entrega é {{3}}.

Preservar uma frase fixa que explique o assunto e cadastrar exemplos compatíveis com cada campo.

Planeje o custo dos seus templates

Cada categoria tem sua tarifa. Simule o volume mensal da sua operação na calculadora do ZionTalk.

Simular custos

Revise o contexto antes de cadastrar

Confira se a mensagem está ligada a uma ação real do cliente, se as informações estão completas e se as variáveis têm exemplos coerentes. A aprovação do template não substitui a verificação de consentimento, elegibilidade e demais condições de envio.

Raio-x de um template de utilidade

1Olá, {{1}}. 2O pedido {{2}} foi enviado. 3A previsão de entrega é {{3}}. 4Consulte o acompanhamento pelo botão abaixo.

Acompanhar pedido

Dados de exemplo: {{1}} = Carlos; {{2}} = 45821; {{3}} = 8 de outubro.

  1. 1
    Saudação com variávelComeça com texto fixo e usa um exemplo realista para o nome.
  2. 2
    Ligação com uma ação realCita um pedido que o cliente fez. É isso que sustenta a categoria utilidade.
  3. 3
    Informação completaTraz o dado que o cliente precisa, sem promessa que a operação não pode cumprir.
  4. 4
    Próximo passo claroIndica o que fazer, sem cupom, oferta ou recomendação comercial.

Conteúdo

  • Finalidade clara desde a primeira frase
  • Nomes, datas e referências conferidos
  • Componentes aceitos no formato escolhido
  • Promoção misturada com atualização

Variáveis

  • Numeradas em sequência: {{1}}, {{2}}, {{3}}
  • Um exemplo fictício e coerente para cada uma
  • Frase fixa suficiente para explicar o assunto
  • Texto que começa ou termina com variável

Condições de envio

  • Contato aceitou receber esse tipo de mensagem
  • Opção de saída que a operação realmente processa
  • Cobrança da categoria considerada no planejamento
  • Produtos ou setores restritos sem checar a política

Tem promoção na mensagem? Revise a categoria sugerida. Veja os exemplos que precisam de correção.

Produtos e setores restritos: consulte a Política de Mensagens do WhatsApp Business.

Seu template foi rejeitado ou mudou de categoria?

Consulte o motivo no WhatsApp Manager e a regra aplicável antes de corrigir ou solicitar revisão.

Motivos comuns de rejeição
Motivo exibidoO que costuma indicar
TAG_CONTENT_MISMATCHO conteúdo não corresponde à categoria escolhida.
INVALID_FORMATProblema de formatação, como variável mal posicionada ou sem exemplo.
ABUSIVE_CONTENTConteúdo que viola políticas ou termos da Meta.
SCAMTemplate genérico demais, com pouco contexto ou só variáveis.

Os códigos e textos podem mudar. Considere sempre o motivo exibido na interface da Meta.

O que fazer

  1. Entenda o motivoLeia o motivo exibido no WhatsApp Manager e a política relacionada.
  2. Corrija o conteúdoAjuste categoria, formato ou texto conforme o motivo.
  3. Edite ou solicite revisãoUse a ação de edição ou de revisão disponível. Confira o prazo exibido na interface da Meta para o seu caso.

Erro 131049 em envios de marketing

Indica que a mensagem não foi entregue em função das regras de envio de marketing para aquele destinatário. A Meta descreve esses limites como adaptativos: não há uma cota fixa que garanta o próximo envio.

  • Consulte a razão de falha retornada pela API.
  • Controle novas tentativas e evite reenviar de forma insistente.
  • Revise a segmentação e a relevância da campanha.

Limites de marketing por destinatário na Meta

Qualidade depois da aprovação

Templates aprovados continuam sendo avaliados pela reação dos destinatários, como bloqueios e denúncias. Qualidade baixa pode levar a restrições do template ou do número.

  • Envie apenas para quem aceitou receber.
  • Personalize e evite mensagens genéricas.
  • Controle a frequência e ofereça uma saída real.
  • Acompanhe o status e a qualidade no WhatsApp Manager.

Organizar meus templates com a Zion

Conecte mensagens, atendimento e automações à rotina da equipe. Já é cliente? Consulte os manuais e artigos ou fale com o suporte.

Cobrança

Categoria e cobrança precisam ser consideradas juntas

Prepare o template e planeje o volume de mensagens da sua operação. O custo depende das regras e tarifas aplicáveis, e a categoria de um template não deve ser escolhida apenas pelo preço.

A franquia gratuita de mensagens de serviço não se aplica a templates de marketing, utilidade ou autenticação.

Perguntas frequentes

Respostas rápidas sobre aprovação, categorias e envio de templates.

Template aprovado garante entrega?

Não. Aprovação de conteúdo e entrega são etapas distintas; qualidade, limites e condições da conta podem interferir no envio.

Serviço é uma categoria de template?

Não. As categorias de template são marketing, utilidade e autenticação. Serviço descreve respostas sem template dentro da janela de atendimento.

Como saber o preço do meu template?

Confira a categoria vigente e use a calculadora de custos do ZionTalk. Não escolha a categoria apenas pelo menor valor.

O que fazer com o erro 131049?

Consulte o motivo de falha e as regras de marketing aplicáveis. Evite reenviar de forma insistente; os limites de marketing por destinatário são adaptativos e não existe uma cota fixa que garanta o próximo envio.

Quanto tempo demora a aprovação?

Acompanhe o status no WhatsApp Manager. O prazo pode variar e este guia não promete liberação em um tempo fixo.

O ZionTalk aprova os templates?

Não. A decisão é da Meta. A Zion pode orientar a organização do conteúdo e o uso da plataforma, dentro do serviço oferecido.

Outras ferramentas

Organize o atendimento que começa no WhatsApp

Conheça o ZionTalk para centralizar conversas, distribuir atendimentos e acompanhar a operação da sua equipe.

Conhecer o ZionTalk