# Revisar Disponibilidad de Calendario

Esta función se integra directamente con [Cal.com](https://cal.com/) para acceder a tu calendario en tiempo real para que tu agente consulte automáticamente la disponibilidad y proporcione horarios libres a los usuarios durante la conversación.

Con esta herramienta, tu agente puede responder preguntas como "¿Qué horarios tienes disponibles esta semana?" o "¿Cuándo puedes atenderme?" sin necesidad de transferir la llamada o solicitar que el usuario consulte externamente tu calendario.

**Nota:** *Para obtener tu API Key y Event Type ID de* [*Cal.com*](http://cal.com)*, consulta nuestra documentación “Cómo configurar* [*Cal.com*](http://cal.com)*”.*

### Guía Paso a Paso

#### Paso 1: Selecciona tu Agente

* Navega hasta la lista de agentes y selecciona el agente al que deseas añadir la acción de ver la disponibilidad de tu calendario.

#### Paso 2: Accede a la Configuración

* Una vez dentro del agente, dirígete a la pestaña **Settings**.
* Dentro de Settings, haz clic en **Agent Actions** para acceder a las acciones disponibles para tu agente.

<figure><img src="/files/UMwYHUWw97rYTU6MUhCA" alt=""><figcaption></figcaption></figure>

**Paso 3:** Agrega la Función Check Calendar Availability

* Se desplegará un menú con las opciones disponibles. Haz clic en **Add** y luego selecciona **Check Calendar Availability** de la lista de opciones.

<figure><img src="/files/2QA6M83wAsL5KzF8s04l" alt=""><figcaption></figcaption></figure>

**Paso 4:** Configura los campos requeridos

Para obtener tu API Key y Event Type ID, consulta nuestra documentación “*Cómo configurar* [*Cal.com*](http://cal.com)*”*.

* **Name:** Asigna un nombre descriptivo (ej: "check\_calendar\_availability")
* **Instructions:** Escribe cómo quieres que el agente maneje las consultas de disponibilidad.
* **API Key:** Ingresa tu clave API de [Cal.com](http://cal.com)
* **Event Type ID:** Especifica el ID del tipo de evento de [Cal.com](http://cal.com)
* **Timezone:** Configura la zona horaria (opcional)

<figure><img src="/files/Gl9lHEqOrwqJ6WnqHVa8" alt=""><figcaption></figcaption></figure>

#### Instrucciones Importantes para el Agente

Recuerda que cuando te refieras a fechas, siempre debes actualizar el timezone del lugar en donde te encuentras. Esto es importante para mantener claridad y consistencia en la comunicación.

Para dar contexto a la IA del tiempo actual debes incluir la siguiente variable en tu prompt: `{{current_time}}`, lo cual es una variable introducida por nosotros por defecto. Esta variable da contexto al agente del tiempo actual.

Si necesitas una zona horaria distinta, puedes especificarla usando `{{current_time_[timezone]}}`. Por ejemplo: `{{current_time_America/New_York}}`.

Nota: El \[timezone] debe estar en **formato IANA (Internet Assigned Numbers Authority).**

Algunas de las opciones disponibles son:

| Zona Horaria - Ciudad    | Formato para \[timezone] |
| ------------------------ | ------------------------ |
| Bogotá, Colombia         | America/Bogota           |
| Santiago, Chile          | America/Santiago         |
| La Paz, Bolivia          | America/La\_Paz          |
| Lima, Peru               | America/Lima             |
| Caracas, Venezuela       | America/Caracas          |
| Madrid, España           | Europe/Madrid            |
| Ciudad de Mexico, Mexico | America/Mexico\_City     |

### Configuración de Múltiples Calendarios

Si necesitas revisar la disponibilidad en diferentes calendarios, puedes crear múltiples acciones especificando en cada una qué calendario específico debe revisarse. Esto es útil para separar diferentes tipos de servicios o equipos de trabajo.

### Ejemplos Adicionales para Check Availability

* **Para agendar reuniones** "Cuando el usuario pregunte por disponibilidad, consulta el calendario y ofrece al menos 3 opciones de horarios en los próximos 7 días. Presenta las opciones de manera clara mencionando día, fecha y hora. Si no hay disponibilidad en el período solicitado, ofrece las próximas fechas disponibles."
* **Para Consultas:** "Cuando los pacientes consulten disponibilidad, revisa el calendario y ofrece horarios en días laborables entre 8:00 AM y 5:00 PM. Presenta máximo 4 opciones en un período de 2 semanas. Menciona que las citas tienen una duración de 30 minutos y pregunta si prefieren horarios de mañana o tarde."
* **Para Servicios Profesionales:** "Al consultar disponibilidad, verifica el calendario y proporciona opciones de reuniones de 1 hora. Ofrece horarios tanto presenciales como virtuales. Menciona que las reuniones presenciales son en nuestras oficinas del centro y las virtuales se realizan por Zoom. Pregunta cuál es su preferencia antes de mostrar los horarios."
* **Para Servicios de Belleza/Spa:** "Cuando pregunten por disponibilidad para \[tipo de servicio], consulta el calendario y ofrece horarios considerando la duración específica del tratamiento. Menciona que pueden elegir entre horarios de mañana (9:00 AM - 12:00 PM) o tarde (2:00 PM - 6:00 PM). Informa que necesitamos 24 horas de anticipación para reservas."
* **Para Servicios Técnicos:** "Cuando soliciten disponibilidad para soporte técnico, consulta el calendario y ofrece ventanas de tiempo de 2 horas (ej: 9:00-11:00 AM). Menciona que podemos agendar visitas tanto presenciales como remotas. Para visitas presenciales, confirma que cubrimos el área metropolitana."


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-voz-ia/acciones-del-agente/revisar-disponibilidad-de-calendario.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
