Skip to main content

​
O que são webhooks de template?

Diferente dos webhooks de canal, o oferece webhooks de template — endpoints que recebem exclusivamente os eventos de template do WhatsApp e não dependem de uma instância (instanceId = null). Eles convivem com as rotas de webhook por canal, que permanecem inalteradas. O roteamento dos eventos de template é feito pelo serviço interno independentemente da instância.
Os conceitos comuns aos dois tipos de webhook (role ENTERPRISE, autenticação, assinatura HMAC e formatos de payload) estão na Introdução.

​
Autenticação

Todas as rotas exigem o header:

​
Eventos de template aceitos

Um webhook de template aceita somente eventos de template. Enviar qualquer evento não-template resulta em 422.

​
Regras de negócio

  1. Escopo dos eventos (obrigatório).
    • Webhook de template → só aceita eventos de template. Qualquer evento não-template → 422.
    • Webhook de canal → não pode assinar eventos de template → 422.
  2. payloadFormat é ignorado. Para webhooks de template o formato é sempre DEFAULT. O campo pode ser omitido; se enviado (qualquer valor, inclusive CHATWOOT), é silenciosamente descartado e persistido como DEFAULT.
  3. instanceId gravado como null automaticamente — não há campo de instância nestas rotas. channelId também vem null.

​
Observações importantes

Escopo por tenant. As operações de leitura/edição/remoção são escopadas pelo tenant resolvido do Authorization — não há acesso cross-tenant por id.
Cache do roteador. Após criar ou alterar um webhook de template, o roteamento pode levar até ~5 min para refletir (TTL de cache).

​
Gerenciamento

Criar webhook de template

Registre um novo endpoint de template.

Listar webhooks de template

Veja todos os webhooks de template do tenant.

Detalhar webhook de template

Busque um webhook de template específico.

Atualizar webhook de template

Atualize URL, eventos, autenticação ou status.

Remover webhook de template

Exclua permanentemente um webhook de template.

Estrutura dos payloads

Exemplos reais dos payloads recebidos para cada evento de template.