Google Calendar | ElevenLabs Documentation

Resumen

Conecta tus agentes de IA de ElevenLabs con Google Calendar para gestionar la programación y las citas del calendario. Esta integración permite a tus agentes comprobar la disponibilidad, crear eventos con asistentes y videoconferencia opcional de Google Meet, listar próximos eventos y descubrir calendarios accesibles mediante una conversación natural.

Funcionalidades

Funcionalidad	Compatibilidad
Modo de retención cero (ZRM)	No compatible
Archivos adjuntos en herramientas	No compatible: las herramientas solo trabajan con texto

Configuración

Esta integración utiliza Google OAuth 2.0 para la autenticación. Autorizas a ElevenLabs a acceder a tu Google Calendar en tu nombre.

Haz clic en Connect en ElevenLabs

En la configuración de la integración de ElevenLabs, haz clic en Connect. Se te redirigirá a Google para autorizar el acceso.

Selecciona tu cuenta de Google

Elige la cuenta de Google a cuyos datos de calendario debe acceder tu agente. Si has iniciado sesión en varias cuentas de Google en el navegador, selecciona la correcta.

Autoriza el acceso al calendario

Revisa los permisos solicitados y haz clic en Allow. La integración solicita acceso para gestionar eventos en calendarios de tu propiedad, ver tu lista de calendarios y consultar la información de disponibilidad.

Ámbitos de OAuth

La integración solicita los siguientes ámbitos de Google OAuth 2.0:

Ámbito	Finalidad
`calendar.events.owned`	Crear, leer, actualizar y eliminar eventos en calendarios de tu propiedad.
`calendar.calendarlist.readonly`	Ver la lista de calendarios accesibles desde tu cuenta (nombres e ID).
`calendar.freebusy`	Consultar la disponibilidad entre calendarios sin revelar detalles de eventos.

Cómo funciona

El agente programa reuniones mediante llamadas a herramientas para avanzar por el proceso de reserva. Las pestañas siguientes muestran un resumen general y un prompt de sistema detallado.

Resumen general

Prompt de sistema detallado

Descubre calendarios

El agente lista los calendarios accesibles para identificar el adecuado para la programación. Para la mayoría de usuarios, es el calendario principal.

Comprueba la disponibilidad

El agente comprueba la disponibilidad:

Utiliza la herramienta google_calendar_check_availability para consultar bloques de tiempo ocupados.
Verifica si la hora solicitada está libre.
Sugiere alternativas si la hora solicitada entra en conflicto con un evento existente.
Confirma la hora seleccionada con la persona que llama.

Recopila los datos del asistente

Una vez acordada una hora, el agente:

Recopila el nombre completo y la dirección de correo electrónico del asistente.
Confirma el correo electrónico repitiéndoselo a la persona que llama.
Verifica la información de la zona horaria.

Crea el evento

El agente:

Llama a la herramienta google_calendar_create_event con los datos confirmados.
Añade opcionalmente un enlace de Google Meet si se solicita videoconferencia.
Confirma la creación del evento e informa al asistente de que recibirá una invitación de calendario.

Herramientas del agente

Al añadir herramientas de Google Calendar a un agente, dispondrás de las siguientes herramientas integradas:

Herramienta	Descripción
`google_calendar_check_availability`	Comprueba la disponibilidad de uno o varios calendarios en un intervalo de tiempo. Devuelve bloques de tiempo ocupados para que el agente pueda encontrar horarios libres. Úsala antes de crear eventos para evitar conflictos.
`google_calendar_create_event`	Crea un evento nuevo en un Google Calendar con asistentes, ubicación y videoconferencia de Google Meet opcionales. Envía notificaciones por correo electrónico a todos los participantes.
`google_calendar_list_events`	Lista los próximos eventos de un calendario dentro de un intervalo de tiempo, ordenados por hora de inicio. Admite búsqueda de texto libre en resúmenes, descripciones, ubicaciones y datos de asistentes.
`google_calendar_list_calendars`	Lista todos los calendarios accesibles para la cuenta de Google conectada. Devuelve los nombres e ID de los calendarios. Úsala para descubrir qué calendario usar antes de comprobar la disponibilidad o crear eventos.