Calendar

Calendar conecta tu flujo con el calendario de Outlook: consulta los eventos de un periodo, crea eventos y reuniones en línea, modifica o elimina eventos existentes y gestiona los propios calendarios (crearlos, renombrarlos o eliminarlos).

Es útil cuando las citas nacen o se consultan desde otro proceso: una reserva hecha en un formulario, un agente que tiene que saber si hay hueco en la agenda o un resumen diario de reuniones.

Cuándo usarlo

Un cliente reserva una cita y quieres crearla en el calendario de la persona que le atenderá.
Un agente de IA tiene que consultar tu agenda para proponer huecos libres.
Cada mañana quieres recibir un resumen con las reuniones del día.
Cuando se cancela un pedido o un proyecto, quieres eliminar las reuniones de seguimiento.

Configuración

Necesitas una credencial Microsoft Outlook, que se conecta iniciando sesión con tu cuenta de Microsoft. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Microsoft Outlook de la cuenta cuyo calendario usas.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `Get Calendar Events`.
Mode	`Basic` muestra solo los campos imprescindibles; `Advanced` añade Search Query, Event Body y Location. Por defecto, `Basic`.
Calendar	El calendario con el que se trabaja. La lista se carga al elegir la credencial. Si lo dejas vacío, se usa tu calendario principal. En las operaciones de eventos.
Event Type	`Event` o `Online Meeting`. Con `Online Meeting` aparecen Is Online Meeting y Attendees. Por defecto, `Event`. Solo en `Create Event`.
Event ID	El identificador del evento. Lo obtienes con `Get Calendar Events`. En `Update Event`, `Delete Event` y `Get Event by ID`.
Event Subject	El título del evento. En `Create Event` y `Update Event`.
Event Body	La descripción del evento. Solo con Mode en `Advanced`, en `Create Event` y `Update Event`.
Location	El lugar del evento. Solo con Mode en `Advanced`, en `Create Event` y `Update Event`.
Is Online Meeting	Si está activado, el evento se crea como reunión en línea con su enlace para unirse. Activado por defecto. Solo en `Create Event`.
Attendees	Los correos de los asistentes, separados por comas. Solo en `Create Event`.
Search Start Time	En `Get Calendar Events`, el inicio del periodo que se consulta. En `Create Event` y `Update Event`, la fecha y hora de inicio del evento. Por defecto, la fecha y hora actuales.
Search End Time	En `Get Calendar Events`, el fin del periodo que se consulta. En `Create Event` y `Update Event`, la fecha y hora de fin del evento. Por defecto, la fecha y hora actuales.
Search Query	Un texto para quedarte solo con los eventos cuyo asunto o contenido lo incluyen. Solo con Mode en `Advanced`, en `Get Calendar Events`.
Calendar ID	El identificador del calendario. Lo obtienes con `Get Calendars`. En `Update Calendar`, `Delete Calendar` y `Get Calendar by ID`.
Calendar Name	El nombre del calendario. Obligatorio en `Create Calendar` y `Update Calendar`.

Operaciones

Operación	Qué hace
`Get Calendar Events`	Devuelve los eventos del periodo indicado, con su asunto, descripción, inicio, fin, lugar, asistentes y enlace.
`Create Event`	Crea un evento o una reunión en línea. Necesita fecha de inicio y de fin.
`Update Event`	Cambia el asunto, la descripción, el lugar o las fechas de un evento. Solo se modifican los campos que rellenes.
`Delete Event`	Elimina un evento.
`Get Event by ID`	Devuelve los datos completos de un evento concreto.
`Get Calendars`	Lista tus calendarios, con su identificador, nombre, propietario, color y si es el principal.
`Create Calendar`	Crea un calendario nuevo.
`Update Calendar`	Cambia el nombre de un calendario.
`Delete Calendar`	Elimina un calendario.
`Get Calendar by ID`	Devuelve los datos de un calendario concreto.

Resultado

La salida Data devuelve un elemento por cada evento o calendario encontrado, o un único elemento con el resultado de la operación: el evento creado con su identificador y su enlace, la confirmación de la eliminación o el calendario modificado.

Puedes conectar el resultado a un agente para que lo use en su respuesta, o a un componente de correo o mensajería para enviar la cita. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo consultar o crear eventos. Ver Tool Mode.

Ejemplo

Una clínica de fisioterapia quiere que las citas reservadas en su web aparezcan en el calendario del fisioterapeuta.

El formulario de reserva llega al flujo con el nombre del paciente y la hora elegida.
Añade Calendar con la operación Create Event y la credencial Microsoft Outlook del fisioterapeuta.
En Event Subject pon Sesión con seguido del nombre del paciente.
En Search Start Time y Search End Time pon el inicio y el fin de la cita, por ejemplo 2026-03-20T10:00:00 y 2026-03-20T11:00:00.
Conecta la salida Data a un componente de correo que envíe la confirmación al paciente.

Buenas prácticas

Escribe las fechas completas con hora, por ejemplo 2026-03-20T10:00:00.
Para modificar o eliminar un evento necesitas su Event ID. Guárdalo al crearlo o búscalo antes con Get Calendar Events.
Delete Calendar elimina también todos los eventos de ese calendario.

Componentes relacionados

Outlook Calendar Webhook: iniciar un flujo cuando cambia tu calendario.
Email: enviar y gestionar correos de Outlook.
Online Meetings: consultar reuniones de Teams, sus grabaciones y transcripciones.