Clase 06 · Módulo 06
Calendar: agendar y recordar
Calendar: agendar y recordar
Qué logras en esta clase
Armas un sistema de agenda: una persona pide hora, el flujo revisa si está libre, crea el evento y recuerda la cita.
- Creas eventos con los datos de un formulario.
- Consultas disponibilidad antes de agendar.
- Envías recordatorios sin repetirlos.
02
Una hora perdida no se recupera
Para un negocio que atiende con cita, cada persona que no llega es un cupo que ya no se vende.
03
Las piezas del nodo
| Recurso | Operaciones |
|---|---|
| Calendar | Availability |
| Event | Create, Get, Get Many, Update, Delete |
Además existe el Google Calendar Trigger, que inicia un flujo cuando pasa algo en el calendario.
Requisito: Google Calendar API habilitada y una credencial de Calendar, como en la clase 1.
04
Un calendario solo para las citas
Crea en Google Calendar un calendario aparte, por ejemplo «Citas», y apunta el flujo a ese.
- Tus eventos personales no bloquean horas de atención.
- Puedes compartirlo con el equipo sin mostrar el resto.
- Si el flujo se equivoca, el daño queda acotado.
En el nodo, el campo Calendar se elige desde una lista o por ID.
05
Crear un evento
- Elige Resource Event y Operation Create.
- Selecciona el Calendar.
- Define Start Time y End Time.
- En las opciones adicionales, agrega Summary: es el título del evento.
- Agrega Description y Location si aplican.
Sin Summary el evento queda sin título. Si no cambias las horas, el nodo usa la hora actual y una hora después.
06
Las opciones que más se usan
| Opción | Para qué |
|---|---|
| Attendees | Invitar personas por correo |
| Send Updates | Que Google les avise del evento |
| Conference Data | Crear y adjuntar un enlace de videollamada |
| All Day | Evento de día completo |
| Show Me As | Si el evento bloquea o no ese horario |
| Color Name or ID | Distinguir tipos de cita |
Para eventos repetidos están Repeat Frequency, Repeat How Many Times? y Repeat Until.
07
La hora: donde todo se rompe
El formulario entrega una fecha y una hora como texto. Calendar necesita un momento exacto, con zona horaria.
08
Calcular el término
No le pidas a la persona la hora de término. Calcúlala desde el inicio con la duración de la atención.
{{ $now.plus(1, 'hour') }}Ese es el patrón que usa el propio nodo por defecto: una fecha, más una cantidad. En tu flujo reemplazas $now por la fecha de inicio ya convertida.
09
Antes de crear, preguntar si está libre
La operación Availability del recurso Calendar revisa un tramo de tiempo.
- Calendar: cuál calendario revisar.
- Start Time y End Time: el tramo.
- En Options, Output Format y Timezone.
10
Tres formatos de respuesta
| Output Format | Entrega |
|---|---|
| Availability | Si hay o no eventos que se cruzan con el tramo |
| Booked Slots | Los períodos ya ocupados dentro del tramo |
| RAW | La respuesta de Google sin procesar |
Para decidir si agendas, usa el primero. Para ofrecer horas alternativas, el segundo. Ejecuta una vez y mira el nombre exacto del campo que devuelve antes de escribir la condición.
11
El flujo de agendamiento
El formulario puede ser el de n8n, visto en el módulo 4, clase 5. La decisión entre las dos ramas es un IF sobre la respuesta de Availability.
12
Qué cuenta como ocupado
Availability mira los eventos del calendario que le indicas. No sabe de tu horario de atención, feriados ni colación.
Tienes dos formas de enseñárselo:
- Crear eventos de bloqueo en el mismo calendario: «Colación», «Cerrado».
- Validar con un IF, antes de consultar, que la hora pedida cae dentro del horario.
Los eventos marcados para no bloquear tiempo con Show Me As pueden no contar. Pruébalo.
13
Dos personas, la misma hora
Entre que consultas y creas pasan segundos. Dos envíos casi simultáneos pueden ver libre el mismo tramo.
- Consulta la disponibilidad justo antes de crear, no al inicio del flujo.
- Redacta la confirmación como «tu hora quedó agendada» solo después de que Create responda bien.
- Con mucho volumen, este control ya no basta: es trabajo para una base de datos (módulo 7, clase 5).
14
Invitar o solo anotar
| Con Attendees | Sin Attendees | |
|---|---|---|
| El cliente | Recibe invitación de Google y la ve en su calendario | No se entera por Calendar |
| Tú controlas el mensaje | Poco | Todo: lo envías con tu flujo |
| Riesgo | Un correo mal escrito invita a un extraño | Ninguno por ese lado |
Para que Google avise a los invitados, agrega Send Updates. Sin esa opción, comprueba con una prueba si la invitación llega.
15
Guardar el ID del evento
Create devuelve los datos del evento, entre ellos su identificador.
Guárdalo junto a los datos del cliente, por ejemplo en la planilla de citas. Sin él no puedes ubicar el evento para moverlo o cancelarlo, porque Update, Get y Delete piden el Event ID.
En Update eliges qué cambiar en Update Fields. En Delete también existe Send Updates para avisar la cancelación.
16
Agendar es la mitad
Una cita agendada que nadie recuerda se pierde igual. El recordatorio es parte del sistema, no un extra.
17
Recordatorios: dos caminos
| De Google | Con tu flujo | |
|---|---|---|
| Cómo | Use Default Reminders aplica los del calendario | Flujo programado que busca citas próximas |
| A quién avisa | A quien tiene el evento en su calendario | A quien tú decidas |
| Canal | Los de Google Calendar | Correo, Telegram o WhatsApp |
| Texto | Fijo | El tuyo |
Para clientes, casi siempre conviene el segundo.
18
El flujo de recordatorios
En Get Many, After y Before definen la ventana. Para avisar un día antes: desde ahora más 24 horas hasta ahora más 25.
Con Return All apagado, Limit corta la cantidad de resultados. Súbelo o activa Return All si tienes muchas citas.
19
Que nadie reciba tres avisos
Las ventanas de dos corridas pueden pisarse, y un reintento repite todo. Necesitas una marca por cita.
- En la planilla de citas: una columna
recordado, buscando por el ID del evento. - En el evento mismo: Update agrega una palabra clave en Description, y el filtro la revisa.
La primera es más fácil de revisar para una persona.
20
Eventos repetidos y cancelados
En las opciones de Get Many:
- Recurring Event Handling: decide si un evento repetido llega como todas sus ocurrencias, solo la primera o solo la próxima.
- Show Deleted: incluye los cancelados. Déjalo apagado para recordatorios.
- Query: busca por texto libre.
- Timezone: la zona de la respuesta; por defecto, la de n8n.
21
Reaccionar a cambios en el calendario
El Google Calendar Trigger tiene cinco eventos: Event Created, Event Updated, Event Cancelled, Event Started y Event Ended.
Sirve cuando las citas las crea una persona a mano y el flujo debe enterarse. Por ejemplo, con Event Cancelled avisas a la lista de espera.
22
Cuándo Calendar no es la herramienta
- Muchos profesionales, salas y servicios con reglas cruzadas.
- Pagos por adelantado o políticas de cancelación.
- Clientes que quieren ver todos los cupos libres y elegir.
Ahí un servicio de reservas hecho para eso ahorra trabajo, y n8n se conecta a él por su API. Calendar con n8n rinde en agendas simples: una persona o un recurso, citas de duración conocida.
23
Lo que te llevas
- Un calendario dedicado para las citas.
- Fija la zona horaria y calcula el término a partir del inicio.
- Availability antes de Create, lo más cerca posible.
- Guarda el Event ID: sin él no puedes mover ni cancelar.
- Recordatorios con flujo programado, ventana de tiempo y una marca por cita.
24
Hazlo ahora
En 15 minutos:
- Crea el calendario «Citas de prueba».
- Arma un flujo con disparador manual y un Edit Fields con nombre, correo y una fecha de inicio para mañana.
- Consulta Availability para ese tramo de una hora.
- Con un IF, crea el evento solo si está libre.
- Ejecútalo dos veces: la segunda debe irse por la rama de ocupado.
- Revisa en el calendario que la hora quedó bien.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026