ApiID.
Todas as requisições exigem o cabeçalho Authorization: Bearer {BearerToken}.
Os templates precisam ser criados e aprovados pela Meta antes do envio. Você pode criá-los no painel, na aba Templates da tela Integrações Meta, ou no Gerenciador de Negócios da Meta. Estes endpoints apenas disparam um template já aprovado: eles não criam nem editam templates.
Estrutura Comum do templateData
Os três endpoints abaixo compartilham a mesma estrutura de templateData, que segue o formato da API oficial da Meta (Cloud API) para o objeto de mensagem de template:
templateData deve ser um objeto (um texto JSON também é aceito) e template.components, quando enviado, deve ser uma lista. Fora desse formato, a rota responde 400 com ERR_INVALID_TEMPLATE_DATA (templateData inválido) ou ERR_INVALID_TEMPLATE_COMPONENTS (components que não é lista).
Enviar Template Simples
Envia um template sem substituição de variáveis, ideal para templates estáticos como confirmações e saudações.
O campo
number é obrigatório e pode ser enviado como texto ou número. Sem ele, a rota responde 400 com ERR_MISSING_NUMBER_OR_BSUID, e o mesmo vale para templateBody e templateMarketingBody.
Enviar Template com Corpo Dinâmico
Variante usada quando o template aprovado contém variáveis no corpo da mensagem (por exemplo,{{1}}, {{2}}). Os valores de substituição vão em templateData.template.components.
templateData.template.components, que carrega os parâmetros posicionais usados para preencher as variáveis do corpo aprovado pela Meta.
Nesta rota, text de cada parâmetro e variables, quando enviados como número, são convertidos em texto. Se vierem como objeto ou lista, a rota responde 400 com ERR_INVALID_TEMPLATE_PARAMETER.
Enviar Template de Marketing
Variante para templates da categoria Marketing (promoções, novidades, campanhas), com componentes de cabeçalho (header) e corpo (body). Usa a mesma estrutura de templateData das duas rotas anteriores, incluindo components quando o template tiver variáveis ou botões dinâmicos (por exemplo, um botão de URL com sufixo variável).
templateBody, text de cada parâmetro e variables, quando enviados como número, são convertidos em texto. Se vierem como objeto ou lista, a rota responde 400 com ERR_INVALID_TEMPLATE_PARAMETER.
Como o Envio é Feito (por Categoria do Template)
Nos três endpoints, o PanÐá Zap escolhe o caminho do envio pela categoria do template aprovado:
O corpo da requisição e a resposta são os mesmos em todos os casos.
A rota
templateMarketingBody também aceita template da categoria Utilidade: ele sai pelo envio comum, sem erro.
