🔗 Guía de uso: Webhooks

Nuestra plataforma permite configurar webhooks para recibir actualizaciones automáticas sobre eventos clave relacionados con tus pedidos e incidencias.

📌 ¿Qué son los webhooks?

Por ejemplo, cuando cambia el estado de una orden o de una incidencia, dropea puede enviar esa información automáticamente a tu sistema para que puedas reaccionar de inmediato.

🔑 Configuración inicial

Para comenzar a utilizar webhooks, sigue estos pasos:

1. Ingresa a Mi Cuenta → Access Token.
2. Crea una API Key con permisos sobre tus órdenes e incidencias.
3. Configura dos endpoints o URLs públicas:
   • 📦 Uno para recibir actualizaciones de estado de órdenes.
   • 🛠️ Otro para recibir actualizaciones de estado de incidencias.

✅ Seguridad: firmas HMAC

Para validar la autenticidad de los eventos recibidos, cada webhook puede incluir una firma digital en el header.

Esto te permite verificar que la solicitud proviene realmente de dropea y que no ha sido alterada.

🛍️ Order Status Update

Cuando se actualiza el estado de una orden, dropea envía una notificación al webhook configurado con la estructura del evento.

❌ Ejemplo 1: pedido pasa de confirmado a cancelado

{"topic":"order:status_update","order_id":265494,"prev_status":"confirmed","new_status":"cancelled","updated_at":"2025-05-29 14:14:58"}

✅ Ejemplo 2: pedido pasa de pendiente a confirmado

{"topic":"order:status_update","order_id":265494,"prev_status":"pending","new_status":"confirmed","updated_at":"2025-05-29 14:14:58"}

🔁 Ejemplo 3: pedido pasa de error a pendiente

{"topic": "order:status_update",
  "order_id":265496,"prev_status":"error","new_status":"pending","updated_at":"2025-05-29 14:38:05"}

🛠️ Incidence Update

Cuando se actualiza el estado de una incidencia, dropea envía una notificación al webhook configurado para incidencias.

📌 Ejemplo 1: incidencia pasa de pendiente a manejado por el cliente

{
  "topic": "incidence:status_update",
  "incidence_id": 189044,
  "prev_status": "pending",
  "new_status": "client_managed",
  "updated_at": "2025-02-13 14:23:56"
}

🔄 Ejemplo 2: incidencia pasa de manejado por el cliente a solución enviada

{
  "topic": "incidence:status_update",
  "incidence_id": 265494,
  "prev_status": "client_managed",
  "new_status": "solution_send",
  "updated_at": "2025-05-29 16:10:45"
}

✅ Ejemplo 3: incidencia pasa de solución enviada a resuelto

{
  "topic": "incidence:status_update",
  "incidence_id": 265494,
  "prev_status": "solution_send",
  "new_status": "resolved",
  "updated_at": "2025-05-29 17:42:30"
}

📋 Detalles por campo