Recibiendo webhooks¶
Para que el madkting pueda mandar webhooks, tu servidor nesecita estar accecible desde internet.
Madketing envia la informacion basica del webhook por las cabezeras
el User-agent
es un prefijo mad-hookshot/
seguido de una cadena aleatoria de 4 caracteres.
Cada peticion que de los webhook tiene un timeout
de 30 segundos
si la peticion no se completa en ese tiempo el webhook dara por hecho que la
peticion no se pudo enviar y volvera a intentarlo
en 30, 120, 280 y 560 segundos segun el numero de veces que falle en intentar
de avisar al servidor.
Los hooks esperan una respuesta sin body
y con el status code
200
, 202
o 204
,
cualquier otro status code
hara que se vuelva a mandar la peticion
Cabezeras¶
Cabezera | descripcion |
---|---|
X-Madkting-event | El tipo de evento Lista de eventos |
X-Madkting-signature | Token secreto genero cuando se subscribio a los webhooks |
X-Madkting-delivery | Identificador para cada evento |
Location | Url donde se consulta la informacion del evento |
Ejemplo de la peticion¶
POST https://host_cliente.xyz/ HTTP/1.1
X-Madkting-event: ping
X-Madkting-signature: 84ba0f49e89167245cd793f831daeadb52a3e3c4
X-Madkting-delivery: 9e8916728313e3c484ba016724
Ejemplo de la respuesta¶
HTTP/1.1 200 OK
Allow: POST, OPTIONS