Google Calendar Event

Google Calendar Event es un componente que te permite crear, leer, actualizar y eliminar eventos en tu calendario de Google directamente desde el dashboard de Nappai. Con él, puedes programar reuniones, enviar invitaciones y gestionar la agenda de tu equipo sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Google Calendar mediante una credencial previamente configurada en Nappai. Cuando seleccionas una operación (Create, Get, Update o Delete), el componente envía la solicitud correspondiente a la API y devuelve los datos del evento o la confirmación de la acción. Si activas el Mapping Mode, puedes procesar varios registros a la vez, enviando una lista de eventos en un solo flujo.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

Create: Crea un nuevo evento en el calendario.
Get: Obtiene un evento existente por su ID o lista todos los eventos si no se especifica ID.
Update: Modifica los detalles de un evento existente.
Delete: Elimina un evento existente.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

Fixed (Fijo): Escribes el valor directamente en el campo.
Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

End: La hora de finalización del evento en formato ‘YYYY-MM-DD HH-MM-SS AM/PM TZ’.
- Visible en: Create, Update
Start: La hora de inicio del evento en formato ‘YYYY-MM-DD HH-MM-SS AM/PM TZ’.
- Visible en: Create, Update
Operation: Selecciona la operación que deseas ejecutar.
- Visible en: Create, Get, Update, Delete
Attendees: Lista de asistentes al evento.
- Visible en: Create, Update
Calendar Id: Introduce el Id del calendario. Si no se proporciona, se usará el calendario principal.
- Visible en: Create, Get
Calendar Selection: Selecciona el calendario desde tu Google Calendar.
- Visible en: Create, Get
Create Meet: Crea una reunión de Google Meet dentro del evento.
- Visible en: Create, Update
Description: La descripción del evento.
- Visible en: Create, Update
Event ID: El ID del evento. En la operación Get, si no se proporciona, se devolverán todos los eventos.
- Visible en: Get, Update, Delete
Input Type: El tipo de entrada a usar. Si se selecciona Id, la entrada será el Id del calendario; si se selecciona Selection, la entrada será una selección.
- Visible en: Create, Get
Location: La ubicación del evento.
- Visible en: Create, Update
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
- Visible en: Create, Get, Update, Delete
Summary: El resumen o título del evento.
- Visible en: Create, Update
Tool Name: El nombre del tool que se mostrará al agente cuando el componente se conecte como tool.
- Visible en: Create, Get, Update, Delete
Tool Description: Descripción detallada de lo que hace este tool.
- Visible en: Create, Get, Update, Delete
Tools arguments metadata: Define los metadatos de los argumentos del tool.
- Visible en: Create, Get, Update, Delete

Nota sobre credenciales
Este componente requiere una credencial de tipo Google Calendar.

Configura la credencial en la sección de credenciales de Nappai.

Selecciona esa credencial en el campo Credential del componente.
La credencial necesita un Client Id, Client Secret y el permiso Google Calendar access.

Salidas

Data: Devuelve los datos del evento o la lista de eventos en formato JSON.
Tool: Devuelve un objeto tool que puede ser usado por agentes de IA para ejecutar la operación seleccionada.

Ejemplo de Uso

Crear un evento

Selecciona la operación Create.
Llena los campos:
- Summary: “Reunión de equipo”
- Description: “Discusión de avances del proyecto.”
- Start: “2025-10-15 10:00:00 AM PST”
- End: “2025-10-15 11:00:00 AM PST”
- Location: “Sala de conferencias 2”
- Attendees: “alice@example.com, bob@example.com”
- Create Meet: true
Selecciona la credencial y haz clic en Run.
El componente creará el evento y devolverá la información del mismo en la salida Data.

Obtener eventos

Selecciona la operación Get.
Si quieres obtener un evento específico, ingresa su Event ID; si lo dejas vacío, se listarán todos los eventos.
Ejecuta el componente.
La salida Data contendrá la lista de eventos o el evento solicitado.

Componentes Relacionados

Google Calendar (gestión de calendarios y permisos)
Google Meet (creación de reuniones virtuales)

Consejos y Mejores Prácticas

Usa Mapping Mode cuando necesites crear o actualizar varios eventos a la vez.
Verifica que la zona horaria (TZ) sea correcta para evitar confusiones de horario.
Si el evento incluye asistentes, asegúrate de que sus correos estén correctos para que reciban la invitación.
Para evitar errores, prueba primero con la operación Get para confirmar que el ID del evento es válido antes de actualizarlo o eliminarlo.

Consideraciones de Seguridad

La credencial de Google Calendar debe guardarse con cuidado; no la compartas públicamente.
Asegúrate de que la cuenta de Google tenga los permisos mínimos necesarios (principio de menor privilegio).
Revisa los logs de Nappai para detectar cualquier acceso inesperado a tu calendario.