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

# La herramienta de calendario para agentes

> Qué puede consultar y modificar un agente de IA en el calendario, el título del evento y las preguntas adicionales

Una **Herramienta de calendario** le da a un agente de WhatsApp, SMS o voz (motor Aurora) una ventana al calendario. El agente lee horarios realmente libres — nunca los inventa — y agenda, mueve o cancela en nombre del cliente con el que habla. Se crea desde la biblioteca de herramientas del canal: **Chat → WhatsApp → Herramientas**, **Chat → SMS → Herramientas**, o la página de herramientas del agente de voz.

<Frame caption="Selector de tipo con Herramienta de calendario elegida">
  <img src="https://mintcdn.com/dialtu-0be120d3/UOZbFHLJBbw6lMHl/images/es/calendario/herramienta-selector-tipo.png?fit=max&auto=format&n=UOZbFHLJBbw6lMHl&q=85&s=83cc4360d660b0bbb6fc5e67c4447572" alt="Pantalla de creación de herramienta con la lista Tipo de herramienta (API, fin de chat, traspaso, plantilla de WhatsApp, integración, calendario, catálogo) y la opción Herramienta de calendario seleccionada, junto al panel de capacidades y el botón Crear herramienta." width="2880" height="1800" data-path="images/es/calendario/herramienta-selector-tipo.png" />
</Frame>

## Capacidades

<Frame caption="Capacidades del agente sobre el calendario">
  <img src="https://mintcdn.com/dialtu-0be120d3/UOZbFHLJBbw6lMHl/images/es/calendario/herramienta-capacidades.png?fit=max&auto=format&n=UOZbFHLJBbw6lMHl&q=85&s=cca6c8186af59ffebcdcffe4f8ef794d" alt="Editor de la herramienta clinic_calendar en la sección Capacidades de calendario, con los servicios donde puede reservar, el bloque Consultar información 5/6, el bloque de escritura 3/3 (Agendar, Reprogramar, Cancelar una cita) y Lista de espera 2/3, además del panel Resumen a la derecha." width="2880" height="1800" data-path="images/es/calendario/herramienta-capacidades.png" />
</Frame>

Marca lo que este agente puede hacer:

| Grupo                       | Capacidades                                                                                                                                                           | Predeterminado                                 |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| **Consultar información**   | Listar servicios · Listar profesionales · Listar tipos de cita · Consultar disponibilidad · Consultar disponibilidad de un profesional · Listar las citas del cliente | Listar profesionales, Consultar disponibilidad |
| **Modificar el calendario** | Agendar una cita · Reprogramar una cita · Cancelar una cita                                                                                                           | Agendar una cita                               |
| **Lista de espera**         | Consultar lista de espera · Agregar a lista de espera · Quitar de lista de espera                                                                                     | desactivadas                                   |

<Tip>
  *Agendar y reprogramar solo funcionan bien cuando el agente también puede consultar disponibilidad.* Mantenlas juntas.
</Tip>

El agente solo toca las citas del cliente que llama, identificado por su teléfono. Las reglas de reserva aplican igual que para una persona.

## Comportamiento

En la barra derecha:

| Ajuste                 | Rango                                | Predeterminado      |
| ---------------------- | ------------------------------------ | ------------------- |
| **Horarios a ofrecer** | 1–20                                 | 5                   |
| **Días a consultar**   | 1–30                                 | 7                   |
| Dónde puede agendar    | todos los servicios, o una selección | todos los servicios |

<Note>
  Si una lista de espera que alimenta este agente tiene un horizonte mayor que **Días a consultar**, la barra te avisa.
</Note>

## Título del evento y preguntas adicionales

<Frame caption="Título del evento con marcadores y vista previa">
  <img src="https://mintcdn.com/dialtu-0be120d3/UOZbFHLJBbw6lMHl/images/es/calendario/herramienta-titulo-preguntas.png?fit=max&auto=format&n=UOZbFHLJBbw6lMHl&q=85&s=783d6d0977801f8cf8db27e5cc833b64" alt="Sección Título del evento del editor de herramienta con la plantilla client.name · service.name, los marcadores disponibles, la vista previa Ana Pérez · Cardiología, el campo Instrucción de las notas y el inicio de Preguntas adicionales 3/12." width="2880" height="1800" data-path="images/es/calendario/herramienta-titulo-preguntas.png" />
</Frame>

**Título del evento** — una plantilla que se aplica a cada cita que agenda el agente, hasta 120 caracteres. Marcadores: `{client.name}` (predeterminado), `{client.first_name}`, `{client.last_name}`, `{client.email}`, `{client.phone}`, `{service.name}`, `{event_type.name}`, `{professional.name}`, `{summary}`, y `{field.<clave>}` por cada pregunta adicional. **Instrucción del resumen** le dice al agente qué poner en `{summary}`; **Instrucción de las notas** qué escribir en las notas de la cita (predeterminado: lo que dijo el cliente, en 1–3 frases).

<Frame caption="Preguntas adicionales que la IA recopila al agendar">
  <img src="https://mintcdn.com/dialtu-0be120d3/UOZbFHLJBbw6lMHl/images/es/calendario/herramienta-preguntas-extra.png?fit=max&auto=format&n=UOZbFHLJBbw6lMHl&q=85&s=0e1154911e5d81ac65ffd1b65c28d20f" alt="Sección Preguntas adicionales 3/12 del editor de la herramienta de calendario con los campos Motivo de consulta (Texto, obligatorio, field.motivo), EPS / Aseguradora (Opción, obligatorio, con opciones Sura, Sanitas, Compensar, Nueva EPS, Famisanar, Particular) y Primera vez (Sí / no)." width="2880" height="1800" data-path="images/es/calendario/herramienta-preguntas-extra.png" />
</Frame>

**Preguntas adicionales** — hasta 12 campos que el agente recoge antes de agendar:

| Propiedad       | Reglas                                                                                    |
| --------------- | ----------------------------------------------------------------------------------------- |
| **Etiqueta**    | ≤ 60 caracteres, se muestra en el detalle de la cita                                      |
| **Clave**       | `a-z`, dígitos, `_`; empieza por letra; ≤ 40 caracteres; algunos nombres están reservados |
| **Tipo**        | Texto · Correo · Teléfono · Documento de identidad · Sí / no · Opción (≤ 20 opciones)     |
| **Descripción** | ≤ 300 caracteres — la pista que usa el agente para preguntar                              |
| **Obligatorio** | Una respuesta obligatoria puede impedir la reserva; una opcional nunca la bloquea         |

Las respuestas aparecen en la cita bajo **Datos de la cita**, y la reserva queda marcada como **IA · WhatsApp** (o SMS / llamada) con un enlace **Ver conversación**.

## Qué no existe

* **Que Atlas cree herramientas de calendario** — Atlas puede adjuntar una existente, no crearla.
* **Agendar para un teléfono distinto** al de la conversación.

## Siguiente paso

<Card title="Solución de problemas" icon="wrench" href="/es/calendar/troubleshooting">
  Cuando una cita no llega a la agenda.
</Card>
