> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/agendar-citas-con-dapta-calendars.md).

# Agendar citas con dCal

Deja que tu Agente de Texto ofrezca tus horarios libres reales y agende la cita dentro del chat. Agrega la acción Agendar citas, elige la reunión y cada reserva queda en tu cuenta de dCal.

Tu Agente de Texto puede agendar reuniones por ti mientras conversa. Lee tu disponibilidad real en **dCal**, ofrece los horarios que de verdad están libres y agenda el que tu cliente elige. El cliente nunca sale de la conversación ni recibe un link de reserva.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-c8b90c1df7c32d84f7889ec933c36460ac8da5d2%2Ftext-agents-calendars.mp4?alt=media>" %}

{% file src="/files/WlgGfiDnKbqKsJ4q0AO8" %}

Basta una acción, **Agendar citas (Dapta Calendars)**. No hay ninguna API key que pegar ni ningún ID que copiar: Dapta conecta el agente con la cuenta de dCal de tu workspace por ti.

{% hint style="info" %}
**¿Recién llegas a dCal?** dCal es el producto de reservas gratis de Dapta, en [app.dcal.ai](https://app.dcal.ai), donde están tus reuniones (allí se llaman *eventos*), tu horario laboral y tus reservas. Mira [Inicia aquí](https://docs.dapta.ai/dapta-docs-es/dcal/dcal.md), y [Deja que tu agente de Dapta agende](https://docs.dapta.ai/dapta-docs-es/dcal/dapta-agents.md) para saber cómo preparar tu evento y qué ves en dCal cuando el agente agenda.
{% endhint %}

***

## Antes de empezar

| Necesitas                                                              | Por qué                                                                                                                                                                       |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Un **Agente de Texto V2**                                              | La acción es parte de los Agentes de Texto actuales.                                                                                                                          |
| Ser **administrador** o **dueño** de la cuenta de dCal de tu workspace | Solo ellos pueden conectarle un agente. Si eres miembro, la acción te lo indica, y un compañero administrador puede agregarla por ti.                                         |
| Una **reunión** en dCal                                                | La reunión es lo que el agente agenda: un nombre y una duración, como *Llamada de descubrimiento · 30 min*. Si todavía no tienes una, la acción la crea contigo en el Paso 2. |

***

## Configúrala

**Paso 1:** Abre tu Agente de Texto y entra a **Configuración**. Abre **Acciones del agente**, haz clic en **+ Agregar Nueva Acción** y elige **Agendar citas (Dapta Calendars)**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-b61fa8390785e2c286091c0d059394dce49e7cc8%2Ftext-agents-calendars-01-add-action.png?alt=media" alt="El menú Agregar Nueva Acción de un Agente de Texto, con Agendar citas (Dapta Calendars) al final de la lista"><figcaption></figcaption></figure>

***

**Paso 2:** Elige la **Reunión** que el agente va a agendar.

{% tabs %}
{% tab title="Ya tienes reuniones" %}
Elige una de la lista **Reunión**. La lista se lee en vivo desde tu cuenta de dCal, así que todos tus agentes y todos tus canales agendan sobre la misma disponibilidad.
{% endtab %}

{% tab title="Tu primera reunión" %}
Si tu cuenta de dCal todavía no tiene reuniones, la acción crea la primera contigo antes de mostrarte el formulario:

1. Escribe el **Nombre de la reunión**, por ejemplo `Llamada de descubrimiento`.
2. Elige la **Duración**.
3. Haz clic en **Siguiente**.

Dapta crea la reunión y, además, un horario laboral de lunes a viernes de 9:00 a 17:00 en tu zona horaria. Esto lo haces una sola vez. Después puedes crear más reuniones y cambiar tu horario en dCal.
{% endtab %}
{% endtabs %}

***

**Paso 3:** Revisa la **Zona horaria por defecto**. Es la zona en la que el agente ofrece y confirma los horarios, y se llena desde tu navegador la primera vez que abres la acción.

Si es distinta a la zona horaria de tu calendario, tu horario laboral se queda como está y el agente lo convierte para el cliente. Un espacio a las 9:00 en un calendario de Bogotá se ofrece a las 8:00 en un agente configurado con Ciudad de México.

{% hint style="success" %}
**¿Quieres los horarios en la zona horaria de cada cliente?** Agrega en las **Instrucciones importantes** del agente que debe preguntarle al cliente dónde está antes de ofrecer horarios. Cuando el cliente dice dónde está, el agente usa esa zona para los horarios que ofrece y para la confirmación.
{% endhint %}

***

**Paso 4 (opcional):** En **Instrucciones adicionales**, escribe *cuándo* puede el agente ofrecer horarios y agendar. El *cómo* ya lo sabe: consultar el calendario primero, nunca inventar un horario y agendar solo el horario que el cliente confirmó. Lo que no puede saber es tu regla de negocio:

> Ofrece horarios solo después de que el cliente diga qué servicio necesita. Pide su nombre completo antes de agendar.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-808532d362c5779a77c7af290f8af937bd477119%2Ftext-agents-calendars-02-action-form.png?alt=media" alt="El formulario Agendar citas con una reunión elegida, la zona horaria por defecto y las instrucciones adicionales"><figcaption></figcaption></figure>

Lo que escribas aquí se **suma** a las reglas de agendamiento que el agente ya trae y nunca las reemplaza. Aun con instrucciones, el agente solo ofrece horarios que encontró en tu calendario.

***

**Paso 5:** Haz clic en **Guardar**. La acción aparece en **Acciones del agente** como **Agendar citas (Dapta Calendars)**. Con el **ícono de lápiz** cambias la reunión, la zona horaria o las instrucciones, y con el **ícono de papelera** le quitas el agendamiento al agente.

Después haz clic en **Guardar Agente** y **Publicar**. El agendamiento corre en el agente publicado, así que publica antes de probarlo.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-8f40c05987aeb8fa8ef3c4173e31abec0db371cf%2Ftext-agents-calendars-03-action-saved.png?alt=media" alt="La lista Acciones del agente con end_conversation y Agendar citas (Dapta Calendars)"><figcaption></figcaption></figure>

{% hint style="info" %}
Un agente agenda **una** reunión, así que tiene una sola acción de agendamiento. Cuando ya está agregada, **Agendar citas (Dapta Calendars)** deja de aparecer en **+ Agregar Nueva Acción**: para cambiarla usa el ícono de lápiz.
{% endhint %}

***

## Pruébala en el Playground

{% hint style="info" %}
**Publica primero.** En un borrador (**Playground (Draft)**), el agente todavía no ve tu calendario y responde sin horarios reales.
{% endhint %}

**Paso 1:** Abre la pestaña **Probar agente** y pide una cita como lo haría un cliente, por ejemplo *"¡Hola! ¿Puedo agendar una limpieza el próximo martes en la mañana?"*. El agente consulta tu calendario y responde con horarios libres reales.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-001a5aaa8f4d4de9467007fbe7f85f1f359cf401%2Ftext-agents-calendars-04-times-offered.png?alt=media" alt="El agente ofreciendo horarios libres para el día que pidió el cliente"><figcaption></figcaption></figure>

**Paso 2:** Elige uno de los horarios y dale al agente tu nombre y tu correo. El agente agenda la cita y te la confirma.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-c6d5856c3734bfb16ab668664a7a9f66f5a7a060%2Ftext-agents-calendars-05-booked.png?alt=media" alt="El agente confirmando la cita con su fecha, su hora y el correo al que llega la confirmación"><figcaption></figcaption></figure>

{% hint style="warning" %}
El Playground agenda **citas reales** en tu cuenta de dCal, y la confirmación llega al correo que escribas. Cancela tus citas de prueba en dCal cuando termines.
{% endhint %}

***

## Qué hace el agente en una conversación

La acción le da a tu agente dos habilidades, y él decide cuál usar según la conversación:

| El agente…                     | Qué pasa                                                                                                                                                                                  |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Consulta la disponibilidad** | Lee los espacios libres de tu reunión en dCal y los ofrece en la zona horaria por defecto, o en la del cliente cuando este dijo dónde está. Siempre consulta antes de nombrar un horario. |
| **Agenda la cita**             | Cuando el cliente confirma un horario, agenda exactamente ese espacio y responde con la confirmación.                                                                                     |

Una conversación normal va así: el cliente pregunta, el agente consulta y ofrece, el cliente elige, el agente agenda. Si el cliente pregunta por otro día, el agente vuelve a consultar.

Para agendar, el agente necesita el **nombre completo** y el **correo** del cliente, y pide el que le falte. El teléfono es opcional.

Cuando se crea la reserva, dCal envía un **correo de confirmación con una invitación de calendario** al cliente y a ti, y la cita aparece en tu cuenta de dCal.

{% hint style="info" %}
**Si alguien toma el espacio primero**, el agente se lo dice al cliente, vuelve a consultar y ofrece horarios nuevos. Nunca ofrece el espacio que se acaba de ocupar.
{% endhint %}

***

## Qué vive dónde

El agendamiento usa dos productos. Saber cuál es dueño de qué te dice dónde cambiar cada cosa.

| Producto                 | Es dueño de                                                                                                                                                            |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **dCal** (`app.dcal.ai`) | Tu cuenta de agendamiento: reuniones, horario laboral, sincronización de calendarios y todas las reservas. Una cuenta por workspace, compartida por todos tus agentes. |
| **Tu Agente de Texto**   | Qué reunión agenda este agente, la zona horaria en la que ofrece horarios y tu regla de cuándo puede ofrecerlos o agendar.                                             |

La acción conecta los dos: lee tus reuniones mientras la configuras, y lee tu disponibilidad y crea las reservas mientras corre una conversación. Nunca pegas ni administras una credencial.

{% hint style="info" %}
Los **Agentes de Voz** agendan igual, con la misma cuenta, las mismas reuniones y la misma disponibilidad. Mira [Agendar citas con dCal](https://docs.dapta.ai/dapta-docs-es/agentes-de-voz-ia/acciones-del-agente/agendar-citas-con-dapta-calendars.md) para Agentes de Voz.
{% endhint %}

***

## Requisitos y límites

|                            | Detalle                                                                                                                           |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Versión del agente**     | Agentes de Texto V2.                                                                                                              |
| **Permisos**               | Un administrador o dueño de la cuenta de dCal del workspace configura la acción. Una vez guardada, el agente funciona para todos. |
| **Acciones por agente**    | Una, ligada a una reunión. Para agendar reuniones distintas, usa agentes distintos.                                               |
| **Horario laboral**        | Sale de tu cuenta de dCal: lunes a viernes de 9:00 a 17:00, a menos que lo cambies.                                               |
| **Antelación mínima**      | **2 horas** por defecto, así que el agente no ofrece un espacio antes de eso. Puedes cambiarla por reunión en dCal.               |
| **Qué tan adelante**       | El agente consulta las fechas que pide el cliente, hasta dos meses adelante en una sola consulta.                                 |
| **Para agendar**           | Nombre completo y correo del cliente. El teléfono es opcional.                                                                    |
| **Reprogramar y cancelar** | Desde el correo de confirmación o en dCal, no a través del agente.                                                                |

***

## Solución de problemas

<details>

<summary>Agendar citas no aparece en el menú + Agregar Nueva Acción</summary>

El agente ya tiene una acción de agendamiento: búscala en **Acciones del agente** y cámbiala con el **ícono de lápiz**. Si el agente no tiene ninguna, revisa que sea un Agente de Texto V2.

</details>

<details>

<summary>En el Playground, el agente dice que no puede consultar la disponibilidad</summary>

El agente todavía es un borrador: el encabezado del Playground dice **Playground (Draft)**. Haz clic en **Guardar Agente** y **Publicar**, y vuelve a probar.

</details>

<details>

<summary>El agente dice que no tiene horarios disponibles</summary>

Revisa en dCal que la reunión tenga horario laboral en los días que pide el cliente. Ten presente también la antelación mínima de 2 horas: en una solicitud para el mismo día, las dos horas siguientes quedan fuera a propósito.

</details>

<details>

<summary>El agente ofreció algunos horarios, pero el cliente quería uno más tarde</summary>

Cuando un día tiene muchos espacios libres, el agente ofrece una selección y no todos. Pídele un horario más tarde y vuelve a consultar esa parte del día.

</details>

<details>

<summary>El agente ofreció horarios en la zona horaria equivocada</summary>

Los horarios usan la **Zona horaria por defecto** de la acción, salvo que el cliente diga dónde está durante la conversación. Una ciudad escrita en el prompt del agente o en la descripción de tu empresa no se usa. Para trabajar siempre en la zona del cliente, agrega en las **Instrucciones importantes** que el agente debe preguntarle dónde está antes de ofrecer horarios.

</details>

<details>

<summary>La lista de reuniones está vacía, o la reunión que elegí desapareció</summary>

La lista se lee en vivo desde dCal. Si la reunión se eliminó allá, la acción la quita y te pide elegir de nuevo, así el agente nunca apunta a una reunión que ya no existe. Elige otra, o crea una en dCal, y luego haz clic en **Guardar Agente** y **Publicar**.

</details>

<details>

<summary>"Se requieren permisos de administrador"</summary>

Eres miembro, no administrador ni dueño, de la cuenta de dCal de tu workspace. Pídele a un administrador o dueño que agregue la acción. Una vez guardada, el agente funciona para todos.

</details>

***

## Páginas relacionadas

{% content-ref url="/pages/QtOll9itCfFAaC14cRLr" %}
[Acciones del Agente](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/acciones-del-agente.md)
{% endcontent-ref %}

{% content-ref url="/pages/vp12sugSCvuCXuTc4JaO" %}
[Playground](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/playground.md)
{% endcontent-ref %}

{% content-ref url="/pages/C56W0yarNuBqHUhP5zdx" %}
[Agendar citas con dCal](https://docs.dapta.ai/dapta-docs-es/agentes-de-voz-ia/acciones-del-agente/agendar-citas-con-dapta-calendars.md)
{% endcontent-ref %}

{% content-ref url="/pages/ifV5SHzhs3WLn002HiJP" %}
[Deja que tu agente de Dapta agende](https://docs.dapta.ai/dapta-docs-es/dcal/dapta-agents.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/agendar-citas-con-dapta-calendars.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
