Google Calendar

Disponibilidad de la función#

Google Calendar aún no está disponible de forma general. Hasta que se habilite, Agente → Acciones → Google Calendar muestra «próximamente» y la conexión no está disponible; un ajuste del agente no puede activarla. Cal.com sigue siendo una opción independiente.

Conectar un calendario#

Cuando esté habilitado, abre el panel de Google Calendar y elige Conectar. Inicia sesión en Google y revisa los permisos solicitados para los eventos del calendario y la disponibilidad libre/ocupado. Esta conexión es independiente del inicio de sesión en Make Agent Fast. El servidor almacena el refresh token cifrado; ni el panel ni el agente lo reciben.

Los scopes solicitados son calendar.events, calendar.freebusy y los no sensibles openid y email. El callback requiere un correo electrónico verificado y lo almacena cifrado para resolver primary al mismo ID de calendario que su escritura explícita con el correo. No se solicita ningún scope de perfil. Las conexiones antiguas sin correo verificado deben desconectarse y volver a conectarse antes de poder reservar.

Un agente usa un solo proveedor de calendario a la vez. Desconecta el proveedor existente antes de cambiar. Elige el ID del calendario (primary para el calendario principal de la cuenta conectada) y su zona horaria IANA, por ejemplo Asia/Seoul. Un calendario compartido debe ser accesible con los permisos de la cuenta conectada. Al desconectar, se revoca la autorización de Google y se elimina la conexión; no se cancelan los eventos existentes.

Definir el horario laboral#

Las conexiones nuevas no tienen horario laboral, por lo que no se ofrecerán franjas hasta que lo añadas. Añade ventanas de apertura y cierre para cada día laborable. Un día vacío se considera cerrado; varias ventanas que no se solapen permiten una pausa para comer. Los horarios se interpretan en la zona horaria seleccionada. Los ajustes se guardan automáticamente.

La disponibilidad es el horario laboral menos los bloques ocupados del calendario seleccionado, el margen, la antelación mínima y el horizonte. Define los horarios en la zona horaria prevista del calendario y revisa los cambios de horario de verano cuando corresponda. Que no haya franjas puede significar horario cerrado u horas ocupadas, y no necesariamente un error de conexión.

De la disponibilidad a una reserva#

El agente usa el mismo flujo find_slots y book_slot que Cal.com: ofrece hasta ocho horarios disponibles, recopila nombre y correo electrónico y una nota opcional, vuelve a comprobar la franja elegida y luego muestra una tarjeta de confirmación. Las ofertas y propuestas caducan a los 15 minutos; ninguna reserva la franja. Solo el toque del cliente en el botón autoriza la reserva. Un «sí» dicho durante una llamada en directo no puede reservarla.

Tras la confirmación, Google recibe un evento con un ID determinista vinculado a la ejecución de la acción y envía invitaciones a los asistentes. Un evento confirmado y validado genera un comprobante completado; los eventos provisionales permanecen pendientes. Si una franja ya está ocupada, solicita nuevos horarios y confirma de nuevo. Un resultado de red incierto se comprueba usando el mismo ID de evento; no consideres un tiempo de espera agotado como un éxito ni crees otra reserva a ciegas. Los cambios de configuración invalidan las ofertas y propuestas anteriores.

Para recibir un aviso cuando se libere un horario, usa un seguimiento con consentimiento. Antes de abrirlo a los clientes, verifica una reserva y su invitación reales en Google, prueba una franja ocupada y comprueba la desconexión y reconexión, así como el canal de mensajería previsto.