Diferente do OneSignal, o Webhook não tem chave secreta. A autenticação fica por conta dos
cabeçalhos que você definir (por exemplo, um
Authorization) e/ou da assinatura HMAC.Configuração
Destino
O endereço de destino. Precisa começar com
https:// (endereços sem segurança são recusados). O
caminho específico de cada envio vem do template e é somado a essa base.Cabeçalhos enviados em toda requisição — normalmente a autenticação do seu sistema (por exemplo,
um
Authorization) ou a identificação de tenant.Comportamento de envio
O nome do cabeçalho em que a assinatura HMAC viaja. Vem preenchido, mas você pode trocar.
Quanto tempo esperar pela resposta antes de desistir, de 1.000 a 60.000 ms (1 s a 60 s).
Opcional. Com ele, o PrismaFlow assina o corpo de cada requisição (HMAC-SHA256) e envia a assinatura
no cabeçalho acima — assim o seu endpoint confirma que a chamada veio do PrismaFlow e não foi
adulterada. Sem ele, nenhuma assinatura é enviada.
Mapeamento
Qual identidade do perfil identifica o destinatário. O valor dela é enviado automaticamente, em toda
requisição, no cabeçalho
X-PrismaCDP-User — então o seu endpoint reconhece o usuário sem precisar
vasculhar o corpo.Cabeçalhos automáticos
Além dos seus, o PrismaFlow sempre acrescenta três cabeçalhos, que não podem ser sobrescritos:| Cabeçalho | Para que serve |
|---|---|
X-Idempotency-Key | Identifica unicamente o envio, evitando processar a mesma ação duas vezes. |
X-PrismaCDP-User | O destinatário definido no Mapeamento. |
Content-Type: application/json | Indica que o corpo é JSON (incluído quando há corpo). |
O formato da chamada é um template
A credencial diz para onde e como autenticar. O método (GET, POST…), o caminho, os
parâmetros, os cabeçalhos e o corpo são definidos num template de webhook — a próxima
seção (Templates).
As variáveis {{ }} podem aparecer nos dois lados: em campos da credencial (a URL base e os
cabeçalhos padrão aceitam {{ }} — por exemplo, uma base https://api.{{tenant}}.exemplo.com) e
nos campos do template. Em todos os casos, quem define de onde vem cada valor é o
nó de Ação → Variáveis da jornada.
Validação e entrega
A validação do Webhook não faz uma chamada de teste — ela só confere os campos (URLhttps:// e
mapeamento válidos). O endereço pode até não existir; um erro de URL só aparece no primeiro envio
real.
O Webhook não tem eventos de retorno (entrega, clique). O resultado de cada envio é simples:
- Enviada — o seu endpoint respondeu com sucesso.
- Falhou — respondeu com erro ou estourou o tempo limite.