# Agendar en Calendario
Permite que tu agente programe citas directamente en tu calendario durante una conversación telefónica. Una vez que el usuario confirma su interés y proporciona la información necesaria, el agente puede crear la cita automáticamente sin interrupciones en el flujo de la llamada.
Esta función trabaja en conjunto con Check Availability para ofrecer una experiencia completa de programación: primero consulta horarios disponibles y luego agenda la cita seleccionada.
**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 agendar en tu calendario
#### Paso 2: Accede a la Configuración
* Una vez dentro del agente, dirígete a la pestaña **Settings**.
* Dentro de Settings, busca y haz clic en **Agent Actions** para acceder a las acciones disponibles para tu agente.
#### **Paso 3:** Agrega la Función Book on the calendar
* Se desplegará un menú con las opciones disponibles. Haz clic en **Add** y luego selecciona **Book on the calendar** de la lista de opciones.
#### **Paso 4:** Completa la configuración
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)*”*.
* **Name:** Asigna un nombre descriptivo (ej: "book\_appointment")
* **Instructions:** Define cómo el agente debe manejar el proceso de agendamiento
* **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:** Zona horaria para las citas
#### 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 agendar citas en diferentes calendarios, puedes crear múltiples acciones especificando en cada una a qué calendario específico debe programarse la cita. Esto es útil para separar diferentes tipos de servicios o equipos de trabajo.
### Ejemplos Adicionales para Book Appointment
* **Para agendar reuniones** "Una vez que el usuario seleccione un horario, confirma todos los detalles (nombre completo, teléfono, email, fecha y hora) antes de crear la cita. Después de agendar exitosamente, confirma que la cita ha sido programada y menciona que recibirá una confirmación por email con todos los detalles.”
* **Para Servicios de Salud Mental:** "Para agendar una sesión de terapia, solicita: nombre completo, teléfono, email y si es su primera sesión. Pregunta si prefiere sesión presencial o virtual. Después de confirmar la cita, menciona nuestras políticas de cancelación (24 horas de anticipación) y que recibirá formularios de admisión por email."
* **Para Servicios Educativos:** "Al programar una sesión de tutoría, confirma: nombre del estudiante, grado/nivel, materia específica, teléfono y email de contacto. Pregunta si necesitan materiales especiales. Después de agendar, informa que la sesión será de 60 minutos y que pueden reprogramar con 12 horas de anticipación."
* **Para Servicios Inmobiliarios:** "Para agendar una visita a propiedad, recopila: nombre completo, teléfono, email, tipo de propiedad de interés y presupuesto aproximado. Confirma la dirección de la propiedad a visitar. Después de programar, menciona que la visita durará aproximadamente 30 minutos y que recibirá la dirección exacta por mensaje."
* **Para Servicios Veterinarios:** "Para agendar una cita veterinaria, confirma: nombre del propietario, teléfono, email, nombre y especie de la mascota, y motivo de la consulta. Pregunta la edad aproximada del animal. Después de agendar, recuerda que deben traer el carnet de vacunas y que lleguen 10 minutos antes para el check-in."
---
# 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/agendar-en-calendario.md?ask=
```
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.