> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryvo.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Google Calendar

> Conecta tu Google Calendar para que tu agente consulte huecos libres y agende citas durante la conversación.

Conectar Google Calendar es lo que convierte a tu agente en alguien que **cierra la cita en la misma llamada**, en vez de prometer que alguien te marca después. El agente ve tu disponibilidad real, propone horarios que de verdad están libres, crea el evento y le manda la invitación al cliente.

Es la integración que más cambia el resultado de una conversación: quien cuelga con fecha y hora ya no se va a buscar a otro proveedor.

## Qué necesitas antes de empezar

* Una cuenta de **Google** (personal o de Google Workspace) con acceso al calendario que quieres que use tu agente.
* Plan **Starter** o superior, con el módulo Engine activo. Si tu plan no alcanza, la pantalla de Integraciones te lo dice y te lleva a **Ver planes**.
* Conectar la app es una decisión de la cuenta, no de la persona: quien la conecta la deja disponible para todos los agentes de tu equipo.

## Cómo conectarla

<Steps>
  <Step title="Abre Configuración › Integraciones">
    En el portal, entra a **Configuración** y después a **Integraciones**. Busca la tarjeta de **Google Calendar**.
  </Step>

  <Step title="Da clic en Conectar app">
    Se abre la pantalla de autorización de Google en una ventana nueva. La tarjeta de Ryvo queda mientras tanto en **En curso**.
  </Step>

  <Step title="Elige la cuenta y acepta los permisos">
    Selecciona la cuenta de Google del calendario que quieres usar y acepta. Si tu organización usa Google Workspace con restricciones, puede que un administrador tenga que aprobarlo.
  </Step>

  <Step title="Vuelve a Ryvo">
    Al terminar regresas solo a la pantalla de Integraciones y la tarjeta pasa a **Conectada**, con la fecha desde la que quedó activa. Google Calendar no te pide nada más.
  </Step>
</Steps>

## Lo que tu agente puede hacer ya conectada

| Acción                     | Qué hace en la conversación                                                                                               |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Buscar horarios libres** | Consulta qué huecos están libres antes de proponer nada. Tu agente nunca ofrece un horario que no vio disponible aquí.    |
| **Agendar cita**           | Crea el evento cuando la persona confirmó día y hora, e incluye su correo como invitado para que le llegue la invitación. |
| **Buscar cita**            | Encuentra una cita ya agendada. Es el paso previo a mover o cancelar.                                                     |
| **Mover cita**             | Cambia la fecha, la hora o los datos de una cita que ya localizó.                                                         |
| **Cancelar cita**          | Cancela una cita, después de confirmarlo con la persona.                                                                  |

Estas acciones no se prenden solas. Entra a la integración con **Ver acciones** para verlas todas y enciende las que quieras en la sección [**Tools**](/es/guides/agents/tools) del constructor de cada agente. Un agente admite hasta **10 acciones de integración**: pon las que use de verdad, no todas.

## Qué hacer si algo falla

| Lo que ves                                            | Qué pasó                                                                          | Qué hacer                                                                                                                           |
| ----------------------------------------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| La tarjeta se quedó en **En curso**                   | Cerraste la ventana de Google antes de terminar, o Google todavía no nos confirmó | Da **Comprobar de nuevo**. Si sigue igual, da **Conectar app** otra vez y completa la autorización hasta el final                   |
| **La cuenta dejó de responder. Vuelve a conectarla.** | Le quitaste el acceso a Ryvo desde tu cuenta de Google, o la contraseña cambió    | Da **Reconectar**. Ryvo revoca el acceso viejo y abre el OAuth desde cero, así que la autorización nueva sí reemplaza a la anterior |
| El agente propone horarios que ya estaban ocupados    | La acción **Buscar horarios libres** no está prendida en ese agente               | Ábrelo en el constructor, sección **Tools**, y enciéndela. Sin ella el agente adivina                                               |