Skip to main content
Um template de webhook é o modelo de uma requisição HTTP. Ele fica ligado a uma credencial Webhook e herda dela o endereço base, os cabeçalhos padrão, o tempo limite e a assinatura. O template define o resto: o método, o caminho e o conteúdo das camadas. Esta página cobre as abas Requisição e Camadas (a aba Identificação, comum a todos, está em Templates).

Requisição

Os dois campos centrais do webhook. Cada um trabalha em um dos modos Fixo, Lista ou Livre.
Aba Requisição do template de webhook

Aba Requisição: o método HTTP e o caminho do endpoint.

seleção
default:"POST"
O verbo da requisição: GET, POST, PUT, PATCH ou DELETE.
texto
required
O caminho do endpoint, que é somado ao endereço base da credencial. Precisa começar com / (ex.: /v1/events). É um ótimo lugar para usar variáveis — por exemplo, /v1/users/{{id_externo}}/eventos.

Camadas

No webhook, as camadas já vêm prontas: Query, Headers e Body aparecem sempre, e você só preenche as que precisar (cada uma começa com 0 campos). Use a engrenagem de cada camada para configurar seus campos.
Aba Camadas do template de webhook

Aba Camadas do webhook: Query, Headers e Body, cada uma Fixa ou com variantes.

Como nos outros campos, cada camada pode ser Fixa (valores definidos) ou com variantes (conjuntos que a jornada escolhe no envio). Ao configurar os campos de uma camada, cada campo tem um tipo, que só ajusta o tipo de entrada na tela:
Lembre dos cabeçalhos automáticos da credencial (X-Idempotency-Key, X-PrismaCDP-User e o Content-Type): eles continuam sendo adicionados e têm prioridade sobre os cabeçalhos do template. E, em requisições GET, o corpo é ignorado.

Variáveis {{ }}

O webhook é onde as variáveis vão mais longe: qualquer campo pode ter {{nome}} — o caminho, os parâmetros de query, os cabeçalhos e o corpo. No envio, cada {{ }} é trocado pelo dado real do perfil, com a origem definida no nó de Ação → Variáveis da jornada. Se uma variável usada ficar sem origem, o envio é rejeitado.