Qué es. En Ajustes → Integraciones, el propietario o un administrador añade una dirección https y elige los eventos. Piklo envía una llamada POST con un pequeño cuerpo JSON. Úsalo con Zapier, Make o tu propio sistema. Un negocio puede tener hasta tres webhooks.
Los eventos.
- booking.created — un cliente reservó o pagó una reserva retenida
- booking.cancelled — un cliente canceló
- booking.rescheduled — un cliente cambió su cita
- client.created — una reserva creó un cliente nuevo
- review.received — un cliente dejó una valoración
- membership.started — una membresía se pagó y comenzó
- ping — se envía al pulsar «Enviar prueba»
También se envían las reservas, clientes y membresías creados en el panel.
Formato de una llamada. Cada llamada contiene el evento, el momento, el negocio y los datos.
{
"event": "booking.created",
"occurred_at": "2026-11-02T14:03:11.204Z",
"organization_id": "5b0c…",
"data": { "booking": { "id": "e1f4…", "status": "confirmed" } }
}Datos del cliente solo cuando los solicitas. Nombre, email, teléfono, precio y comentario solo se envían al activar «Enviar datos del cliente». Entonces data también incluye client y price. Está desactivado por defecto porque eres responsable según el RGPD del uso que haga el receptor.
Verifica la firma. Cada llamada lleva X-Piklo-Signature: sha256=… — un HMAC-SHA256 del cuerpo sin modificar con el secreto mostrado durante la configuración.
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
const valid = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signatureHeader));
if (!valid) return response.status(401).end();Verifica antes de analizar el cuerpo. X-Piklo-Event también contiene el nombre del evento.
Respuesta. Responde con cualquier estado 2xx en 5 segundos. Si no, Piklo reintenta después de 1, 5 y 30 minutos. Tras 10 fallos seguidos, el webhook se desactiva. Las llamadas pueden repetirse o llegar desordenadas; usa occurred_at y el id de la reserva.
Visibilidad. Cada webhook muestra sus 50 últimas entregas con estado. Se eliminan después de 14 días.
Contacto. Escribe a support@piklobooking.com.