> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Google Calendar > Cómo conectar Google Calendar a un agente de ChatNorris para que consulte tu disponibilidad real, ofrezca horarios y cree la cita en tu calendario con invitación al visitante, y cómo configurar horarios, servicios, feriados y el evento. # Google Calendar Con la integración de Google Calendar, tu agente de ChatNorris agenda citas en tu calendario sin salir del chat. A diferencia de Cal.com y Calendly, aquí no hay una página de reservas externa: ChatNorris calcula los horarios libres con las reglas que defines y crea el evento directamente en tu calendario. El agente: * consulta la disponibilidad real de tu calendario principal; * le ofrece al visitante horarios libres, siempre con la zona horaria; * pide el nombre y el correo (y, si quieres, el teléfono) y espera un **sí explícito**; * crea la cita en tu calendario y Google le envía la invitación al visitante, con link de Google Meet si lo activas. Funciona en el widget web, WhatsApp, Instagram, Messenger, Telegram y Email. ## Requisitos * Una cuenta de ChatNorris con plan **Standard** o **Premium** (no está en Free). Puedes ver los planes en [chatnorris.ai/pricing](https://chatnorris.ai/pricing). * Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue [Crear un agente](https://docs.chatnorris.ai/guias/crear-agente-wizard.md). * Una cuenta de Google con el calendario donde quieres recibir las citas. Se usa su **calendario principal**. * Rol **Owner** o **Admin** en tu organización de ChatNorris. ## Conectar Google Calendar Cada agente se conecta a una cuenta de Google. **1. Abre el hub de Integraciones del agente** En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **Google Calendar**. **2. Haz clic en Conectar con Google** Se abre Google. Inicia sesión con tu cuenta de Google. **3. Acepta los dos permisos** Google te pide dos permisos de Calendar: ver tus horarios ocupados y crear eventos. Deja marcados los dos: si desmarcas alguno, la conexión no se guarda. **4. Vuelve a ChatNorris** La ficha de la integración muestra la cuenta conectada y la zona horaria del calendario. Con **Probar conexión** verificas el acceso cuando quieras. Sigue con [Configurar la Acción](#configurar-la-acción). > [!NOTE] > > ChatNorris solo ve los horarios ocupados de tu calendario principal, sin títulos ni detalles, y crea únicamente las citas que el visitante confirma. ## Configurar la Acción Conectar la cuenta no activa nada todavía. Solo puede haber una Acción de Google Calendar por agente. **1. Crea la Acción y define cuándo usarla** Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **Google Calendar**. En **Cuándo usar** describe cuándo el agente debe ofrecer horarios (por ejemplo, "cuando quieran agendar una evaluación"). Las reglas de seguridad (no inventar horarios, no confirmar por su cuenta) aplican siempre, aunque edites el texto; puedes volver al texto original con **Restaurar texto por defecto**. **2. Configura los horarios** En la sección **Horarios** defines cuándo se pueden agendar citas. ChatNorris cruza este horario con lo que ya está ocupado en tu calendario. **3. Revisa la vista previa y habilita la acción** En **Vista previa**, haz clic en **Ver próximos horarios** para ver los horarios que el agente ofrecería ahora con la configuración actual (aunque todavía no la hayas guardado). Para habilitar la acción necesitas la cuenta conectada y al menos un día con horario. > [!WARNING] > > **Recomendamos Claude Sonnet o superior** como modelo principal del agente (`Configuración → IA`). El agente debe ofrecer solo los horarios reales que entrega el sistema; los modelos más pequeños a veces inventan horarios o dan por agendada una cita cuando el visitante solo parece estar de acuerdo. ### Opciones de horario | Opción | Qué hace | | - | - | | **Zona horaria** | Por defecto, **la del calendario** conectado. Puedes elegir otra. | | **Horario por día** (lunes a domingo) | Para cada día, **desde** y **hasta**, o **Sin citas**. Por defecto: lunes a viernes de 09:00 a 18:00. | | **Duración de la cita** | Cuánto dura cada cita (por defecto, 30 min). Se oculta si agregas servicios. | | **Margen entre citas** | Tiempo libre antes y después de cada cita y de tus otros eventos (0 a 60 min). | | **Anticipación mínima** | Con cuánto tiempo de anticipación se puede agendar (desde **Sin anticipación** hasta 48 h; por defecto, 2 h). | | **Días hacia adelante** | Hasta cuántos días desde hoy se puede agendar (1 a 60; por defecto, 14). | | **Horarios cada** | Cada cuánto empieza un horario posible: 15, 30 o 60 min (09:00, 09:30…). | | **Horarios ofrecidos** | Cuántos horarios muestra el agente de una vez (3 a 8), repartidos entre días. | | **Pedir teléfono** | Además del nombre y el correo (que siempre se piden, porque ahí llega la invitación), el agente pide un teléfono de contacto. Está en la sección **Datos del visitante**. | ### Servicios con distinta duración La sección **Servicios** es opcional. Si ofreces citas de distinta duración (por ejemplo, un masaje de 30 y otro de 60 minutos), agrega cada servicio con su duración (hasta 20 servicios): * **Sin servicios**: todas las citas duran lo indicado en **Duración de la cita**. * **Con un solo servicio**: todas las citas usan su duración y el agente no pregunta cuál quiere. * **Con dos o más servicios**: el agente le pregunta al visitante qué servicio quiere y busca horarios de esa duración. ### Feriados y días cerrados * **No ofrecer horarios en feriados** (activado por defecto): se omiten los feriados públicos del **País**, que por defecto se deduce de la zona horaria. Puedes elegir otro país y una **Región** (o **Todo el país**). La sección muestra los **Próximos feriados**. * **Días cerrados**: días puntuales en que no atiendes (vacaciones, inventario o un feriado nuevo que todavía no aparece en la lista). Hasta 100 días. Si el visitante pide un día cerrado o feriado, el agente le avisa que ese día no se atiende y le ofrece lo más cercano. ### El evento en tu calendario En la sección **Evento** defines cómo se crea la cita: * **Título del evento**: por defecto "Cita con \{\{name}}". Variables: `{{name}}` (visitante), `{{email}}`, `{{service}}` (servicio elegido) y `{{agent}}` (nombre del agente). * **Agregar link de Google Meet**: la invitación incluye una videollamada de Meet. * **Mensaje al confirmar (opcional)**: el agente lo agrega cuando la cita queda agendada; por ejemplo, cómo llegar o qué traer. La cita se crea en el calendario principal de la cuenta conectada, **solo después de que el visitante confirma**, y Google le envía la invitación a su correo. ### Cómo agenda el visitante 1. Cuando la conversación calza con **Cuándo usar**, el agente consulta tu disponibilidad real y ofrece horarios libres (siempre indicando la zona horaria). 2. El agente pide el nombre y el correo (y el teléfono, si lo activaste), muestra un resumen y espera un **sí explícito** del visitante. Ver qué respuestas cuentan como confirmación en [Confirmaciones del visitante](https://docs.chatnorris.ai/guias/acciones.md#confirmaciones-del-visitante). 3. Antes de crear la cita, ChatNorris vuelve a revisar que el horario siga libre. Si alguien lo tomó entretanto, el agente ofrece horarios nuevos. En el **widget web**, en vez de una lista en texto, el visitante ve un **selector de día y hora**: elige un día y un horario, completa sus datos (precargados si ya los dejó en la conversación) y hace clic en **Confirmar cita**; ese botón es la confirmación. En **WhatsApp, Instagram, Telegram, Messenger y Email**, el agente ofrece los horarios como una lista en texto y el visitante confirma por escrito. > [!NOTE] > > En el **Playground** puedes probar todo el flujo, pero **nunca se crea una cita real** en tu calendario. ### Citas en Leads Los datos que el visitante ingresa en el selector del widget se guardan como su contacto: se crea o actualiza el **lead**, como con un Lead Form. Las citas agendadas por el agente aparecen en [Leads](https://docs.chatnorris.ai/guias/leads.md), en la columna **Cita** y en la sección **Citas** del detalle del lead, y puedes filtrar los leads **Con cita próxima**. Si borras el evento en Google Calendar, la cita figura como cancelada al abrir el lead. Si el agente también tiene la Acción [Pipedrive](https://docs.chatnorris.ai/guias/pipedrive.md) con **Registrar reuniones agendadas**, cada cita se registra además en el Lead de Pipedrive como actividad **Reunión**. ### Varias acciones de agenda en el mismo agente Google Calendar comparte el clasificador de agenda con [Cal.com](https://docs.chatnorris.ai/guias/cal-com.md) y [Calendly](https://docs.chatnorris.ai/guias/calendly.md): si un agente tiene más de una acción de agenda, se ofrece **una sola por respuesta**, la que mejor calza con lo que pidió el visitante. Distingue bien sus **Cuándo usar** para que acierte; el formulario te avisa si el agente tiene varias. Con una acción de agenda lista, pedir una reunión o una llamada no es un handoff, aunque el visitante nombre a un ejecutivo o asesor: el agente le ofrece horarios. Ver [Human Handoff](https://docs.chatnorris.ai/guias/acciones.md#human-handoff). ## Desconectar En `Agentes → [tu agente] → Integraciones → Google Calendar`, haz clic en **Desconectar**. Desconectar revoca el acceso en Google y apaga la Acción, sin borrar su configuración. Si Google revoca el acceso o desconectas la cuenta, el agente deja de ofrecer horarios y le dice al visitante que la agenda no está disponible. Vuelve a conectar la cuenta en Integraciones para reanudarla. ## Preguntas frecuentes > [accordion] Al conectar aparece "Faltan permisos" > > En la pantalla de Google dejaste desmarcado alguno de los dos permisos de Calendar. Vuelve a conectar y deja marcados ambos. > [accordion] Al conectar aparece "Google no entregó un acceso permanente" > > Quita ChatNorris en [myaccount.google.com/permissions](https://myaccount.google.com/permissions) y vuelve a conectar. > [accordion] ¿ChatNorris ve los títulos y detalles de mis eventos? > > No. Solo ve los horarios ocupados de tu calendario principal, sin títulos ni detalles, y crea únicamente las citas que el visitante confirma. > [accordion] ¿Puedo tener dos Acciones de Google Calendar en el mismo agente? > > No. Solo puede haber una por agente. Si necesitas agendas distintas, usa agentes separados o combina Google Calendar con [Cal.com](https://docs.chatnorris.ai/guias/cal-com.md) o [Calendly](https://docs.chatnorris.ai/guias/calendly.md), con un **Cuándo usar** distinto para cada una. > [accordion] ¿Se crean citas reales cuando pruebo en el Playground? > > No. En el Playground puedes probar todo el flujo, pero nunca se crea una cita real en tu calendario. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.