Base de conocimiento de GetMyBot

Reuniones y Google Calendar

Conecta Google Calendar para que el agente de IA ofrezca horarios y, si le das permiso, reserve, cambie o cancele citas.

En esta página

El agente de IA puede proponer horas libres y reservar una cita en Google Calendar. Por ejemplo, puede encontrar una consulta de treinta minutos en un día laborable. Según los permisos que le des, también podrá cambiar o cancelar una reserva.

En Agentes IA → Calendario, conecta una cuenta, crea un tipo de reunión y comprueba los horarios disponibles. Después, activa en el agente solo las acciones de calendario que necesites. Cada intervalo libre se llama franja horaria o slot.

Por ahora solo se puede conectar Google Calendar. Los tipos de reunión y las reservas usan la misma interfaz de GetMyBot, pero aún no se admiten otros proveedores.

Conectar una cuenta

Pulsa Conectar Google Calendar y concede el acceso en la ventana de Google. GetMyBot solicita permiso para consultar calendarios, eventos y horas ocupadas. Si no terminas la conexión en cinco minutos, empieza de nuevo.

La conexión usa un valor state de un solo uso, vinculado al bot y a tu cuenta, una comprobación PKCE y una dirección de retorno fija. state caduca a los cinco minutos.

El permiso para renovar el acceso se guarda cifrado y no vuelve a mostrarse. En la tarjeta solo verás el nombre de la cuenta y uno de estos estados: Conectado, Acceso caducado, Desconectado o Error. Si caduca, conecta la cuenta otra vez.

No podrás pulsar Desconectar calendario mientras un agente activo use herramientas de calendario. GetMyBot te mostrará cuáles son. Primero desactiva esas herramientas o pausa al agente.

Tipos de reunión

Un tipo de reunión define lo que el agente puede ofrecer. Configura:

  • Nombre: aparece en tus informes y en el evento del cliente.
  • Calendario: elige uno de la cuenta conectada. Su identificador se guarda cifrado y no vuelve a mostrarse; al editar el tipo tendrás que elegirlo de nuevo.
  • Duración: de 5 a 480 minutos.
  • Zona horaria: un nombre IANA, por ejemplo Europe/Berlin. Determina cómo se interpretan los horarios siguientes.
  • Horas disponibles: entre 1 y 28 intervalos semanales con horas HH:MM. No deben solaparse. Si un intervalo termina antes de empezar, se entiende que pasa de la medianoche.
  • Antelación mínima: de 0 a 1440 minutos. No se aceptan reservas que empiecen antes.
  • Hasta cuántos días se puede reservar: de 1 a 366 días.
  • Pausa antes y pausa después: de 0 a 1440 minutos cada una, reservados alrededor de la reunión.
  • Tipo activado: el agente solo puede ofrecer y reservar los tipos activados.

Mostrar horas disponibles consulta el calendario conectado y enseña las franjas reales de la próxima semana, no una simulación.

Cómo se elige una hora

La disponibilidad combina el horario semanal, las horas ocupadas de Google Calendar, las pausas y las reservas que ya existen para esta conexión. Se buscan posibles comienzos cada 15 minutos. Se muestran 10 opciones por defecto y nunca más de 20.

Las horas se muestran en la zona horaria del cliente, pero se guardan en UTC. Así, un cambio de horario de verano puede cambiar la hora local mostrada sin cambiar el instante reservado.

Para evitar reservas duplicadas:

  1. El bot vuelve a comprobar la hora elegida justo antes de reservar.
  2. Guarda una reserva pendiente con una clave de idempotencia. Repetir la misma solicitud no crea otra reunión.
  3. Crea el evento en el calendario y, si hace falta, añade un enlace de videollamada.
  4. Si Google tarda demasiado o devuelve un error temporal, busca primero la reserva por esa clave antes de repetir la operación.
  5. Confirma la reserva. El ID del evento de Google y el enlace de la reunión se guardan cifrados.

Cambiar y cancelar una cita siguen las mismas comprobaciones. Si otra persona ocupó la hora elegida, la operación falla en lugar de duplicar la reserva.

Los estados posibles son Pendiente, Confirmada, Cambiada, Cancelada y Error.

Dar acceso al agente

En el editor del agente, abre Herramientas permitidas y activa las acciones necesarias:

  • Mostrar horas disponibles
  • Reservar una reunión
  • Cambiar una reunión
  • Cancelar una reunión

Cada herramienta activada necesita al menos un tipo de reunión actual y activado. Si no lo hay, no podrás activar al agente. En este momento, un agente activo solo puede ejecutar herramientas de calendario; las otras herramientas aún no están disponibles en ejecución.

El modelo de IA no puede elegir por sí mismo otro calendario, otro cliente ni enviar una petición libre. Propone una acción dentro de los campos permitidos; GetMyBot añade el bot, el suscriptor y los tipos de reunión autorizados desde el servidor. Cada llamada tiene un límite de 15 segundos y una clave para evitar duplicados. En el registro, los enlaces de reunión y datos de contacto se ocultan.

Informes

En Agentes IA → Métricas verás las acciones de calendario y los resultados de las reservas junto a las demás cifras del agente. Las reservas mismas están en Agentes IA → Calendario.

Si algo no funciona

  • Hay herramientas activas, pero ningún tipo de reunión activado: crea uno o activa uno existente antes de activar al agente.
  • No se pudo cargar la lista de calendarios: quizá tengas que conectar de nuevo la cuenta. Como solución temporal, puedes introducir el identificador de la conexión manualmente.
  • No hay horas libres en la próxima semana: revisa el horario semanal, la antelación mínima, las pausas y las horas ocupadas en el calendario.
  • No puedes borrar un tipo de reunión: lo usa una herramienta de un agente activo.

Más información