Saltar al contenido principal
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

Conecta Google Calendar para que tus agentes de voz IA puedan comprobar disponibilidad y agendar citas reales mientras la persona sigue al teléfono. Una vez conectado, cada agente de tu cuenta puede usar el calendario — sin necesidad de re-autorizar por agente.

Disponible en todos los planes

Google Calendar está disponible en todos los planes incluido Free. Sin coste adicional — las consultas de calendario y la creación de eventos usan unas pocas palabras de salida del LLM por turno, facturadas a tu tarifa habitual por minuto.

Qué hace​

  • Consultas de disponibilidad — el agente lee tu calendario para confirmar si un hueco solicitado está libre.
  • Creación de eventos — el agente agenda una cita confirmada como un nuevo evento de calendario, con el nombre, teléfono y cualquier nota capturada durante la llamada.
  • Enlaces de cancelación — cada reserva incluye un enlace de cancelación autoservicio que el cliente recibe por correo o SMS, para que pueda cambiar de planes sin volver a llamar.

El agente no lee detalles de eventos de otras personas, no edita eventos no relacionados ni expone el contenido del calendario — solo los huecos que necesita para responder a quien llama.

Conectar tu cuenta de Google​

  1. Abre Integraciones en la barra lateral y haz clic en Conectar Google Calendar.
  2. Serás redirigido a la pantalla de consentimiento estándar de Google.
  3. Inicia sesión con la cuenta de Google que posee el calendario que quieres usar.
  4. Revisa el permiso solicitado — Ver y editar eventos en tus calendarios — y haz clic en Permitir.
  5. Vuelves a HANC y la tarjeta de integración muestra Conectado con la dirección de correo utilizada.

Scope solicitado​

HANC solicita un único scope OAuth: https://www.googleapis.com/auth/calendar.events.

Este es un scope Sensitive (no Restricted), lo que significa:

  • HANC puede leer y crear eventos, pero no puede leer la lista completa de calendarios, los ajustes de uso compartido ni acceder a ningún otro servicio de Google (sin Gmail, sin Drive, sin contactos).
  • Google no requiere una Security Assessment para este scope, y no hay re-verificación anual.

A nivel de cuenta, no por agente​

La conexión vive a nivel de la cuenta HANC. Los tokens se almacenan una vez en un almacén compartido y están disponibles para cada agente de voz IA en tu cuenta. Autorizas una vez y luego activas la herramienta de calendario en tantos agentes como quieras.

Esto es diferente de los ajustes por agente como el prompt, la base de conocimiento o la voz — esos se configuran por separado en cada agente.

Configuración de la herramienta por agente​

Conectar Google a tu cuenta HANC hace que la herramienta esté disponible. Para usarla de verdad, añade la herramienta Google Calendar a la pestaña Acciones del agente y configúrala.

AjusteQué hace
CalendarioDe qué calendario conectado lee y en cuál escribe el agente
Zona horariaLa zona horaria usada para cada hueco que el agente ofrece (ver más abajo)
Horario laboralDías y rangos horarios que el agente ofrecerá (p. ej. lun–vie, 09:00–18:00)
Duración del bloqueDuración por defecto de la cita (p. ej. 30 minutos)
MargenEspacio entre citas consecutivas (p. ej. 15 minutos)

Cada agente de tu cuenta puede configurar estos ajustes de forma independiente — útil cuando un agente agenda demos de venta de 30 minutos y otro agenda consultas de 90 minutos desde el mismo calendario.

Para el recorrido completo de configuración incluyendo el equivalente de Outlook, consulta Integraciones → Google Calendar.

Manejo de zonas horarias​

Todos los huecos ofrecidos, confirmaciones y eventos creados usan la zona horaria configurada en la herramienta de calendario del agente (p. ej. Europe/Vienna, Europe/Berlin, America/New_York). El agente dice la zona horaria en voz alta cuando ofrece un hueco — por ejemplo, "El martes a las tres de la tarde, hora de Viena, ¿te va bien?" — para que quien llama nunca tenga que adivinar.

Si quien llama está en una zona horaria distinta, configura el agente para que confirme verbalmente el equivalente local antes de reservar. El evento de Google Calendar creado siempre almacena la hora en la zona horaria configurada; Google se encarga de mostrarla en la zona local de cada asistente.

Desconectar y reconectar​

Puedes desconectar Google Calendar en cualquier momento desde la página Integraciones.

Cuando desconectas:

  • Los tokens almacenados se eliminan.
  • Toda herramienta Google Calendar en cada agente de tu cuenta se desactiva — la herramienta permanece en su sitio en cada agente pero ya no se dispara durante las llamadas.
  • Los eventos ya reservados en Google no se eliminan ni cambian.

Cuando vuelves a conectar (o conectas una cuenta de Google distinta), las herramientas previamente desactivadas se reactivan automáticamente con sus ajustes antiguos de horario laboral, duración de bloque y zona horaria — no tienes que volver a añadir la herramienta en cada agente.

También puedes revocar el acceso de HANC desde los ajustes de seguridad de tu cuenta de Google. El efecto es el mismo que desconectar desde dentro de HANC; la siguiente llamada que intente usar el calendario fallará limpiamente y las herramientas se desactivarán en la próxima sincronización.

Citas reservadas en HANC​

Cada evento que el agente crea también aparece en CRM → Calendario junto a cualquier reserva de Outlook, con un enlace de vuelta al registro de contacto de quien llama. Consulta CRM → Calendario para la vista unificada.

Relacionado​