Cómo configurar webhooks en Koalendar
Utiliza webhooks para obtener actualizaciones en tiempo real: se envían solicitudes POST cuando alguien programa, reprograma o cancela una cita en tu página de reservas.
Esto resulta útil si estás creando automatizaciones personalizadas utilizando plataformas como Zapier, Make (Integromat), n8n o tu propio código backend.
Paso 1: Crear el punto final de su webhook
- Abre el editor de tu página de reservas.
- Desplácese hasta la sección Opciones adicionales y haga clic en Mostrar configuración avanzada.
- Introduzca el punto final de la URL de su webhook (el destino de las solicitudes POST).
Paso 2: Probar y automatizar
- Realiza una reserva de prueba, cambia la fecha o cancela para activar un webhook.
- Inspeccione los registros de su servidor o la herramienta webhook para confirmar la recepción del POST.
- Cada carga útil incluye:
- Tipo de evento:
evento.creado– cuando alguien reserva una citaevento.provisional– cuando alguien hace una reserva provisionalevento.reprogramado– cuando un invitado cambia la hora de la reservaevento.cancelado– cuando un invitado cancela su cita
- Detalles de la reserva (nombre, correo electrónico, ubicación, inicio, finalización, etc.)
- El invitado responde a través de
campos del invitado—con identificadores de preguntas y valores
- Tipo de evento:
Puede utilizarlo para:
- Activar correos electrónicos o alertas internas
- Actualiza tu CRM o base de datos.
- Sincroniza datos entre aplicaciones mediante Zapier o lógica personalizada.
Ejemplo de carga útil
El campoinvitee.fieldscontiene las respuestas a las preguntas que usted formula en su formulario de reserva.
La clave del objeto es elidentificador de la pregunta, que puedes encontrar al editar una pregunta (en la parte superior):
ℹ️ Preguntas frecuentes
¿Qué eventos activan un webhook?
evento.creado, evento.provisional , evento.reprogramado , y evento.cancelado
¿Puedo usar Zapier con webhooks?
¡Sí! Los webhooks se pueden utilizar para activar acciones de Zapier o cualquier plataforma de integración que acepte solicitudes POST. Lea nuestra guía de Zapier.
¿Qué ocurre si mi webhook falla?
Koalendar volverá a intentarlo si tu punto final no está disponible temporalmente o devuelve un error.
¿Puedo actualizar o eliminar mi webhook más adelante?
Sí. Solo tienes que volver a la configuración de webhooks en el editor de tu página de reservas.