Google Calendar
Conecta un calendario y deja que tu agente ofrezca horarios libres y reserve citas, una recepción public-safe que nunca revela qué hay en tu calendario.
Conecta Google Calendar con un solo inicio de sesión de Google y tu agente se convierte en una recepción de reservas. Puede ofrecer a un visitante tus horarios disponibles y reservar uno, mientras que todo lo que revela o edita eventos reales permanece owner-only. Siete herramientas en total, divididas de forma clara para que un desconocido llegado desde el sitio web pueda reservar un horario sin ver nunca tu calendario.
Conectar
- Abre Integraciones y elige Google Calendar.
- Haz clic en Iniciar sesión con Google y concede acceso al calendario en la pantalla de consentimiento.
- La conexión se vincula a un solo agente, que ahora puede consultar la disponibilidad y aceptar reservas.
El verdadero problema son tus horarios de atención y tu zona horaria. La disponibilidad y las reservas están limitadas por los horarios de atención de la conexión; si no están configurados, el agente recurre a UTC y puede ofrecer horarios fuera de tu jornada real. Configura tus horarios y tu zona horaria antes de apuntar un agente público al calendario, o cada horario propuesto estará equivocado.
Herramientas
| Herramienta | Acceso | Tipo | Qué hace |
|---|---|---|---|
google_calendar_availability | Público seguro | Read | Consulta un rango de fechas y devuelve solo las franjas de tiempo libres por día, filtradas según tu horario de atención. Nunca expone los títulos ni los detalles de los eventos. |
google_calendar_book_appointment | Público seguro | Write | Reserva una cita. Valida que la franja solicitada esté dentro del horario de atención y siga libre, luego la crea, sin revelar ningún otro evento. |
google_calendar_working_hours | Solo propietario | Read | Devuelve el horario de atención configurado: la zona horaria y las horas de inicio y fin de cada día. |
google_calendar_list_events | Solo propietario | Read | Enumera los eventos reales (título, inicio, fin, estado, ubicación) de un rango de fechas. Revela los detalles de los eventos, a diferencia de la vista de libre/ocupado de la disponibilidad. |
google_calendar_create_event | Solo propietario | Write | Crea un evento a partir de un título y una hora de inicio. La duración predeterminada es de 30 minutos; la descripción, la ubicación y los asistentes son opcionales. |
google_calendar_update_event | Solo propietario | Write | Actualiza el título, la hora, la descripción, la ubicación o los asistentes de un evento existente. |
google_calendar_delete_event | Solo propietario | Write | Elimina un evento por su ID. |
Public-safe vs owner-only
Solo availability y book appointment son public-safe, la pareja de recepción pensada a propósito. La disponibilidad devuelve bloques de libre/ocupado sin títulos; la reserva confirma un solo horario y nada más. Ambas son seguras para que las active un visitante del sitio web.
Los otros cinco son owner-only, accesibles solo por ti y tu equipo: working_hours, list_events (que sí devuelve títulos y detalles de los eventos) y las tres mutaciones de eventos create / update / delete. Un desconocido que chatea con tu agente público puede reservar un horario, pero nunca puede leer lo que ya está reservado ni cambiar una entrada existente.
Ejemplo práctico
Un visitante le pregunta a tu agente del sitio web: "¿Tienes algo el jueves por la tarde?" El agente llama a google_calendar_availability, ve tus bloques libres dentro del horario y responde: "Tengo las 14:00, las 15:30 o las 16:00." El visitante elige las 15:30 y da un nombre; el agente llama a google_calendar_book_appointment, que vuelve a comprobar que la franja siga libre, la reserva y confirma, todo sin que el visitante vea nunca otra cita en tu calendario.
Límites y honestidad
- Solo lectura donde importa para los visitantes. La pareja pública solo puede leer libre/ocupado y agregar una reserva. Leer los detalles de los eventos o editarlos es owner-only por diseño.
- El horario y la zona horaria lo gobiernan todo. Las franjas se calculan a partir de tu horario de atención en tu zona horaria; una zona horaria sin configurar recurre a UTC de forma predeterminada. Consulta la nota sobre la conexión más arriba.
- Un agente por conexión. El calendario se vincula al agente al que lo conectas.
- Esta integración no envía recordatorios por SMS ni por correo electrónico, reserva la franja; las notificaciones son un asunto aparte.
Solución de problemas
- El agente ofrece horas raras o el día equivocado, el horario de atención o la zona horaria no están configurados, así que recurre a UTC de forma predeterminada. Configúralos y vuelve a probar.
- "Franja ya no disponible" al reservar, la herramienta de reserva revalida el estado en el momento de reservar; alguien tomó la franja entre la propuesta y la confirmación. Ofrece la siguiente libre.
- El visitante no puede ver una reserva pasada, es lo esperado. Enumerar eventos es owner-only; los agentes públicos nunca vuelven a leer el calendario.
FAQ
¿Puede un visitante del sitio web ver qué hay en mi calendario? No. Las herramientas públicas devuelven solo libre/ocupado y una confirmación de reserva. list_events es owner-only.
¿Puede el agente reprogramar o cancelar? Solo tus agentes orientados al propietario pueden hacerlo, update_event y delete_event son owner-only. Los visitantes públicos pueden reservar, no editar.
¿Es lo mismo que conectar Gmail o Drive? No, esas son superficies de Google separadas. Consulta Google Workspace.
Próximos pasos
- Reuniones y tomador de notas, graba y resume las llamadas que reservas
- Google Workspace, Gmail, Drive, Docs y Calendar juntos
- Habilidades del agente, cómo se vinculan las herramientas a un agente
- Vista general de las integraciones
Google Workspace
Un solo inicio de sesión con Google conecta Drive, Sheets y Docs, 14 herramientas para leer, crear y actualizar archivos. Gmail y Calendar se conectan por separado.
Reuniones y toma de notas
Envía un agente a una llamada de Google Meet, Microsoft Teams o Zoom para grabarla, transcribirla y resumirla, luego deja que responda preguntas sobre reuniones pasadas.