Categoria de template no WhatsApp: por que o seu utility virou marketing

A categoria decide preço, limite e rota

A página Template categorization da documentação da Cloud API abre dizendo que as categorias existem para fins de preço, e é verdade: desde julho de 2025 a Meta cobra por mensagem entregue, e o valor depende da categoria e do país de quem recebe. Marketing, utility e authentication têm preços diferentes, e as faixas de desconto por volume só existem para utility e authentication. Trocar a categoria de um template é trocar o preço de cada mensagem que ele manda.

Mas a categoria decide mais do que o preço. O limite de marketing por usuário, que devolve o erro 131049 quando uma pessoa já recebeu marketing demais de todas as empresas, vale só para marketing. A restrição que impede a entrega de marketing para números dos Estados Unidos também. Um template de aviso de entrega que vira marketing passa a disputar vaga na caixa de entrada com as promoções de todo mundo — e para de chegar a clientes com número americano.

E, a partir de 2027, a categoria decide a rota. Em 13 de outubro de 2026 a Meta anunciou na página Overview da Marketing Messages API que a Cloud API vai deixar de aceitar marketing: contas de mensagens criadas a partir de 13 de abril de 2027 já não mandam marketing por ela, e em 13 de outubro de 2027 o envio de marketing pela Cloud API passa a dar erro. A mesma página pede para conferir o tráfego reclassificado, porque utility recategorizado como marketing precisa sair pela API nova.

O preço também mudou de forma em outubro de 2026. Entre julho de 2025 e setembro de 2026, utility enviado com a janela de atendimento aberta era grátis; desde 1º de outubro de 2026 ele voltou a ser cobrado, segundo a página Pricing. Marketing nunca foi grátis dentro da janela. A conta de uma recategorização, portanto, ficou mais simples de fazer e mais fácil de errar: é a diferença entre o preço de utility e o de marketing, em toda mensagem, com a janela aberta ou fechada.

O que faz um template ser utility

A definição da Meta tem duas condições, e as duas precisam valer ao mesmo tempo. A primeira é não ser promocional: nada de intenção de vender, persuadir ou estimular uma compra. A segunda é ser específico do usuário ou pedido por ele — ligado a um pedido, uma conta, um serviço ou uma transação dele — ou, no lugar disso, ser essencial ou crítico para ele, como um alerta de segurança. Faltando qualquer uma das duas, não é utility.

A página lista cinco objetivos que cabem em utility. Gestão de opt-in: confirmar a inscrição feita em outro canal ou o pedido para sair. Gestão de pedido: confirmar, atualizar ou cancelar, com dados do pedido no corpo — número, rastreio, reembolso processado. Alertas e atualizações de conta sobre o que o cliente já comprou ou assina. Pesquisa de satisfação sobre uma compra ou um atendimento específico. E continuar no WhatsApp uma conversa que começou em outro canal, desde que o cliente tenha pedido.

Os exemplos que a Meta dá ajudam a calibrar o limite. É utility o aviso de que a cobrança mensal vai cair no cartão salvo, o saldo diário da conta e até um aviso de que restam poucos minutos no plano, com a data para recarregar. O pedido para recarregar não torna o template promocional, porque ele se refere a um serviço que o cliente já tem e precisa saber. A palavra que pesa é desconto: a mesma assinatura vencendo, com uma oferta para renovar, já é marketing.

Há também os casos essenciais, que não dependem de pedido do cliente mas precisam continuar não promocionais: segurança pública, como alerta de clima severo; serviço público, como campanhas de saúde e prazo de alistamento eleitoral; interrupções, como uma queda de sistema; proteção da conta ou do produto, como alerta de fraude e recall; e obrigações legais, como mudança de política de privacidade. É uma lista curta de propósito.

O que é marketing mesmo quando não parece

Marketing é a categoria mais flexível, e a Meta põe nela tudo o que não cabe com clareza nas outras duas. Duas regras de bolso vêm direto da documentação. Conteúdo misto é marketing: uma atualização de pedido com uma promoção, ou uma pesquisa de satisfação com oferta, deixa de ser utility pela parte promocional. E conteúdo pouco claro é marketing: um template cujo corpo é só {{1}}, ou só “Parabéns!”, não dá à Meta como saber o que vai ser enviado, e ela decide pelo lado mais amplo.

A terceira regra surpreende mais: retargeting é marketing mesmo quando o cliente pediu. Os exemplos da página são os que mais quebram expectativa. Carrinho abandonado é marketing. Assinatura vencendo com desconto para renovar é marketing. Pedido de empréstimo pendente com um convite para entrar e continuar é marketing. Carro encontrado na busca salva pelo cliente é marketing. Parabéns de aniversário e agradecimento pela compra com um percentual de desconto também.

O exemplo mais contraintuitivo é o pedido de desculpas: avisar que a entrega atrasou e que, por isso, um crédito foi depositado na conta do cliente é marketing para a Meta. A lógica é a mesma de antes — o crédito é um estímulo para a próxima compra, e o aviso deixou de ser só um aviso. A apresentação de um assistente virtual novo também entra como marketing, porque divulga um serviço em vez de responder a uma ação do cliente.

No Brasil, a régua se aplica a templates muito comuns. O boleto gerado, com valor e vencimento, é utility; o mesmo boleto com “pague hoje e ganhe 5% de desconto” é marketing. A confirmação de agendamento é utility; o lembrete de que faz seis meses desde a última consulta, convidando a marcar outra, tende a ser marketing. A própria Meta avisa que os exemplos são ilustrativos e que um texto parecido pode cair em outra categoria conforme o conteúdo exato — mas a direção é sempre a mesma: quando há dúvida, a balança pende para marketing.

Authentication, a categoria mais estreita

Authentication serve para uma coisa só: verificar a identidade de alguém com um código de uso único. É também a única categoria que pode mandar esse código — um OTP em template de utility ou de marketing está fora das regras. As exigências são rígidas: usar os templates de autenticação da biblioteca da Meta, configurar um botão de código (copiar o código ou preenchimento com um toque), não usar URL, mídia nem emoji, e limitar os parâmetros a 15 caracteres.

O caminho de recategorização aqui é diferente, e mais duro. Quando a Meta conclui que um template de marketing ou de utility deveria ser de authentication, ela avisa com antecedência, mas não muda a categoria: no primeiro dia do mês seguinte, o template passa a REJECTED e para de enviar. A partir daí, o envio com ele falha como o de qualquer template que não está aprovado.

A saída que a Meta recomenda é migrar antes do prazo para um template de autenticação da biblioteca, e não recorrer: templates marcados para rejeição por deveriam ser authentication não entram no processo de revisão. Para quem manda código de verificação em template de utility por hábito antigo, o aviso é o momento de trocar — depois do dia 1º, o código simplesmente não chega.

Na criação: o utility que volta aprovado como marketing

Quando você cria um template, informa a categoria, e a Meta confere pelo conteúdo. Até abril de 2025, a discordância podia terminar em rejeição. Desde 9 de abril de 2025, um template enviado como UTILITY que a Meta considera marketing é aprovado como MARKETING, sem rejeição — e o parâmetro allow_category_change, que por anos autorizou ou não essa troca, foi aposentado na mesma data. Guias antigos ainda o recomendam como proteção. Ele não protege mais nada.

A consequência é que “aprovado” deixou de responder à pergunta que importa. A categoria com que o template foi aprovado vem na resposta da criação e no webhook message_template_status_update, e é ela que precisa ser gravada — não a que o formulário pediu. A rejeição por categoria ainda existe, com o motivo INCORRECT_CATEGORY, mas o caso mais comum agora é o silencioso: aprovado, só que em outra categoria.

Duas regras da página Utility templates completam o quadro. Criar ou editar um utility com material de marketing faz a Meta recategorizá-lo automaticamente como marketing — editar um template aprovado para acrescentar uma oferta é o caminho mais curto para perder a categoria. E os templates da biblioteca da Meta já vêm categorizados como utility ou authentication; personalizar um deles faz o template passar por revisão de novo.

Em produção: aprovado não é definitivo

A categoria também muda depois da aprovação. Desde julho de 2024 a Meta roda um processo recorrente que procura templates aprovados que deveriam estar em outra categoria. Na versão de setembro de 2026 da página Template categorization, o alcance desse processo cresceu: ele vale para qualquer template aprovado que não cumpra as diretrizes, seja porque foi aprovado fora delas, seja “because the messages the template sends do not meet them” — e isso inclui templates cuja categoria já tinha sido confirmada numa revisão.

A nossa leitura dessa mudança, que é inferência e não está escrita assim na documentação: o que vai nas variáveis passou a contar. Um template de utility aprovado com o corpo “Seu pedido {{1}} foi atualizado: {{2}}” pode ser impecável no texto e virar marketing pelo que a integração preenche em {{2}} todos os dias. A revisão aprovou o molde; a recategorização em produção olha o que saiu dele.

Quando a Meta conclui que um utility deveria ser marketing, ela avisa com um dia de antecedência, e no prazo a categoria passa a MARKETING. O status continua APPROVED, e o template continua enviando — é isso que torna a mudança perigosa. Nada falha, nenhum envio é recusado, e cada mensagem a partir daquele momento custa como marketing e segue as regras de marketing. Para quem já recebeu advertência por uso indevido, nem o aviso existe: desde 16 de abril de 2025, a mudança é instantânea, e e-mail e webhook só a confirmam.

O aviso chega por vários caminhos: e-mail para quem tem controle total da conta, um ícone na lista de templates com a categoria de destino e a data, um banner com CSV no Gerenciador do WhatsApp, a lista na Central de Suporte da empresa e o webhook template_category_update. Desses, só o último entra no seu sistema sem ninguém precisar abrir nada. Vimos isso acontecer na nossa operação: um template de utility foi reclassificado como marketing pela Meta, e a lição ficou no código — a categoria guardada no banco é uma cópia, e uma cópia velha faz a estimativa de custo de uma campanha mentir.

O webhook que avisa, e a armadilha do nome do campo

O template_category_update dispara em dois momentos: quando a categoria de um template vai ser mudada pelo processo automático, e quando ela foi mudada, manualmente ou pelo processo. Os dois eventos trazem message_template_id, message_template_name e message_template_language. O que muda entre eles são os campos de categoria — e é aí que mora a armadilha.

No aviso prévio, a referência do webhook traz três campos: correct_category, que é a categoria que o template vai ter em 24 horas; category_update_timestamp, o instante agendado da mudança, em segundos Unix; e new_category, que, apesar do nome, é a categoria atual. Na mudança concluída, os campos são previous_category e new_category, e aí sim new_category é a nova. Quem lê new_category nos dois eventos como “a categoria daqui para a frente” perde o aviso inteiro — e só descobre a troca quando ela já aconteceu.

O tratamento certo separa os dois casos pela presença dos campos. Com correct_category e category_update_timestamp, é aviso: registre a mudança agendada, avise quem é dono do template e use as 24 horas para decidir entre ajustar o texto, aceitar a nova categoria ou se preparar para recorrer. Com previous_category, é fato consumado: atualize a categoria guardada e recalcule o que depende dela — estimativas de custo, regras de limite, a rota de envio.

Para quem não quer depender só do webhook, a API permite conferir: um GET em message_templates com fields=category,correct_category mostra, para cada template, a categoria atual e a categoria para onde ele vai, quando houver mudança marcada. E, para cada mensagem, o webhook de status traz pricing.category — a categoria em que aquela mensagem foi efetivamente classificada. É a fonte que vale para conferir uma cobrança, porque é a que a Meta usou.

Revisão, punição e o 131064

Dá para pedir revisão de uma recategorização, mas só pelo painel. O caminho é o Gerenciador do WhatsApp: na lista de templates, o banner leva à Central de Suporte da empresa, na área de atualizações de categoria, onde se seleciona o template e se pede a revisão. Não existe endpoint de API para isso. O prazo é de 60 dias a partir da mudança de categoria, e a documentação não promete prazo de resposta. O resultado aparece em abas: em análise, mantida ou revertida — e, se revertida, o template volta à categoria anterior.

A reversão não é imunidade. Desde a atualização de setembro de 2026, a Meta pode agir de novo sobre um template já confirmado numa revisão, se as mensagens enviadas depois não cumprirem as diretrizes. E quem classifica marketing como utility de forma recorrente entra numa escada de restrições descrita na mesma página: advertência; limite de volume de utility numa janela móvel de 24 horas, com o excedente rejeitado, por no mínimo sete dias; restrição de utility, em que todos os utility aprovados da conta viram marketing e criar utility fica bloqueado por sete dias, ou 30 na reincidência; e, por fim, a mesma restrição em todas as contas do portfólio, por 30 dias.

Cada degrau chega pelo webhook account_update, com o evento ACCOUNT_RESTRICTION, um violation_type como UTILITY_TEMPLATE_ABUSE ou UTILITY_TEMPLATE_ABUSE_RATE_LIMIT e, quando há restrição ativa, um restriction_info com o tipo e a data em que ela expira. Esse webhook merece alerta com dono: é o único aviso de que a conta inteira passou a ser tratada como suspeita.

O erro que acompanha o limite é o 131064, que a página Error codes descreve como limite de mensagens atingido por violações de classificação de template, valendo para templates e para o Direct Send. A solução indicada é revisar as categorias; a restrição sai sozinha no fim do período de punição. Uma confusão comum, repetida por alguns fornecedores, é que o 131064 trava todo envio. Pela escada da documentação, o limite atinge o volume de utility — marketing e authentication continuam saindo. O que trava é justamente a mensagem que deveria ser a mais importante: o aviso transacional.

Como escrever um utility que continua utility

A regra que resolve a maior parte dos casos é separar. Um template para o aviso, outro para a oferta. O aviso de pedido despachado leva o número do pedido, o rastreio e mais nada; o cupom para a próxima compra vai num template de marketing, mandado para quem aceitou receber marketing. Juntar os dois para economizar uma mensagem custa mais caro do que mandar as duas, porque a mensagem junta é inteira marketing.

Depois, ancorar o corpo na transação. Utility é específico, e a especificidade aparece no texto: número do pedido, data do agendamento, valor da fatura, últimos dígitos do cartão. Um corpo genérico, com uma variável só, é exatamente o que a Meta chama de conteúdo pouco claro. E, desde que a recategorização passou a olhar as mensagens enviadas, a disciplina vale para o que a integração põe nas variáveis, não só para o modelo aprovado.

Cuidado também com o vocabulário. Desconto, cupom, aproveite, novidade, oferta por tempo limitado e convites para conhecer outro produto empurram o template para marketing, mesmo dentro de um aviso legítimo. Pesquisa de satisfação precisa citar a compra ou o atendimento de que trata; a genérica, sobre a experiência com a marca, não passa como utility. E o convite para continuar a conversa no WhatsApp só é utility quando o cliente pediu para mudar de canal.

Por fim, trate a categoria como dado vivo. Grave a categoria que a Meta aprovou, não a que você pediu; assine template_category_update, message_template_status_update e account_update; leia correct_category como aviso e previous_category como fato; e confira pricing.category quando a conta não fechar. Com o fim do marketing na Cloud API marcado para 2027, saber a categoria atual de cada template deixa de ser detalhe de cobrança e passa a decidir por onde a mensagem sai.