Webhooks salientes

Los webhooks permiten que SolNow notifique a sistemas externos cuando ocurren eventos en la plataforma. Es la forma más directa de integrar SolNow con herramientas propias o de terceros como CRMs, ERPs o sistemas de automatización.

¿Cómo funciona un webhook?

Cuando ocurre un evento en SolNow (ej. se crea un nuevo lead), el sistema envía una petición HTTP POST a la URL que hayas configurado. El cuerpo de la petición contiene los datos del evento en formato JSON.

El sistema receptor procesa los datos y puede responder con cualquier acción: enviar un email, actualizar un CRM externo, crear una tarea en Notion, etc.

Acceder a webhooks

Ir a Configuración → Webhooks en el menú lateral.

Crear un webhook

1. Hacer clic en + Nuevo webhook
2. Completar el formulario:

Campo	Descripción
URL de destino	La URL de tu sistema receptor (debe ser HTTPS)
Nombre	Nombre descriptivo para identificar el webhook
Eventos	Seleccioná los eventos que disparan el webhook
Secreto	Clave para verificar que las peticiones vienen de SolNow
Activo	Activar o desactivar sin eliminar la configuración

Eventos disponibles

Leads

Evento	Descripción
lead.created	Se crea un nuevo lead
lead.updated	Se actualiza cualquier campo del lead
lead.state_changed	El lead cambia de estado
lead.assigned	El lead se asigna a un operador

Reservas

Evento	Descripción
booking.created	Se crea una nueva reserva
booking.confirmed	La reserva pasa a estado confirmado
booking.cancelled	La reserva se cancela
booking.checked_in	Se registra el check-in
booking.completed	La experiencia se completa

Pagos

Evento	Descripción
payment.received	Se registra un pago
payment.refunded	Se realiza un reembolso

Clientes

Evento	Descripción
client.created	Se crea un nuevo cliente
client.updated	Se actualiza el perfil del cliente

Formato del payload

Todos los webhooks envían un payload JSON con esta estructura:

{
  "event": "lead.created",
  "timestamp": "2026-05-01T10:30:00Z",
  "organization_id": "org_abc123",
  "data": {
    "id": "lead_xyz789",
    "client_name": "María García",
    "experience": "Alquiler velero 8h",
    "date": "2026-06-15",
    "pax": 4,
    "state": "nuevo",
    ...
  }
}

Verificar la autenticidad

Cada petición incluye un header X-SolNow-Signature con un HMAC-SHA256 del cuerpo, firmado con el secreto que configuraste. Verificá esta firma en tu receptor antes de procesar el evento.

X-SolNow-Signature: sha256=abc123...

Reintentos

Si el receptor responde con un error (código HTTP 4xx o 5xx), SolNow reintenta el envío:

Intento	Espera
1° reintento	1 minuto
2° reintento	5 minutos
3° reintento	30 minutos
4° reintento	2 horas

Después de 4 reintentos fallidos, el evento se marca como fallido y se notifica al administrador.

Historial de entregas

Desde el detalle de cada webhook podés ver el historial de entregas:

• Eventos enviados
• Código de respuesta recibido
• Cuerpo de la respuesta
• Opción de reenviar manualmente un evento fallido

Consejo

Usá herramientas como webhook.site para probar tu webhook antes de conectarlo con tu sistema real. Podés ver el payload exacto que envía SolNow.