Conecta Google Calendar con Kharyo para agendar por WhatsApp
Tu agenda en Google Calendar se vuelve consultable y escribible desde el chat: el agente IA agenda, modifica y libera slots sin que nadie copie a mano.
Setup paso a paso
- 1Iniciar conexión desde Kharyo
En el panel Integraciones, hacer clic en Conectar Google Calendar. Te redirige a la pantalla oficial de consentimiento de Google.
- 2Autorizar scopes mínimos
Kharyo pide los scopes calendar.events (crear, modificar, leer eventos) y calendar.readonly (consultar disponibilidad). No pide acceso a Gmail ni Drive.
- 3Seleccionar calendarios visibles
Si tu cuenta Google tiene varios calendarios (personal, trabajo, sala A, sala B), elegís cuáles pueden consultarse o escribirse desde el agente. Los demás quedan invisibles.
- 4Configurar reglas de slots
Definir duración estándar de cita, buffer entre citas, horarios laborales, días no disponibles y eventos que cuentan como "ocupado" vs "libre".
- 5Probar con una reserva real
Generar una conversación de prueba donde el agente IA consulta disponibilidad, ofrece slots y crea el evento. Confirmar que aparece en el calendario al instante.
Casos de uso
Agendamiento conversacional con disponibilidad real
El cliente escribe pidiendo cita para esta semana. El agente IA consulta el calendario real de los profesionales, descarta slots ya ocupados y ofrece los 3 más cercanos según las reglas definidas (horarios, buffers, vacaciones).
Liberación automática de slots cancelados
Cuando un cliente cancela por WhatsApp, el evento se elimina del calendario en tiempo real y queda disponible para el siguiente cliente en lista de espera, sin que recepción toque nada.
Sincronización bidireccional
Si alguien del equipo bloquea manualmente una hora en Google Calendar (almuerzo, capacitación), el agente IA deja de ofrecer ese slot inmediatamente. La fuente de verdad es el calendario, no una base de datos paralela.
Multi-recurso y multi-profesional
Para clínicas con varios profesionales o salas, el agente consulta el calendario de cada uno y asigna según especialidad, preferencia del cliente o carga del día.
Notas técnicas
- OAuth 2.0 oficial de Google. Tokens almacenados cifrados, refresh automático sin intervención del usuario.
- Scopes solicitados: https://www.googleapis.com/auth/calendar.events y https://www.googleapis.com/auth/calendar.readonly. Mínimos necesarios para la integración.
- Push notifications vía Google Calendar API Watch Channels: cambios en el calendario notifican a Kharyo en tiempo real sin polling.
- Re-suscripción automática de channels antes del expiry (Google limita la duración de cada channel a un máximo definido por la API).
- Soporte para calendarios compartidos, calendarios de recursos (salas, equipos) y delegación de Workspace.
- Eventos creados desde Kharyo llevan metadata identificable (extendedProperties) para distinguirlos de eventos creados manualmente.
Lo que no cubre Google Calendar
- Google impone cuotas diarias por proyecto y por usuario. Para volúmenes muy altos (cientos de miles de operaciones diarias por cuenta), conviene revisar quotas antes de escalar.
- Push notifications de Google a veces presentan latencia de varios segundos. Para flujos sensibles, Kharyo combina notificación push con polling de respaldo.
- Calendarios secundarios sin permisos explícitos de Workspace no son accesibles. La cuenta conectada solo ve lo que su rol permite.
- Eventos recurrentes (todos los lunes 10 AM) requieren manejo especial al consultar disponibilidad: Kharyo expande las recurrencias correctamente, pero algunas modificaciones a instancias individuales pueden requerir verificación manual.
Preguntas frecuentes
¿Kharyo accede a mi Gmail o Drive si conecto Calendar?
No. Los scopes solicitados son exclusivamente de Calendar. Google Workspace muestra exactamente qué permisos se piden en la pantalla de consentimiento.
¿Qué pasa si revoco el acceso desde mi cuenta Google?
El agente IA deja de poder consultar y modificar el calendario al instante. Las reservas creadas previamente quedan en el calendario, pero las próximas conversaciones avisan al cliente que la agenda está temporalmente fuera de línea.
¿Puedo conectar varios calendarios distintos?
Sí. Una cuenta Google puede tener decenas de calendarios visibles. Desde Kharyo elegís cuáles consulta el agente IA y cuáles puede escribir.
¿Funciona con Workspace de pago o también con cuentas Gmail personales?
Ambas. La API de Google Calendar es la misma. Para Workspace hay features adicionales como delegación y calendarios de recursos que solo aplican en el plan corporativo.
¿Y si quiero migrar después a otra plataforma de calendario (Microsoft 365, Cal.com)?
Los eventos viven en Google, no en Kharyo. Migrar de plataforma de calendario implica reapuntar la integración desde Kharyo a la nueva, los eventos siguen donde están.
