Calendar Event

Calendar Event conecta tu flujo con tu Google Calendar para gestionar eventos: crear una cita o una reunión, con invitados y enlace de Google Meet si quieres, consultar los eventos de un periodo, cambiar un evento existente o eliminarlo.

Es útil cuando las citas nacen de otro proceso, por ejemplo una reserva que un cliente hace en un formulario o una petición que atiende un agente de IA, y quieres que el evento aparezca en el calendario sin tener que crearlo a mano.

Cuándo usarlo

Un cliente reserva una cita en tu web y quieres crear el evento e invitarle en el mismo flujo.
Cada mañana quieres un resumen con los eventos del día.
Un agente de IA atiende peticiones de reuniones y necesita consultar huecos libres y crear eventos por sí mismo.
Una cita se cambia de hora y quieres actualizar el evento y avisar a los invitados.
Un pedido se cancela y quieres eliminar la reunión de seguimiento.

Configuración

Necesitas una credencial Google Calendar, que se conecta iniciando sesión con tu cuenta de Google. Para crear, modificar o eliminar eventos, la credencial debe tener el acceso Create, Update, Delete, Read; con Read Only solo puedes consultar. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Google Calendar de la cuenta con la que trabajas.
Operation	Lo que hace el componente. Ver Operaciones. Por defecto, `Create`.
Input Type	Solo en `Create` y `Get`. Déjalo en `Selection` para elegir el calendario de la lista. Por defecto, `Selection`.
Calendar Selection	Solo en `Create` y `Get`. El calendario en el que se crea o se buscan los eventos. La lista se carga al elegir la credencial y muestra los calendarios en los que puedes escribir.
Event ID	El identificador del evento. Obligatorio en `Update` y `Delete`. En `Get` es opcional: si lo rellenas, devuelve directamente ese evento.
Summary	Solo en `Create` y `Update`. El título del evento. Obligatorio en `Create`.
Start	La fecha y hora de inicio. En `Get`, el principio del periodo en el que se buscan eventos. Debe ser anterior a End.
End	La fecha y hora de fin. En `Get`, el final del periodo en el que se buscan eventos.
Max Results	Solo en `Get`. Cuántos eventos devolver como máximo. Por defecto, 10.
Query Filter	Solo en `Get`. Devuelve solo los eventos que contienen el texto en el título, la descripción, el lugar o el correo de los invitados o del organizador. Si lo dejas vacío, devuelve todos.

Operaciones

Operación	Qué hace
`Create`	Crea un evento nuevo y envía la invitación a los invitados.
`Get`	Devuelve los eventos de un calendario en el periodo entre Start y End, ordenados por fecha, o un evento concreto si indicas su Event ID.
`Update`	Cambia un evento existente y avisa a los invitados. Solo se cambian el título, la descripción, el lugar y los invitados que rellenes; Start y End se aplican siempre.
`Delete`	Elimina un evento. Si es una repetición de un evento periódico, se elimina toda la serie.

Opciones avanzadas

Solo en Create y Update:

Campo	Qué hace
Description	La descripción del evento.
Location	El lugar del evento.
Attendees	Los correos de las personas a las que se invita. En `Update`, sustituyen a la lista de invitados que tenía el evento.
Create Meet	Añade al evento un enlace de Google Meet. Por defecto, desactivado.

Resultado

La salida Data devuelve los eventos con los que has trabajado: su identificador (id), título, fecha de inicio y fin, invitados, enlace para abrirlo en Google Calendar (htmlLink) y, si has activado Create Meet, el enlace de la reunión. En Get sale un elemento por cada evento. En Delete devuelve una confirmación con el nombre del evento eliminado.

Puedes conectar el resultado a un componente de correo o de mensajería para enviar el enlace, o a un agente de IA para que lo use en su respuesta. El componente también se puede conectar a un Agente como herramienta, para que el agente consulte la agenda y cree eventos cuando lo necesite. Ver Tool Mode.

Ejemplo

Una clínica quiere que cada cita reservada en su web aparezca en el calendario de consultas.

El formulario de reserva llega al flujo con el nombre y el correo del paciente y la fecha elegida.
Añade Calendar Event con la operación Create y elige el calendario Consultas en Calendar Selection.
En Summary pon Cita con seguido del nombre del paciente, y en Start y End la hora de inicio y de fin de la cita.
En las opciones avanzadas, pon el correo del paciente en Attendees para que reciba la invitación.

Buenas prácticas

En Update, escribe siempre en Start y End las fechas que debe tener el evento, aunque no cambien: si no, el evento se mueve a las fechas que tengan esos campos.
En Get, ajusta Start y End al periodo que te interesa, por ejemplo el día de hoy. Solo se devuelven los eventos de ese periodo.
Si rellenas Event ID en Get, el evento se busca en tu calendario principal. Para los de otros calendarios, usa Query Filter con su título.
Los invitados reciben un correo de Google cada vez que creas o cambias un evento.

Componentes relacionados

Calendar Calendars: crear y gestionar calendarios.
Google Calendar Webhook: iniciar un flujo cuando cambia un evento.