Webhooks — Recibe eventos en tiempo real

Que es un webhook#

Un webhook envia una peticion HTTP (POST) a tu servidor cada vez que ocurre un evento en salescloud.

Eventos disponibles#

• contact.created — Nuevo contacto
• contact.updated — Contacto modificado
• deal.won — Deal ganado
• deal.lost — Deal perdido
• invoice.created — Factura creada
• invoice.paid — Factura pagada
• estimate.accepted — Presupuesto aceptado
• task.completed — Tarea completada
• ticket.created — Nuevo ticket de soporte

Configurar#

1. Ve a Configuracion > API > Webhooks
2. Haz clic en Nuevo webhook
3. Introduce la URL de tu servidor
4. Selecciona los eventos que quieres recibir
5. (Opcional) Añade un secret para verificar la firma

Formato del payload#

{
  "event": "invoice.paid",
  "timestamp": "2026-03-28T10:30:00Z",
  "data": {
    "id": "inv_abc123",
    "number": "FAC-2026-0042",
    "amount": 1210.00,
    "customer": { "name": "Empresa SL", "email": "info@empresa.com" }
  }
}

Reintentos#

Si tu servidor responde con error (5xx), salescloud reintenta 3 veces con backoff exponencial (1min, 5min, 30min).