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

  1. Abre el editor de tu página de reservas.
  2. Desplácese hasta la sección Después de la reserva.
  3. 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 cita
      • evento.provisional    – cuando alguien hace una reserva provisional
      • evento.reprogramado    – cuando un invitado cambia la hora de la reserva
      • evento.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

Puede utilizarlo para:


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):


🛠️ ¿No has recibido el webhook o ha llegado tarde?

  • Página de reserva correcta: cada página de reserva tiene su propia URL de webhook. Comprueba que esté configurada en la página que recibió la reserva y que hayas guardado la página.
  • URL completa: Introduce la dirección completa, empezando por https:// . Se ignora cualquier URL no válida.
  • Responde rápidamente: Tu punto final debería aceptar un PUBLICAR  con un cuerpo JSON y responder con un 2xx  estado. Si se agota el tiempo de espera o se produce un error, Koalendar vuelve a intentarlo más tarde, por lo que el webhook llega con retraso.
  • Que no haya ningún obstáculo: asegúrate de que ningún sistema de autenticación, cortafuegos o filtro de IP bloquee las solicitudes dirigidas a tu punto final.
  • Comprueba el funcionamiento: pega una URL temporal de una herramienta como webhook.site, realiza una reserva de prueba y comprueba que la solicitud se recibe correctamente.

ℹ️ 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.

¿Esto responde a tu pregunta? Gracias por tu comentario. Ha habido un problema al enviar tus comentarios. Inténtalo de nuevo más tarde.

¿Aún necesitas ayuda? Contáctanos Contáctanos