Nó Meta Templates

O nó Meta Templates (whatsapp_meta_templates) gerencia templates de mensagem WhatsApp Business API (HSM) em uma instância conectada: listar templates com filtros opcionais ou excluir um template por nome ou hsm_id da Meta.

Encontre-o na paleta WhatsWave em Automações.

Figura 1: Meta Templates — list com filtro de status

O que faz

Respostas de listagem normalmente aninham o array de templates em data.data.data. Delete é irreversível; sucesso costuma estar em data.data.

Operação: List templates (meta_templates_list)

Endpoint: GET /instances/message/templates

Opções de filtro de status (template_status):

Operação: Delete template (meta_templates_delete)

Endpoint: POST /instances/message/templates/delete

Forneça pelo menos um de name ou hsm_id.

Dicas e boas práticas

• Liste templates APPROVED antes de configurar Send → Template — copie template_name e language exatos.
• Use name_prefix em workflows de auditoria que verificam convenções de nomenclatura (promo_, utility_).
• Nunca delete em fluxos de produção sem confirmação — exclusão não pode ser desfeita; recrie templates no Meta Business Manager se precisar de novo.
• Parse a saída da listagem com cuidado — o caminho do array é data.data.data; registre em execução de teste primeiro.
• Combine com Condition — só envie template X se a listagem contiver entrada APPROVED com esse nome.

Exemplos de uso

Exemplo 1 — Seletor dinâmico de template para nó Send

Trigger: Manual — testes de ops.

Fluxo:

1. Meta Templates — List, template_status: APPROVED
2. JavaScript — escolhe o primeiro nome de template do array aninhado
3. Send — Template com template_name da saída do script

Exemplo 2 — Limpeza de templates promo obsoletos

Trigger: Schedule — mensal.

Fluxo:

1. Meta Templates — List, name_prefix: promo_old_
2. Loop — por template → Condition se status REJECTED → Delete com hsm_id

Exemplo 3 — Verificar antes de campanha outbound

Trigger: Webhook — início de campanha.

Fluxo:

1. Meta Templates — List, name_prefix: {{trigger.body.template_prefix}}
2. Condition — se contagem aprovada > 0 → enfileira Message queue com templates; Senão → alerta ops

FAQ

Posso criar templates neste nó?

Não — criação ocorre no Meta Business Manager ou na UI de templates WhatsWave. Este nó só lista e exclui.

Por que meu template Send falha mas aparece aqui?

Verifique código de idioma (pt_BR vs en_US) e se o JSON de components corresponde à estrutura do template.

A exclusão é imediata no lado da Meta?

Sim — irreversível. Templates aprovados usados em campanhas ativas deixarão de funcionar.

Qual campo de instância — telefone ou ID?

Meta Templates usa telefone da instância (phone_number), não UUID.

Artigos relacionados

• Nó Send — operação Template
• Nó Message queue — operação Template
• Nó Instances