Módulo 7: Calendly y Agendamiento
Eventos y Tipos de Evento
Descripción de la cápsula
Antes de recibir una sola reserva, tienes que entender qué estás recibiendo. Y para eso, Calendly tiene una distinción que es la base de todo el módulo:
Un tipo de evento (event type) es la plantilla. Un evento agendado (scheduled event) es la reserva concreta.
"Llamada de 30 minutos" es un tipo de evento — la plantilla que define duración, disponibilidad, qué preguntas se le hacen al que reserva. Cuando Ana entra a tu Calendly, elige esa plantilla y reserva el martes a las 10:00, eso es un evento agendado — una instancia concreta de la plantilla, con una persona, una hora y unas respuestas.
Es exactamente la relación entre "una clase" y "un objeto" en programación, o entre "un molde" y "un pastel". Y entenderla bien evita la confusión #1 del módulo: pensar que el webhook te avisa de "un evento" sin tener claro que te avisa de un evento agendado (la reserva), no de un cambio en el tipo de evento (la plantilla).
Lo que vas a aprender
Al terminar esta cápsula serás capaz de:
- ✅ Distinguir un tipo de evento de un evento agendado
- ✅ Entender qué define un tipo de evento (duración, disponibilidad, preguntas)
- ✅ Entender qué compone un evento agendado (invitado, hora, respuestas)
- ✅ Consultar tipos de evento y eventos agendados desde el nodo
- ✅ Reconocer el concepto de "invitee" (el que reserva)
- ✅ Preparar el terreno para entender el webhook de la cápsula 04
El tipo de evento: la plantilla
Un tipo de evento es lo que tú configuras una vez en Calendly y que tus clientes ven cuando quieren agendar. Define:
| Qué define | Ejemplo |
|---|---|
| Nombre | "Llamada de descubrimiento" |
| Duración | 30 minutos |
| Disponibilidad | Lun-Vie, 9:00-17:00 |
| Las preguntas | Al reservar, se le pide al cliente: nombre, email, "¿de qué quieres hablar?" |
| Notificaciones | Recordatorios que Calendly manda por su cuenta |
El tipo de evento no es una cita — es el molde del que salen las citas. Puedes tener varios: "Llamada de 30 min", "Demo de producto de 1h", "Soporte de 15 min". Cada uno con su propia configuración.
Desde n8n, los tipos de evento se consultan (con el nodo Calendly), no se suelen crear ni modificar por workflow — eso se hace a mano en la interfaz de Calendly. Tu workflow los lee para saber, por ejemplo, "¿de qué tipo fue la reserva que acaba de entrar?".
El evento agendado: la reserva concreta
Un evento agendado (scheduled event) es lo que se crea cuando alguien reserva. Es una instancia del tipo de evento, con datos concretos:
| Qué tiene | Ejemplo |
|---|---|
| El tipo de evento del que salió | "Llamada de descubrimiento" |
| Cuándo | Martes 20 de mayo, 10:00-10:30 |
| El invitado (invitee) | Ana López, ana@correo.com |
| Las respuestas | "Quiero hablar sobre el plan anual" |
| El estado | Activo / cancelado |
| Un ID único | El identificador de esa reserva concreta |
El evento agendado es la cita. Es lo que aparece en tu agenda, lo que el cliente recibe confirmado, y — clave para el módulo — lo que el webhook te avisa cuando se crea o se cancela.
El "invitee": quién reservó
Un término propio de Calendly que vale la pena fijar: el invitee es la persona que reservó — tu cliente, el lead, el que entró a tu Calendly y eligió un horario.
Puede sonar al revés (¿no eres tú el "anfitrión"?), pero la lógica de Calendly es: tú publicas tu disponibilidad, y la otra persona es "invitada" a reservar dentro de ella. El invitee trae los datos que más te importan: su nombre, su email, y las respuestas a las preguntas que configuraste en el tipo de evento.
Los datos del invitee son el insumo principal de todo workflow post-reserva. "Alguien reservó" no sirve de mucho; "Ana López, ana@correo.com, reservó una llamada de descubrimiento el martes y dijo que quiere hablar del plan anual" — eso es con lo que tu workflow trabaja.
Consultar desde el nodo
El nodo Calendly (no el trigger — cápsula 02) permite consultar:
- Tipos de evento: listar las plantillas que tienes configuradas
- Eventos agendados: listar las reservas concretas, con filtros (por rango de fechas, por estado)
- Detalles de un invitee: los datos completos de quién reservó
Cuándo usas el nodo vs el trigger (cápsula 02): el trigger te avisa en el momento en que algo se reserva. El nodo lo usas para consultar a propósito — "dame todas las reservas de esta semana", "tráeme los detalles del invitee de esta reserva". Es la misma distinción que viste en Gmail entre el Trigger y el Get Many: reaccionar vs consultar.
Por qué esta distinción importa para el webhook
Adelanto de la cápsula 04, para que llegues con el terreno preparado:
Cuando configures el webhook de Calendly, vas a elegir a qué eventos suscribirte. Y las opciones serán cosas como "invitee.created" (alguien reservó) e "invitee.canceled" (alguien canceló).
Fíjate: el webhook te avisa de cosas que le pasan a un invitee dentro de un evento agendado — no de cambios en el tipo de evento (la plantilla). Tiene sentido: lo accionable para tu negocio es "alguien reservó" o "alguien canceló", no "edité la duración de mi plantilla".
Si tienes clara la distinción tipo de evento / evento agendado / invitee, el webhook de la cápsula 04 no te va a confundir.
Trampas comunes
Trampa 1: Confundir el tipo de evento con la reserva
Qué pasa: Crees que "el evento" es la plantilla, y te enredas cuando el webhook habla de reservas concretas.
Cómo evitar: Tipo de evento = plantilla (el molde). Evento agendado = reserva concreta (el pastel). El webhook te avisa de reservas.
Trampa 2: Esperar crear tipos de evento desde n8n
Qué pasa: Intentas que tu workflow configure un tipo de evento nuevo.
Cómo evitar: Los tipos de evento se configuran a mano en Calendly. Desde n8n los consultas, no los creas.
Trampa 3: Pasar por alto los datos del invitee
Qué pasa: Tu workflow procesa "una reserva" pero no extrae quién reservó ni qué respondió — y entonces no puede hacer nada útil.
Cómo evitar: El invitee (nombre, email, respuestas) es el insumo principal. Identifícalo y trabájalo siempre.
Trampa 4: Olvidar que un evento agendado puede cancelarse
Qué pasa: Asumes que un evento agendado es permanente. El cliente cancela, y tu workflow sigue como si la cita existiera.
Cómo evitar: Un evento agendado tiene estado (activo / cancelado). Las cancelaciones son parte del modelo — la cápsula 04 las trata como un evento de webhook propio.
Ejercicio: explora el modelo
Objetivo: ver con tus propios datos la diferencia entre tipos de evento y eventos agendados.
Preparación
En Calendly, ten al menos un tipo de evento configurado. Reserva una cita de prueba en él (puedes reservarte a ti mismo o pedirle a alguien que reserve).
Tu tarea
- Lista tus tipos de evento: Manual Trigger → Calendly (consulta event types). Observa: son tus plantillas.
- Lista tus eventos agendados: Manual Trigger → Calendly (consulta scheduled events). Observa: son las reservas concretas — incluida la de prueba que hiciste.
- Compara los dos outputs. ¿Qué campos tiene un tipo de evento que un evento agendado no, y viceversa? Localiza, en el evento agendado, los datos del invitee.
Ver qué deberías observar
- El tipo de evento tiene duración, disponibilidad, configuración — pero no una persona ni una hora concreta.
- El evento agendado tiene una hora concreta, un estado, y referencia a su tipo de evento — y los datos del invitee (quién reservó).
- La lección: el webhook de la cápsula 04 te dará eventos agendados (con su invitee), no tipos de evento.
Resumen y siguiente paso
- Tipo de evento = la plantilla (duración, disponibilidad, preguntas). Evento agendado = la reserva concreta (persona, hora, respuestas, estado)
- Es la relación molde/pastel — el tipo de evento es el molde, cada reserva es un pastel
- El invitee es quien reservó — sus datos (nombre, email, respuestas) son el insumo principal de todo workflow post-reserva
- Desde n8n, los tipos de evento se consultan, no se crean por workflow; los eventos agendados se consultan (nodo) o se reciben (trigger)
- El webhook (cápsula 04) te avisa de eventos agendados —
invitee.created,invitee.canceled— no de cambios en las plantillas - 4 trampas: confundir plantilla con reserva, esperar crear tipos de evento, pasar por alto el invitee, olvidar que las reservas se cancelan
Antes de avanzar deberías poder:
- Distinguir un tipo de evento de un evento agendado
- Identificar los datos del invitee en una reserva
- Anticipar de qué te avisará el webhook
Lo que sigue (cápsula 04):
Tienes el modelo claro. Ahora el corazón del módulo: el webhook de Calendly. Cómo configurar el Calendly Trigger para que tu workflow se encienda en el instante en que alguien reserva (o cancela) — la señal que enciende toda la automatización post-reserva.
Recursos adicionales
- Calendly: tipos de evento - Cómo se configuran las plantillas.
- Calendly API: scheduled events - El modelo de eventos agendados e invitees.
- n8n Calendly node Docs - Operaciones de consulta del nodo.
Creado: Mayo 14, 2026 Versión: 1.0