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
​
Método HTTP
seleção
default:"POST"
O verbo da requisição: GET, POST, PUT, PATCH ou DELETE.
​
Path
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
CamadaPara que serve
QueryOs parâmetros de query string da URL (ex.: ?versao=2).
HeadersCabeçalhos específicos deste template, somados aos cabeçalhos padrão da credencial.
BodyO corpo da requisição — normalmente o conteúdo principal enviado ao seu endpoint.
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:
TipoPara que serve
TextoValores de texto simples (aceita {{ }}).
URLUm endereço completo.
NúmeroValores numéricos.
Chave-valorPares de chave e valor (bom para metadados).
JSONEstruturas mais complexas, como listas ou objetos aninhados.
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.