> ## 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 Calendly

> Conecta tu Calendly para que tu agente consulte disponibilidad real y reserve la cita durante la llamada.

Si tu equipo ya publica su disponibilidad en Calendly, conectarlo hace que tu agente reserve ahí mismo, sin mandar el link y esperar a que la persona lo abra. Consulta los horarios reales del tipo de cita que corresponde y deja la reserva hecha antes de colgar.

Es la forma más rápida de que tu agente agende respetando las reglas que ya configuraste en Calendly: duración, anticipación mínima y horarios de atención.

## Qué necesitas antes de empezar

* Una cuenta de **Calendly** con al menos un **tipo de evento** publicado. Sin tipos de evento no hay nada que reservar.
* Plan **Starter** o superior en Ryvo, con el módulo Engine activo.
* Algunas acciones de reserva de Calendly dependen del plan que tengas con ellos. Si tu cuenta es gratuita, revisa que tu tipo de evento permita reservas por API.

## 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 **Calendly**.
  </Step>

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

  <Step title="Autoriza">
    Acepta los permisos con la cuenta cuyos tipos de evento quieres usar.
  </Step>

  <Step title="Vuelve a Ryvo">
    Regresas solo a la pantalla de Integraciones y la tarjeta pasa a **Conectada**. Calendly no te pide nada más.
  </Step>
</Steps>

## Lo que tu agente puede hacer ya conectada

| Acción                     | Qué hace en la conversación                                                                               |
| -------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Ver tipos de cita**      | Lista los tipos de cita disponibles. Es lo primero que hace, para saber qué se puede agendar.             |
| **Buscar horarios libres** | Consulta los horarios disponibles de un tipo de cita. Tu agente nunca propone un horario que no vio aquí. |
| **Agendar cita**           | Reserva el horario que la persona confirmó, con su nombre y su correo.                                    |
| **Ver citas agendadas**    | Consulta las reservas existentes, para confirmarle a la persona cuándo es la suya.                        |

Las acciones se encienden una por una desde **Ver acciones** y la sección [**Tools**](/es/guides/agents/tools) del constructor, con un tope de **10 acciones de integración por agente**.

## Qué hacer si algo falla

| Lo que ves                                             | Qué pasó                                                                                                         | Qué hacer                                                                                         |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| La tarjeta se quedó en **En curso**                    | Cerraste la ventana de Calendly antes de terminar                                                                | Da **Comprobar de nuevo** y, si sigue igual, vuelve a dar **Conectar app**                        |
| El agente dice que no hay horarios disponibles siempre | El tipo de evento no tiene disponibilidad publicada, o la anticipación mínima de Calendly tapa los días cercanos | Revisa el tipo de evento en Calendly: horarios de atención, anticipación mínima y rango de fechas |
| **La cuenta dejó de responder. Vuelve a conectarla.**  | Revocaste el acceso desde Calendly                                                                               | Da **Reconectar**: Ryvo revoca lo viejo y abre la autorización desde cero                         |