Webhooks

Una dirección de tu sistema que recibe una llamada cada vez que ocurre algo en Piklo.

2 min de lectura ·

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.

Los webhooks no cuestan nada en Piklo Booking y están incluidos para todos los negocios.