Google Calendar
¿Qué es la integración con Google Calendar?
La integración con Google Calendar permite que tus agentes de voz y WhatsApp consulten disponibilidad, agenden reuniones y gestionen citas directamente en tu calendario, sin salir de la conversación. Cada reunión creada incluye automáticamente un link de videollamada de Google Meet.
¿Qué puede hacer el agente con esta integración?
- Consultar horarios disponibles en tu Google Calendar
- Crear reuniones con invitación por email al contacto (incluye link de Google Meet)
- Reprogramar citas existentes
- Cancelar citas existentes
El agente solicita al contacto su nombre, email y teléfono antes de crear la cita. El contacto recibe la invitación con el link de videollamada directamente en su correo.
Cómo conectar tu Google Calendar
1. Ve a Integraciones
En el panel, abre el menú lateral y selecciona Integraciones.
2. Conecta tu cuenta de Google
Haz clic en 🔗 Conectar en la card de Google Calendar. Se abrirá la pantalla de autorización de Google. Inicia sesión con la cuenta cuyo calendario quieres usar.
Nota sobre la advertencia de Google: si ves la pantalla "Google no ha verificado esta aplicación", haz clic en Configuración avanzada → Ir a [nombre de la app] (no seguro). Esta advertencia es normal en aplicaciones en proceso de verificación y no indica ningún problema de seguridad.
3. Selecciona el calendario
Después de autorizar el acceso, aparecerá una pantalla con todos los calendarios de tu cuenta en los que puedes crear eventos. Selecciona el que quieres usar y haz clic en Confirmar calendario.
Si tienes un solo calendario, se selecciona automáticamente.
4. Listo
A partir de este momento, tus agentes pueden usar ese calendario. La card en Integraciones mostrará el email de la cuenta conectada y el calendario activo.
Cambiar el calendario activo
Si conectaste varios calendarios o quieres usar uno diferente:
- Ve a Integraciones → Google Calendar
- Haz clic en el link Cambiar junto al nombre del calendario
- Selecciona el nuevo calendario y confirma
También puedes cambiar el calendario directamente desde la ficha de cada agente (ver más abajo).
Cómo activar Google Calendar en un agente
La integración de Google Calendar se activa por agente. Puedes usarla en agentes de WhatsApp y de voz.
Agente de WhatsApp
- Abre la ficha del agente → sección Funciones del agente
- Haz clic en + Agregar función
- Selecciona 📅 Habilitar Google Calendar
- Confirma — el agente descargará las 4 funciones y el bloque de instrucciones se actualizará automáticamente
Agente de voz
- Abre la ficha del agente → sección Funciones del agente
- Haz clic en + Agregar función
- En el grupo Herramientas del Sistema, selecciona 📅 Google Calendar — Gestión de citas
- Personaliza el mensaje que el agente dice mientras consulta la disponibilidad (opcional)
- Haz clic en Agregar — se instalan las 4 funciones y las instrucciones se actualizan solas
Qué calendario usa cada agente
Cada agente tiene un calendario vinculado de forma explícita. En la sección Funciones del agente de la ficha del agente verás una card verde como esta:
📅 Google Calendar: tu@email.com [Cambiar]Si necesitas que un agente use el calendario de otra cuenta conectada, haz clic en Cambiar y selecciona la cuenta correspondiente.
Una cuenta, un agente: cada agente usa el calendario de una sola cuenta de Google. Si dos agentes deben usar calendarios distintos, conecta ambas cuentas en Integraciones y asigna una a cada agente desde su ficha.
Cómo funciona el flujo de agendamiento
Cuando un contacto solicita una cita, el agente sigue este flujo:
- Consulta disponibilidad — llama a
gcal_check_availabilityy obtiene los horarios libres de tu calendario - Ofrece opciones — presenta 2 o 3 horarios disponibles al contacto
- Solicita datos — pide nombre completo, email y teléfono antes de confirmar
- Crea el evento — genera el evento en Google Calendar con un link de Google Meet automático
- Confirma — informa al contacto el día, hora y que recibirá la invitación por email
El contacto recibe en su correo la invitación estándar de Google Calendar con el link de videollamada incluido.
Desconectar Google Calendar
Desde Integraciones → Google Calendar → botón Desconectar.
Al desconectar:
- Los tokens de acceso se revocan en Google
- Los agentes con Google Calendar activado dejarán de poder crear o consultar eventos
- Los eventos ya creados en el calendario no se eliminan
Preguntas frecuentes
¿Funciona con cualquier cuenta de Google?\ Sí, con cualquier cuenta Gmail o Google Workspace.
¿El contacto necesita tener Google Calendar?\ No. El agente crea el evento en tu calendario. El contacto recibe la invitación por email y puede aceptarla o agregarla a cualquier app de calendario.
¿Qué pasa si el agente intenta crear una cita en un horario ya ocupado?\ El agente solo ofrece los horarios en los que el calendario está libre. No puede proponer un horario ocupado.
¿Puedo conectar más de una cuenta de Google?\ Sí. Cada usuario del panel puede conectar su propia cuenta. Si varios usuarios de tu equipo conectan sus calendarios, cada agente puede asignarse al calendario de quien corresponda.
¿El link de Google Meet se crea siempre?\ Sí, automáticamente en cada evento creado por el agente. No requiere configuración adicional.
¿Qué horarios considera el agente como disponibles?\ Por defecto, lunes a viernes de 9:00 a 18:00 en la zona horaria del contacto, excluyendo los períodos ya ocupados en el calendario. Los slots tienen una duración de 30 minutos.