Skip to main content

​
Webhooks

Los webhooks te permiten recibir notificaciones HTTP en tiempo real cuando ocurren eventos en ZenFlow.

Guía de Webhooks

Consulta la guía completa para ver todos los eventos disponibles, payloads de ejemplo y cómo verificar firmas.

​
Endpoints

MétodoEndpointDescripción
POST/webhooksSuscribirse a eventos
GET/webhooksListar suscripciones activas

​
Suscribirse a Eventos

Para recibir notificaciones, creá un webhook especificando tu URL y los eventos que te interesan: 
POST /api/v1/webhooks

{
  "name": "Mis notificaciones",
  "url": "https://tu-servidor.com/webhooks/zenflow",
  "events": ["order/created", "order/completed", "stock/updated"]
}

​
Eventos Disponibles

CategoríaEventos
Pedidosorder/created, order/updated, order/cancelled, order/completed
Productosproduct/created, product/updated, product/deleted
Stockstock/updated, stock/low_alert, stock/movement_created
Flujosflow/started, flow/completed, flow/cancelled
Guardá el secret devuelto en la respuesta. Lo necesitarás para verificar las firmas. No se mostrará nuevamente.

​
Respuesta

{
  "success": true,
  "data": {
    "id": "wh_abc123",
    "name": "Mis notificaciones",
    "url": "https://tu-servidor.com/webhooks/zenflow",
    "events": ["order/created", "order/completed", "stock/updated"],
    "secret": "whsec_xxxxxxxxxxxxxxxx",
    "active": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}