Agenda
Conectar Google Calendar a un agente de IA autónomo
Google Calendar centraliza las citas y la disponibilidad de toda la empresa. Un agente Atako puede proponer huecos, crear eventos y detectar conflictos, sin ver nunca tu contraseña de Google.
Próximamente — crea tu cuenta y te avisaremos en cuanto esta integración esté lista.
Flujos de trabajo posibles
Programación de citas con clientes sin idas y vueltas
Un comercial o un equipo de soporte recibe una solicitud de cita. El agente comprueba los huecos libres con check_availability en el calendario correspondiente, propone dos o tres huecos compatibles y crea el evento con create_event una vez confirmado el hueco elegido. La invitación se envía automáticamente a los participantes en cuanto se crea el evento, si el grant create_event tiene ámbito de escritura; sin él, el agente se limita a enumerar los huecos disponibles en un mensaje preparado, sin llegar nunca a reservar la cita él mismo.
Detección de conflictos y dobles reservas
El agente lista los próximos eventos con list_events, detecta dos reuniones que se solapan o una cita que ha quedado sin confirmar durante varios días, y prepara una propuesta de resolución. No mueve ni cancela nada por su cuenta: cancel_event y update_event siguen siendo acciones distintas, concedidas por separado si la empresa quiere que el agente actúe directamente en lugar de limitarse a señalar el conflicto al organizador.
Búsqueda de un hueco común para una entrevista o una reunión de equipo
Para organizar una entrevista de contratación o una reunión con varios calendarios, el agente lista los calendarios accesibles con list_calendars, consulta su disponibilidad con check_availability y luego identifica el primer hueco común en el periodo solicitado. Solo crea el evento una vez que ese hueco ha sido validado por una persona, salvo que create_event se haya concedido explícitamente para automatizar por completo la programación.
Acciones del conector
list_events
Lectura. Listar los eventos de un calendario durante un periodo determinado.
get_event
Lectura. Recuperar los detalles completos de un evento, participantes incluidos.
search_events
Lectura. Buscar eventos con una consulta de texto.
check_availability
Lectura. Comprobar los huecos libres y ocupados de uno o varios calendarios.
list_calendars
Lectura. Listar los calendarios accesibles para la cuenta conectada.
create_event
Escritura. Crear un evento con sus participantes.
update_event
Escritura. Modificar un evento existente: horario, participantes o descripción.
respond_to_event
Escritura. Responder a una invitación recibida: aceptar, rechazar o provisional.
add_attendee
Escritura. Añadir un participante a un evento existente.
cancel_event
Escritura. Cancelar un evento existente del calendario.
Requisitos previos
- Rol de administrador en la empresa Atako para conectar la integración.
- Cuenta de Google, personal o Workspace, cuyo calendario deba conectarse.
- Consentimiento OAuth de Google, ámbito https://www.googleapis.com/auth/calendar.events.
- Un grant explícito por agente, en particular para create_event y cancel_event.
Cómo conectar
- 1
Abrir Configuración → Integraciones
Un administrador elige Google Calendar en la lista de conectores disponibles.
- 2
Revisar las acciones expuestas
La ventana muestra todas las acciones de calendario, de lectura y escritura, antes de autorizar.
- 3
Autenticarse a través de la pantalla de Google
Redirección al consentimiento de Google, sin que se transmita ninguna contraseña a Atako.
- 4
Conceder acceso a un agente
Se eligen las acciones concretas por agente, por ejemplo solo check_availability y list_events para permanecer en modo solo lectura.
Por qué conectar un agente autónomo a Google Calendar
Google Calendar concentra las citas, las reuniones y la disponibilidad de gran parte de las empresas, especialmente las que usan Google Workspace. Un agente autónomo conectado a él no se limita a responder a una única orden: funciona de forma continua y decide, según la instrucción recibida, comprobar un hueco libre, detectar un conflicto o proponer una cita, gracias al tool calling.
La conexión utiliza OAuth 2.0 y el ámbito de Google Calendar calendar.events (ámbitos OAuth de Google). Este ámbito permite leer, crear y modificar eventos de calendario, nunca eliminar la propia cuenta de Google ni cambiar sus ajustes de seguridad.
Esto es lo que hace útil un flujo como la búsqueda de un hueco común para una entrevista, cercano a lo que hace un agente de operaciones de RR. HH., o la programación de una cita comercial, cercana a un agente de operaciones de ingresos: recibe una solicitud y prepara el siguiente paso (un hueco, un evento, un recordatorio de confirmación) sin esperar a que una persona abra su calendario para comparar a mano la disponibilidad de varias personas. Google Calendar forma parte de las integraciones cubiertas por el plan Standard, sin línea de facturación aparte por conector.
Límites y buenas prácticas
La acción más sensible del conector es create_event: una vez concedida con ámbito de escritura, el agente reserva una cita y Google envía automáticamente la invitación a todos los participantes, sin volver a consultarte. La práctica más segura consiste en conceder solo check_availability y list_events: el agente propone huecos, una persona crea el evento definitivo y activa el envío de las invitaciones ella misma.
El ámbito calendar.events cubre todo el calendario de la cuenta conectada, no un calendario secundario concreto. El límite real proviene por tanto del grant: enumera las acciones exactas que necesita el agente, por ejemplo solo lectura para un uso de mera consulta, en lugar de conceder la creación y la cancelación de golpe al conectar.
update_event y cancel_event modifican o eliminan un evento existente, incluso para los demás participantes si ya han aceptado la invitación original. Reserva estas dos acciones a un agente cuyo rol realmente lo requiera, y mantén cancel_event separado de create_event en el grant si quieres que pueda proponer sin poder cancelar nunca.
La documentación no menciona ningún límite de tasa propio del conector de Google Calendar, se aplican las cuotas estándar de la API de Google Calendar. Cada llamada, enviada o rechazada, sigue siendo consultable en el registro de auditoría de la página del agente. Y como en cualquier cuenta OAuth, si el token expira o se revoca en el lado de Google, la conexión pasa a estado de error hasta que se vuelva a conectar.
Casos de uso relacionados
Integraciones complementarias
Preguntas frecuentes
¿Puede el agente crear una cita y enviar la invitación sin validación?
Sí, si el grant incluye create_event con ámbito de escritura, el agente crea el evento y Google envía la invitación a los participantes automáticamente. La mayoría de las empresas prefieren limitar al agente a check_availability y list_events: propone huecos, una persona crea la cita definitiva.
¿Se necesita un plan de pago para conectar Google Calendar?
Sí, se necesita un plan Atako activo, pero Google Calendar es una de las integraciones ya incluidas en el plan Standard, sin coste adicional por conector.
¿Cómo se revoca el acceso de Atako a mi calendario de Google?
Desde Configuración → Integraciones, haz clic en Revoke en la conexión de Google Calendar. El token cifrado se elimina de inmediato, y todos los agentes que lo usaban pierden el acceso al instante.
¿El ámbito calendar.events permite ver los calendarios de otros compañeros?
No, este ámbito solo cubre la cuenta de Google conectada. El agente solo ve el calendario de un compañero si este lo ha compartido explícitamente con esa cuenta de antemano, y solo dentro de los límites de ese uso compartido.
Qué leer a continuación
Fuentes
- Google Calendar API, referencia · consultado el 7 de septiembre de 2026
- OAuth 2.0 Scopes for Google APIs · consultado el 7 de septiembre de 2026
CTO de Atako
Este contenido fue redactado por los agentes de IA de Atako, y luego revisado, corregido y validado por Romain Laodicina, CTO de Atako.