Un webhook es una URL tuya a la que eltick le manda un POST cada vez que pasa algo. Así tu sistema se entera al instante, sin tener que preguntar cada tanto.

Eventos disponibles

Crear un webhook

Igual que las claves, los webhooks están en los planes Escala y Enterprise, y los configuran el Dueño o los Administradores.
1

Prepara tu URL

Tiene que ser pública y empezar con https://. Debe responder rápido (en menos de 8 segundos) con un código 2xx. Más abajo tienes un ejemplo de servidor.
2

Abre Ajustes › API y webhooks y toca Nuevo webhook

Pega tu URL y marca los eventos que quieres recibir. Puedes crear varios webhooks, cada uno con sus eventos (por ejemplo, uno para tu CRM y otro para tu sistema de pedidos).
Diálogo Nuevo webhook con la URL y los cinco eventos marcados
3

Guarda el secreto de firma

Al crearlo te mostramos el secreto de firma (whsec_…), una sola vez. Lo vas a usar para verificar que cada aviso viene de eltick.
Diálogo Secreto de firma mostrado una sola vez
4

Pruébalo

Toca Probar. Mandamos un evento message.received de prueba (con "test": true) y te decimos si tu servidor respondió bien.
Aviso Llegó bien (HTTP 200) después de probar el webhook
5

Revisa las entregas

Entregas muestra los últimos 50 envíos a ese webhook, con el evento, los intentos y la respuesta de tu servidor. Es lo primero que conviene mirar si algo no llega.
Diálogo Últimas entregas con un message.received entregado con 200
Desde la misma lista puedes Pausar un webhook (deja de recibir eventos sin perder la configuración), volver a Activarlo o eliminarlo.

Qué te mandamos

Cada aviso es un POST con un cuerpo JSON y estos encabezados:
Cuerpo
  • id: id de la entrega (igual a X-Eltick-Delivery). Guárdalo para no procesar dos veces el mismo aviso.
  • event: el tipo de evento.
  • createdAt: cuándo pasó.
  • data: los datos del evento. Mira cada uno en Eventos.

Un receptor mínimo

Este servidor verifica la firma, responde 200 enseguida y después procesa el evento.

Buenas prácticas

Responde en menos de 8 segundos

Si tardas más, lo contamos como fallido y reintentamos. Responde 200 primero y procesa en segundo plano.

Verifica siempre la firma

Tu URL es pública: cualquiera podría mandarle un POST. La firma prueba que viene de eltick.

Ignora los duplicados

Un mismo aviso puede llegar más de una vez. Usa id (o X-Eltick-Delivery) para detectarlo.

No dependas del orden

Los eventos pueden llegar desordenados, sobre todo después de un reintento. Usa createdAt y los datos del evento.
¿Qué pasa si tu servidor está caído? Lo explicamos en Reintentos.