API de Google Calendar: eventos, disponibilidad y agendas con agentes de IA
La API de Google Calendar permite leer y gestionar calendarios, eventos e invitados, además de consultar horarios libres y ocupados. La usan herramientas de agendamiento, CRM y sistemas internos. El acceso es por OAuth del usuario o por una cuenta de servicio con delegación en Google Workspace.
Qué ofrece la API de Google Calendar
Eventos
Crear, actualizar, mover y cancelar eventos, con lugar, descripción y adjuntos.
Calendarios
Listar y gestionar calendarios de usuarios, salas y recursos compartidos.
Invitados y respuestas
Añadir participantes y ver quién aceptó o rechazó.
Disponibilidad (libre/ocupado)
Consultar los huecos libres de varias personas para proponer horarios.
Notificaciones de cambios
Suscribirse a canales para saber cuándo cambian los eventos de un calendario.
Videollamada en el evento
Crear el evento ya con un enlace de reunión de Google Meet.
Cómo acceder a la API de Google Calendar
- Con las credenciales de tu empresaOAuth 2.0 con un proyecto en Google Cloud; en las empresas es habitual usar una cuenta de servicio con delegación en todo el dominio, autorizada por el administrador de Workspace.
- Usa el alcance más restringido posible, como solo lectura cuando el agente únicamente consulta horarios.
- La delegación en todo el dominio da un acceso amplio; limita a qué usuarios atiende el agente.
- Presta atención a la zona horaria y a los eventos recurrentes al crear o mover reuniones.
Documentación oficial: developers.google.com/calendar
Qué hace un agente de iTeam con la API de Google Calendar
Agendamiento de reuniones comerciales
El agente SDR propone al lead por WhatsApp horarios libres del vendedor y crea el evento con enlace de Meet cuando el lead elige.
Reprogramación sin idas y vueltas
Cuando alguien cancela, el agente busca el siguiente hueco en común, lo sugiere a los participantes y actualiza la invitación.
Preparación de reuniones
Una hora antes, el agente arma un resumen del cliente a partir del CRM y se lo envía a quien organiza el evento.
Gestión de salas y recursos
El agente reserva salas según la ocupación y libera las reservas de reuniones canceladas.
De la credencial al agente trabajando, con aprobación
Crear el proyecto en Google Cloud
Activa la API de Calendar y crea las credenciales OAuth o la cuenta de servicio, con los permisos mínimos de calendario.
Guardar la credencial en la bóveda de iTeam
Define qué agentes solo pueden consultar disponibilidad y cuáles pueden crear o modificar eventos, y en qué calendarios.
Probar con un calendario piloto
Empieza con pocos calendarios y con aprobación para las invitaciones externas; cada acción queda auditada.
Equipos de IA listos que usan Google Calendar
Recepcionista con IA
Jaca atiende el teléfono con voz, entiende qué necesita quien llama y deja la cita agendada o el recado en manos de la persona correcta.
Citas para clínicas
Jaca agenda y confirma citas por WhatsApp, Nina rellena los huecos que deja una cancelación y la recepción vuelve a atender a quien está en la sala.
Leads para inmobiliarias
Jaca responde al interesado del portal por WhatsApp, Romeo lo califica y la visita queda en el calendario del asesor que corresponde.
Reclutamiento y selección
Bia lee cada CV con los requisitos de la vacante, explica por qué recomienda a cada candidato y agenda la entrevista; la decisión la toma tu equipo.
Preguntas sobre la API de Google Calendar
¿La API de Google Calendar es gratuita?
Sí, en general la API de Google Calendar no tiene cargo por uso, pero está sujeta a cuotas. La cuenta de Google Workspace o Gmail sigue con su plan normal.
¿Necesito programar para usar la API de Google Calendar con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación de la API y aprende los endpoints, y el equipo de implantación configura contigo credenciales, permisos y pruebas.
¿Se puede ver la disponibilidad de varias personas con la API de Google Calendar?
Sí. La consulta de libre/ocupado devuelve los horarios ocupados de varios calendarios, lo que permite al agente proponer horarios en común sin ver el contenido de los eventos.
