EntrarComeçar teste grátis
Meta Tech Provider

Crie templates de WhatsApp com a sua IA e corrija as rejeições

Uma IA conectada ao seu número de WhatsApp Business pelo MCP pode redigir um template, enviá-lo à Meta com create_template e acompanhar a análise com get_template_status. Cada template precisa de uma categoria (utility, marketing ou authentication), de variáveis numeradas, como {{1}}, com um valor de exemplo para cada uma, e da aprovação da Meta, que pode levar até 24 horas. Um template rejeitado é corrigido e reenviado com um novo nome.

O easyCoexistence conecta o seu número de WhatsApp Business à Cloud API oficial da Meta pela Coexistência e dá à sua IA as ferramentas de template, list_templates, create_template, get_template_status e send_template, além de automações que enviam templates aprovados sozinhas.

24 hours

O prazo máximo que a Meta informa para uma decisão de aprovação de template.

30 days

Por quanto tempo o nome de um template aprovado excluído fica indisponível para um novo template.

512

Número máximo de caracteres no nome de um template, que aceita apenas letras minúsculas, números e sublinhados.

250

Templates por Conta do WhatsApp Business em um Portfólio de Negócios não verificado; os verificados, com nome de exibição aprovado, chegam a 6.000.

April 9, 2025

Desde esta data, um template enviado como utility que a Meta considera promocional é aprovado como marketing.

10 per 30 days

Edições permitidas em um template aprovado, com no máximo uma em qualquer período de 24 horas.

Como sua IA cria um template de WhatsApp?

Em poucas chamadas de ferramenta, depois que você descreve a mensagem com palavras simples. A IA verifica o que já existe com list_templates, para não duplicar um template aprovado. Em seguida, chama create_template com um nome em letras minúsculas, números e sublinhados, um código de idioma como en_US, pt_BR ou es_ES, uma categoria e os componentes: um cabeçalho opcional, o corpo, um rodapé opcional e botões. A Meta analisa o template enviado, e get_template_status informa APPROVED, PENDING ou REJECTED para cada idioma com esse nome. Depois de aprovado, ele é enviado por send_template ou pela etapa de envio de template de uma automação.

1You describe itPurpose, language, the customer's name, any code
2create_templateName, language, category, components with examples
3Meta reviewsUp to 24 hours, with the decision sent by webhook and email
4get_template_statusAPPROVED, PENDING or REJECTED
5send_templateOr the Send a template step of an automation

Como é a requisição de um template?

É o que uma IA envia depois de um pedido como: "Crie um template de marketing em inglês que cumprimente o cliente pelo primeiro nome e dê o código WELCOME10 com 10% de desconto no primeiro pedido." O corpo usa uma variável posicional, {{1}}, com um valor de exemplo para que o revisor veja uma mensagem real. Há texto depois da variável, porque a Meta rejeita um corpo que começa ou termina com uma, e o rodapé explica como parar de receber ofertas. O cupom fica no texto do corpo, onde uma automação também consegue enviá-lo.

create_template arguments for a welcome coupon
{
  "connection_id": "<from list_numbers>",
  "name": "welcome_coupon",
  "language": "en_US",
  "category": "MARKETING",
  "components": [
    {
      "type": "BODY",
      "text": "Hi {{1}}, welcome to Bloom Café! Use code WELCOME10 for 10% off your first order.",
      "example": { "body_text": [["Ana"]] }
    },
    { "type": "FOOTER", "text": "Reply STOP to stop offers" }
  ]
}

Qual categoria o template deve usar?

A que corresponde ao que a mensagem faz, porque a Meta confere se o conteúdo bate com a categoria. Desde 9 de abril de 2025, um template enviado como utility que tenha cara de promoção é aprovado como marketing, e a Meta também pode mudar depois a categoria de um template aprovado, com um webhook template_category_update e 60 dias para contestar no Business Support Home. Templates de marketing exigem um método de pagamento na sua Conta do WhatsApp Business antes de serem enviados, e a Meta cobra cada categoria com tarifas próprias, por país.

UTILITYFollows up on something the customer did or asked for: an order update, a booking confirmation, a delivery notice
MARKETINGAwareness, sales and retargeting: coupons, discounts, promo codes, offers, and any mix with a promotion
AUTHENTICATIONVerifies identity with a one-time code, in a strict fixed format

Como funcionam as variáveis e os exemplos?

As variáveis posicionais são numeradas a partir de 1 na ordem em que aparecem, {{1}}, {{2}}, e a Meta exige um valor de exemplo para cada uma na criação do template, como em "example": {"body_text": [["Ana"]]}. No envio, os valores entram na mesma ordem. Sua IA os preenche pelos components de send_template, que também aceitam mídia de cabeçalho e valores de botão, como o código de um botão de copiar código.

As automações ainda são mais limitadas: a etapa de envio de template preenche as variáveis do corpo por posição, por exemplo "params": ["{{first_name}}"], que coloca o primeiro nome do cliente em {{1}}. Templates com variáveis nomeadas, imagem ou variável no cabeçalho, ou botão com variável ainda não podem ser enviados por uma automação. Por isso, se uma automação vai enviar um cupom, coloque-o no corpo, e não em um botão de copiar código.

Por que a Meta rejeita templates?

A análise da Meta é em parte automática e em parte manual, e a documentação dela lista as causas mais comuns. A maioria pode ser identificada antes do envio, por isso vale pedir à IA que revise o rascunho com base nesta lista primeiro:

  • Formatação de variáveis: chaves ausentes ou desencontradas, caracteres especiais como #, $ ou % dentro de uma variável, números fora de sequência, ou um corpo que começa ou termina com uma variável.
  • Variáveis demais para o tamanho do texto ao redor delas.
  • Política: conteúdo que viola a Política do WhatsApp Business ou a Política de Comércio, conteúdo abusivo ou ameaçador, ou solicitação de identificadores sensíveis completos; identificadores parciais são permitidos.
  • Duplicação: texto do corpo e do rodapé igual ao de um template existente, verificação da qual os templates de autenticação estão isentos.
  • Categoria inadequada, rejeitada com o motivo INCORRECT_CATEGORY, ou texto acima do limite de tamanho de um componente.

Como corrigir uma rejeição com sua IA?

Comece pelo motivo informado pela Meta. Ele aparece no WhatsApp Manager, no e-mail que a Meta envia aos administradores do Business Suite e no webhook de status do template, enquanto get_template_status mostra apenas o status REJECTED. Cole o motivo no chat e peça à IA que reescreva o template seguindo a lista da Meta: acrescentar texto depois de uma variável que fecha a frase, incluir valores de exemplo, renumerar as variáveis ou tirar uma promoção de um template utility. Depois, peça que ela envie a versão corrigida com um novo nome, como welcome_coupon_v2, porque o mesmo nome no mesmo idioma é recusado como duplicado (erro 100, subcódigo 2388024).

O conector não edita nem exclui templates. Como alternativa, você pode editar o template rejeitado no WhatsApp Manager e reenviá-lo com amostras, o que também vale como contestação. Se você excluir um template aprovado, o nome dele não poderá ser reutilizado por 30 dias.

O app do WhatsApp Business pode enviar templates em um número com Coexistência?

Não. Em um número conectado pela Coexistência, a equipe continua conversando pelo app, mas os templates existem só no lado da API, então são enviados por send_template, pela etapa de envio de template de uma automação ou pelo seu próprio código. Por isso os templates são a forma de falar com alguém cuja última mensagem tem mais de 24 horas: a partir daí, a Meta só aceita templates pré-aprovados, e uma resposta digitada só funciona dentro da janela de atendimento. As mensagens de template são cobradas pela Meta na sua própria Conta do WhatsApp Business, por categoria e país, e o easyCoexistence nunca aplica margem sobre elas.

Erros comuns

  • Enviar um template logo depois de submetê-lo à análise. Até a Meta aprovar, o envio falha com o erro 132001, que indica um template inexistente naquele idioma ou não aprovado.
  • Terminar o corpo com a variável, como em "Seu código é {{1}}". A Meta rejeita um corpo que começa ou termina com uma variável, então acrescente uma frase de fechamento depois dela.
  • Colocar um cupom em um template utility. A Meta o aprova como marketing ou o rejeita e, nos dois casos, ele não será enviado como utility.
  • Usar um botão de copiar código para um cupom que uma automação vai enviar. As automações ainda não preenchem variáveis de botão, então coloque o código no texto do corpo.
Fazendo isso com o EasyCoexistence

O app continua no seu celular, e cada número é monitorado 24/7. De R$ 29,90 até R$ 3,90 por número por mês, caindo conforme você adiciona números, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Quantos templates uma conta do WhatsApp Business pode ter?

A Meta permite 250 por Conta do WhatsApp Business em um Portfólio de Negócios não verificado, e até 6.000 em um Portfólio de Negócios verificado com nome de exibição aprovado. Ela também limita a criação a 100 templates por conta por hora.

Posso editar um template aprovado?

Sim, no WhatsApp Manager ou pela API da Meta, até 10 vezes em 30 dias e uma vez a cada 24 horas. Uma edição pode alterar os componentes e o tempo de validade, mas não a categoria de um template aprovado, e volta para análise. O conector não edita templates, então sua IA envia uma nova versão.

Um template pode ter vários idiomas?

Não. O nome e o idioma juntos identificam um template, então cada tradução é um envio próprio com o mesmo nome, com análise própria. Peça à IA que envie as versões en_US, pt_BR e es_ES de uma vez; excluir um template pelo nome remove todos os idiomas dele.

Por que um template foi pausado depois de aprovado?

A aprovação não é permanente. A Meta pausa um template cuja classificação de qualidade cai para o nível mais baixo após feedback negativo ou baixo engajamento: por 3 horas na primeira vez, 6 horas na segunda e, na terceira, ele é desativado. list_templates retorna a pontuação de qualidade de cada template, então sua IA pode sinalizar uma queda antes que os envios comecem a falhar.

Continue lendo

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátis

Verificado em