Pular para o conteúdo principal
Canais WABA (WhatsApp Business API oficial da Meta) só podem iniciar uma conversa fora da janela de 24 horas usando um template de mensagem previamente aprovado pela Meta. Estes três endpoints enviam um template pelo canal WABA conectado ao seu 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.
Defina validateNumber: false ao enviar para canais WABA. A normalização automática do 9º dígito brasileiro pode fazer o número final não bater com o cadastrado no WhatsApp Business, criando um contato/ticket duplicado.
Use o token de uma API criada para um canal WABA. Estas rotas não conferem o tipo do canal antes de chamar a Meta: com o token de um canal de outro tipo (por exemplo, Baileys), a resposta é 400 com ERR_SEND_UPSTREAM seguido do erro devolvido pela Meta (por exemplo, ERR_SEND_UPSTREAM: Invalid OAuth access token - Cannot parse access token).

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.
Os mesmos campos de Enviar Template Simples se aplicam; a diferença fica em 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).
Use esta rota para templates da categoria Marketing, que costumam ter cabeçalho com mídia: envie em templateData.template.components um item header (por exemplo, com image.link) e um item body com os parâmetros do texto.
Esta rota também aceita template da categoria Utilidade: ele sai pelo envio comum, sem erro. Veja Como o Envio é Feito para o caminho de cada categoria. Assim como em 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.

Resposta de Sucesso

Os três endpoints retornam o mesmo formato: