Documéntalo
Guías

Webhooks del Sistema

Guía completa de webhooks en Coordinalo

Webhooks del Sistema

Coordinalo emite webhooks para notificar eventos en tiempo real a sistemas externos.

Configurar webhooks

POST /api/v1/organization/webhooks
{
  "url": "https://tu-servidor.com/webhooks/coordinalo",
  "secret": "tu-secret-key",
  "events": ["session.*", "payment.*", "client.created"]
}

Eventos disponibles

Sesiones

EventoDescripción
session.createdNueva sesión creada
session.confirmedCliente confirmó asistencia
session.completedSesión marcada como entregada
session.cancelledSesión cancelada
session.no_showCliente no asistió

Pagos

EventoDescripción
payment.approvedPago aprobado
payment.rejectedPago rechazado
cobro.createdNuevo cobro registrado

Clientes

EventoDescripción
client.createdNuevo cliente
client.updatedCliente actualizado

Ventas

EventoDescripción
sale.createdNueva venta
sale.completedVenta completada
sale.refundedVenta reembolsada

Formato de webhook

{
  "event": "session.completed",
  "data": {
    "sessionId": "sess_123abc",
    "previousStatus": "in_progress",
    "newStatus": "completed",
    "completedAt": "2026-01-15T11:05:00Z"
  },
  "timestamp": "2026-01-15T11:05:01Z",
  "signature": "sha256=..."
}

Verificar firma

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return `sha256=${expected}` === signature;
}

Reintentos

Coordinalo reintenta webhooks fallidos con backoff exponencial:

  • 1er reintento: 1 minuto
  • 2do reintento: 5 minutos
  • 3er reintento: 30 minutos
  • 4to reintento: 2 horas
  • 5to reintento: 24 horas

On this page