Google Calendar

Tu agenda real, controlada desde el chat. Conecta tu Google Calendar una vez y a partir de ahí pides “agéndame junta con Ana jueves de 4 a 5” y el evento aparece en tu calendario, listo para invitar a otros y compartirlo.

§ 2.2.1 Antes de empezar #

El Calendar de Google es un servicio independiente del bot — Arkos accede vía OAuth con scope calendar, que te pide explícitamente al momento de conectar. El scope cubre lectura y escritura de eventos en tus calendarios; ningún otro permiso de tu cuenta Google se toca.

Conectar Calendar

La primera vez que pidas algo de calendario (“¿qué tengo mañana?”, “agéndame algo el viernes”) sin estar conectado, Arkos te manda un enlace al dashboard. Lo abres, inicias sesión con Google y autorizas. El enlace dura 10 minutos; si caduca, pides otro.

§ 2.2.2 Qué entiende #

Hoy hay tres tools disponibles tras conectar: conectarCalendario (genera el enlace OAuth), listarEventosCalendario (lee próximos eventos) y crearEventoCalendario (crea un bloque con inicio y fin). Todo lo demás se construye encima en lenguaje natural.

Crear un evento

Un evento de Calendar siempre tiene inicio y fin — eso es lo que lo distingue de un recordatorio. Le das los dos extremos en lenguaje natural y opcionalmente un título y descripción.

• “agéndame junta con Ana jueves de 4 a 5”
• “mete en mi calendario revisión de cierre el martes 9 a 10:30”
• “bloquéame mañana de 2 a 4 para deep work”

Consultar tu agenda

“¿qué tengo mañana?”, “mis eventos de la semana”, “¿qué viene después de comer?” — el agente lee tus próximos eventos del calendario principal (hasta 50 a la vez). Devuelve título, hora, link directo al evento. No persiste nada de eso en nuestra base; cada consulta llega fresca de Google.

Modificar y eliminar

§ 2.2.3 Recordatorio vs evento #

Es la confusión más común y por eso hay dos capacidades distintas:

• Recordatorio · un ping al chat a una hora. No ocupa hueco en tu calendario, no avisa a nadie más, no tiene duración. Ej. “avísame a las 3 que tomo pastilla”. Mira Recordatorios.
• Evento de Calendar · un bloque de tiempo con inicio y fin que aparece en tu calendario y puedes compartir con otras personas. Ej. “junta con Ana de 4 a 5”.

La heurística del agente: si la frase trae “de X a Y”, duración, o nombra otra persona, va a calendario. Si es solo “a las X” con un texto a recordar, va a recordatorio.

§ 2.2.4 Casos límite #

Zona horaria

El evento se crea en tu zona horaria configurada. Si “mañana a las 4” y tienes America/Mexico_City, sale a 16:00 hora CDMX. Tus invitados verán la hora en su propio huso — eso lo hace Google Calendar, no Arkos. Si te mudaste, actualiza tu zona (“ahora vivo en Bogotá”) antes de crear eventos para evitar líos.

Conflictos de agenda

Si el evento se crea pero falla la sincronización con Google (token expirado, red), el bot devuelve un error claro tipo CALENDAR_NOT_CONNECTED y te ofrece reconectar. Tus eventos previos siguen ahí — sólo se bloquean creaciones nuevas hasta que renueves el OAuth.