Saltar a la navegación
ConfigurarIntegraciones

Google Calendar

Conecta tus agentes de ElevenLabs con la programación de Google Calendar

Descripción general

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 consultar la disponibilidad, crear, actualizar y eliminar eventos con asistentes y conferencias opcionales de Google Meet, listar próximos eventos y descubrir calendarios accesibles mediante conversaciones naturales.

Funcionalidades

FuncionalidadCompatibilidad
Modo de retención cero (ZRM)No compatible
Archivos adjuntos en toolsNo compatible: las tools solo trabajan con texto

Advertencia de seguridad

Advertencia de seguridad: google_calendar_update_event y google_calendar_delete_event son tools con privilegios. Se ejecutan con acceso completo al calendario de la cuenta de Google conectada, no solo con acceso a los eventos creados por tu agente. Cualquiera que pueda hablar con el agente puede modificar o cancelar cualquier evento de ese calendario, incluidos eventos que no haya creado, porque el agente puede buscar IDs de eventos con google_calendar_list_events. Una confirmación en el prompt del sistema es una indicación para el modelo, no un control de seguridad.

Activa estas tools solo en agentes con la autenticación activada o cuando el ID del evento proceda de una fuente de confianza. No las añadas a agentes públicos. Los asistentes siempre reciben una notificación cuando se actualiza o elimina un evento.

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.

1

Haz clic en Conectar en ElevenLabs

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

2

Selecciona tu cuenta de Google

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

3

Autoriza el acceso al calendario

Revisa los permisos solicitados y haz clic en Permitir. 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:

ÁmbitoFinalidad
calendar.events.ownedCrear, leer, actualizar y eliminar eventos en calendarios de tu propiedad.
calendar.calendarlist.readonlyVer la lista de calendarios accesibles para tu cuenta (nombres e IDs).
calendar.freebusyConsultar la disponibilidad en calendarios sin exponer los detalles del evento.

Cómo funciona

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

1

Descubrir 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.

2

Comprobar disponibilidad

El agente comprueba la disponibilidad mediante:

  • El uso de la tool google_calendar_check_availability para consultar bloques de tiempo ocupados.
  • La verificación de si la hora solicitada está libre.
  • La sugerencia de alternativas si la hora solicitada entra en conflicto con un evento existente.
  • La confirmación de la hora seleccionada con la persona que llama.
3

Recopilar datos de los asistentes

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.
4

Crear el evento

El agente:

  • Llama a la tool 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 del calendario.

Tools del agente

Cuando añades tools de Google Calendar a un agente, están disponibles las siguientes tools integradas:

ToolDescripción
google_calendar_check_availabilityConsulta la disponibilidad de uno o varios calendarios dentro de un intervalo de tiempo. Devuelve bloques de tiempo ocupados para que el agente pueda encontrar huecos libres. Úsala antes de crear eventos para evitar conflictos.
google_calendar_create_eventCrea un nuevo evento en Google Calendar con asistentes, ubicación y conferencias de Google Meet opcionales. Envía notificaciones por correo electrónico a todos los participantes.
google_calendar_list_eventsLista los próximos eventos de un calendario dentro de un intervalo de tiempo, ordenados por hora de inicio. Admite búsquedas de texto libre en resúmenes, descripciones, ubicaciones y datos de asistentes de eventos.
google_calendar_update_eventCon privilegios. Actualiza cualquier evento del calendario, por ejemplo, para reprogramarlo o cambiar su título, ubicación o asistentes. Solo se modifican los campos proporcionados. Se notifica a los asistentes.
google_calendar_delete_eventCon privilegios. Elimina cualquier evento del calendario y lo cancela para todos los asistentes. Usa primero la lista de eventos para encontrar el ID del evento. Para eventos recurrentes, usa el ID de una ocurrencia o su recurringEventId (toda la serie).
google_calendar_list_calendarsLista todos los calendarios accesibles para la cuenta de Google conectada. Devuelve nombres e IDs de calendarios. Úsala para descubrir a qué calendario dirigirte antes de consultar la disponibilidad o crear eventos.

Enlaces útiles