Como replicar templates de WhatsApp entre WABAs via API

Quando usar?

Quando você precisa levar os templates de WhatsApp de uma conta do WhatsApp Business (WABA) para outra. Por exemplo: migração de número, empresa com mais de uma WABA que quer os mesmos templates em todas, ou troca de portfólio no Meta Business. A Meta não tem botão de "duplicar" entre contas, mas dá pra fazer pela API da Meta (Graph API) em poucos passos.

Este procedimento exige alguém com familiaridade com chamadas de API. Se preferir, fale com o nosso suporte que a gente ajuda.

Não existe clonar o status de aprovado. Todo template recriado na WABA de destino passa de novo pela aprovação da Meta (normalmente minutos, podendo levar até 24h). Planeje a troca considerando esse prazo, para não ficar sem template aprovado na conta nova.

O que eu preciso antes?

WABA ID de origem e WABA ID de destino
Um access token com a permissão whatsapp_business_management que tenha acesso às duas WABAs (de um usuário do sistema do Business Manager, por exemplo)

Como faço passo a passo?

1. Listar os templates aprovados da WABA de origem

curl -G "https://graph.facebook.com/v{versao}/{WABA_ID_ORIGEM}/message_templates" \
  -d "status=APPROVED" \
  -d "fields=name,language,category,parameter_format,components" \
  -d "limit=100" \
  -H "Authorization: Bearer {TOKEN}"

A resposta traz nome, idioma, categoria e o conteúdo (components) de cada template. Se tiver mais de 100, siga o link paging.next da resposta até acabar.

2. Criar cada template na WABA de destino

Para cada item da lista, mande um POST com os mesmos dados. Tire os campos que são da conta de origem (id, status, qualidade etc.) e envie só name, language, category, parameter_format (se vier) e components.

curl -X POST "https://graph.facebook.com/v{versao}/{WABA_ID_DESTINO}/message_templates" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "boas_vindas",
    "language": "pt_BR",
    "category": "UTILITY",
    "components": [ ...copiado da origem... ]
  }'

3. Acompanhar a aprovação

Consulte de novo o GET na WABA de destino olhando o campo status até todos ficarem APPROVED. Os que voltarem REJECTED precisam de ajuste manual.

Quais os pontos de atenção?

Template com mídia no header (imagem, vídeo, documento): o arquivo de exemplo da origem não vale na outra conta. Suba a mídia de novo pela Resumable Upload API, pegue o novo handle e troque no header_handle antes do POST.
Variáveis: mantenha os exemplos (example) que vêm nos components. Sem eles a Meta rejeita.
Limite de criação: no máximo 100 templates criados por hora em cada WABA. Se for muita coisa, faça em lotes.
Limite total: 250 templates por WABA se o portfólio não for verificado (verificado vai bem além disso).
Categoria: a Meta pode reclassificar a categoria na nova aprovação (ex.: de utilidade para marketing), o que muda o custo de envio.
Nome: o mesmo name + idioma não pode já existir na WABA de destino.

Observações

Para criar, editar e usar templates dentro do Cloud Chat, veja Templates de WhatsApp: criar, editar, excluir e usar o construtor.
Para entender categorias e motivos de reprovação, veja Regras de templates do WhatsApp (Meta).
Ficou alguma dúvida? Fale com o nosso suporte.

Referência oficial: Templates de mensagem (Meta for Developers)