Crie templates do WhatsApp com a sua IA e corrija as rejeições
Uma IA ligada ao seu número do WhatsApp Business através de MCP pode redigir um template, submetê-lo à Meta com create_template e acompanhar a revisão 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 demorar até 24 horas. Um template rejeitado é corrigido e submetido de novo com um nome novo.
A easyCoexistence liga o seu número do WhatsApp Business à Cloud API oficial da Meta através da Coexistence e dá à sua IA as ferramentas de templates: list_templates, create_template, get_template_status e send_template, além de automações que enviam templates aprovados sozinhas.
O prazo mais longo que a Meta indica para uma decisão de aprovação de um template.
Durante quanto tempo o nome de um template aprovado eliminado fica inutilizável para um novo template.
Número máximo de caracteres de um nome de template, que só aceita letras minúsculas, algarismos e sublinhados.
Templates por Conta do WhatsApp Business num portefólio empresarial não verificado; os verificados com um nome de apresentação aprovado podem ter até 6.000.
A partir desta data, um template submetido como utility que a Meta considere promocional é aprovado como marketing.
Edições permitidas num template aprovado, com no máximo uma em cada 24 horas.
Como é que a sua IA cria um template do WhatsApp?
Em poucas chamadas de ferramentas, depois de descrever a mensagem em palavras simples. A IA verifica o que já existe com list_templates, para não duplicar um template aprovado. Depois chama create_template com um nome em letras minúsculas, algarismos 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 revê a submissão, e get_template_status indica APPROVED, PENDING ou REJECTED para cada idioma sob esse nome. Uma vez aprovado, send_template envia-o, ou o passo Enviar um template de uma automação.
Como é um pedido de template?
É isto que uma IA submete 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 para 10% de desconto na primeira encomenda." O corpo usa uma variável posicional, {{1}}, com um valor de exemplo para que o revisor veja uma mensagem real. O texto segue a variável, porque a Meta rejeita um corpo que começa ou termina com uma, e o rodapé indica como as pessoas podem deixar de receber ofertas. O cupão fica no texto do corpo, onde uma automação também o pode enviar.
{
"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" }
]
}Que categoria deve usar o template?
A que corresponde ao que a mensagem faz, porque a Meta verifica o conteúdo contra a categoria. Desde 9 de abril de 2025, uma submissão utility que pareça promocional é aprovada como marketing. A Meta pode também alterar mais tarde a categoria de um template aprovado, com um webhook template_category_update e 60 dias para recorrer no Business Support Home. Os templates de marketing precisam de um método de pagamento na sua Conta do WhatsApp Business antes de poderem ser enviados, e a Meta cobra cada categoria à sua própria tarifa, consoante o país.
Como funcionam as variáveis e os exemplos?
As variáveis posicionais são numeradas a partir de 1, pela ordem em que aparecem, {{1}}, {{2}}, e a Meta exige um valor de exemplo para cada uma quando o template é criado, como em "example": {"body_text": [["Ana"]]}. No momento do envio, os valores seguem a mesma ordem. A sua IA preenche-os através do parâmetro components de send_template, que também podem incluir conteúdo multimédia de cabeçalho e valores de botões, como o código de um botão de copiar código.
As automações são, por agora, mais limitadas: o passo Enviar um template preenche as variáveis do corpo por posição, por exemplo "params": ["{{first_name}}"], que coloca o primeiro nome do cliente em {{1}}. Os templates com variáveis com nome, uma imagem de cabeçalho ou variável, ou um botão com uma variável ainda não podem ser enviados por uma automação. Por isso, coloque um cupão que uma automação vai enviar no corpo, e não num botão de copiar código.
Porque é que a Meta rejeita templates?
A revisão da Meta é em parte automática e em parte manual, e a sua documentação lista as causas mais comuns. A maioria pode ser vista antes da submissão, por isso compensa pedir à IA que verifique primeiro o rascunho contra esta lista:
- Formatação das variáveis: chavetas em falta ou não correspondentes, 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.
- Demasiadas variáveis para o tamanho do texto à volta 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 um pedido de identificadores sensíveis completos; os identificadores parciais são permitidos.
- Duplicação: texto do corpo e do rodapé igual ao de um template existente, uma verificação a que os templates de autenticação estão isentos.
- Uma categoria que não se adequa, rejeitada com o motivo
INCORRECT_CATEGORY, ou um texto que ultrapassa o limite de tamanho de um componente.
Como corrige uma rejeição com a sua IA?
Comece pelo motivo da Meta. Ele aparece no WhatsApp Manager, no e-mail que a Meta envia aos administradores do Business Suite e no webhook de estado do template, enquanto get_template_status mostra o próprio estado REJECTED. Cole o motivo no chat e peça à IA que reescreva o template segundo a lista da Meta: acrescentar texto depois de uma variável final, acrescentar valores de exemplo, renumerar as variáveis ou tirar uma promoção de um template utility. Depois, peça que submeta a versão corrigida com um nome novo, 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 elimina templates. Pode, em alternativa, editar o template rejeitado no WhatsApp Manager e submetê-lo de novo com amostras, o que também funciona como recurso. Se eliminar um template aprovado, o seu nome não pode ser usado de novo durante 30 dias.
A app do WhatsApp Business pode enviar templates num número Coexistence?
Não. Num número ligado através da Coexistence, a equipa continua a conversar a partir da app, mas os templates existem apenas do lado da API. Por isso, são enviados por send_template, por um passo Enviar um template de uma automação ou pelo seu próprio código. É assim que os templates servem para contactar alguém cuja última mensagem tem mais de 24 horas: a partir daí, a Meta aceita apenas templates pré-aprovados, enquanto uma resposta escrita só funciona dentro da janela. As mensagens de template são cobradas pela Meta à sua própria Conta do WhatsApp Business, por categoria e país, e a easyCoexistence nunca aplica qualquer margem sobre elas.
Erros comuns
- Enviar um template logo após submetê-lo. Até a Meta o aprovar, o envio falha com o erro 132001, o erro de um template que não existe nesse idioma ou não está aprovado.
- Terminar o corpo com a variável, como em "O seu código é {{1}}". A Meta rejeita um corpo que começa ou termina com uma variável, por isso acrescente uma frase final depois dela.
- Pôr um cupão num template utility. A Meta aprova-o como marketing ou rejeita-o, e em qualquer dos casos não será enviado como utility.
- Usar um botão de copiar código para um cupão que uma automação vai enviar. As automações ainda não conseguem preencher variáveis de botões, por isso coloque o código no texto do corpo.
A app fica no seu telemóvel, e cada número é monitorizado 24/7. De US$ 9 a US$ 0.75 por número e por mês, descendo à medida que acrescenta números, com os primeiros 3 dias grátis.
Perguntas frequentes
Quantos templates pode ter uma conta?
A Meta permite 250 por Conta do WhatsApp Business num portefólio empresarial não verificado, e até 6.000 num portefólio verificado com um nome de apresentação aprovado. Também limita a criação a 100 templates por conta e por hora.
Posso editar um template aprovado?
Sim, no WhatsApp Manager ou através da API da Meta, até 10 vezes em 30 dias e uma vez em cada 24 horas. Uma edição pode alterar os componentes e o tempo de vida, mas não a categoria de um template aprovado, e volta a passar pela revisão. O conector não edita, por isso a sua IA submete uma nova versão em vez disso.
Um template pode abranger vários idiomas?
Não. Um nome e um idioma juntos identificam um template, por isso cada tradução é uma submissão própria sob o mesmo nome, com a sua própria revisão. Peça à IA que submeta as versões en_US, pt_BR e es_ES de uma só vez; eliminar um template pelo nome remove todos os seus idiomas.
Porque é que um template foi pausado depois de aprovado?
A aprovação não é permanente. A Meta pausa um template cuja classificação de qualidade desce para o nível mais baixo após feedback negativo ou pouco envolvimento: durante 3 horas na primeira vez, 6 horas na segunda, e à terceira é desativado. list_templates devolve a pontuação de qualidade de cada template, para que a sua IA possa sinalizar uma descida antes de os envios começarem a falhar.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em