> 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-voz-ia/acciones-del-agente/agendar-citas-con-dapta-calendars.md). # Agendar citas con dCal Deja que tu Agente de Voz ofrezca tus horarios libres reales y agende la cita durante la llamada. Agrega la acción Agendamiento con Dapta Calendars, elige la reunión y cada reserva queda en tu cuenta Tu Agente de Voz puede agendar reuniones por ti durante la llamada. Lee tu disponibilidad real en **dCal**, ofrece los horarios que de verdad están libres y agenda el que elige quien llama. Sin transferir la llamada y sin enviar un link de reserva después. {% embed url="" %} {% file src="/files/CNcEtC4HptyjsNJbpntE" %} Basta una acción, **Agendamiento con Dapta Calendars**, que consulta la disponibilidad y agenda. No hay ninguna API key que pegar ni ningún ID de tipo de evento 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í](/dapta-docs-es/dcal/dcal.md), y [Deja que tu agente de Dapta agende](/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 Voz en la **infraestructura de voz actual de Dapta** | La acción solo aparece ahí. Si no la ves, escríbele a soporte. | | 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. | {% hint style="info" %} **Agendamiento con Dapta Calendars** reemplaza las dos acciones de [Cal.com](/dapta-docs-es/agentes-de-voz-ia/acciones-del-agente/cal.com.md), *Verificar disponibilidad del calendario* y *Reserve en el calendario*, con una sola acción que hace las dos cosas. No necesitas agregarlas, ni tener una cuenta de Cal.com. {% endhint %} *** ## Configúrala **Paso 1:** Abre tu Agente de Voz y entra a la pestaña **Configuración**. Abre **Acciones del agente**, haz clic en **+ Agregar** y elige **Agendamiento con Dapta Calendars**.
El menú Agregar de las Acciones del agente de un Agente de Voz, con Agendamiento con Dapta Calendars en la lista
*** **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. Si ya usas dCal con un Agente de Texto, aquí aparecen las mismas reuniones: una sola cuenta de dCal sirve a todos los agentes del workspace. {% 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 dice 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 quien llama. Un espacio a las 9:00 en un calendario de Bogotá lo ofrece a las 8:00 un agente configurado con Ciudad de México. {% hint style="success" %} **¿Quieres los horarios en la zona horaria de cada persona?** Agrega en las **Instrucciones importantes** del agente que debe preguntar dónde está la persona antes de ofrecer horarios. Cuando quien llama dice dónde está, el agente usa esa zona para los horarios que ofrece y para la confirmación que lee. {% 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 la persona confirmó. Lo que no puede saber es tu regla de negocio: > Ofrece horarios solo después de que la persona confirme qué servicio necesita. Pide su nombre completo antes de agendar.
El formulario Agendar citas con una reunión elegida, la zona horaria por defecto y las instrucciones adicionales
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**. Dapta guarda la acción en el agente de inmediato y muestra *Acciones actualizadas*. Aparece en **Acciones del agente** con el nombre de su función de disponibilidad, `check_dapta_calendar_availability`. Esa sola fila es toda la acción: consultar y agendar juntos. 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.
La lista Acciones del agente con end_call y check_dapta_calendar_availability
{% hint style="warning" %} Un agente agenda **una** reunión, pero **Agendamiento con Dapta Calendars** sigue en el menú **+ Agregar** después de agregarla. Si la eliges otra vez se abre un formulario en blanco, y al guardarlo **reemplaza** el agendamiento que ya tenía el agente. Para cambiar la reunión, la zona horaria o las instrucciones, usa el **ícono de lápiz** de la fila que ya existe. {% endhint %} *** ## Pruébala Abre la pestaña **Probar agente** y empieza una **llamada web**. Pide una cita como lo haría quien llama, por ejemplo *"¿Puedo agendar una reunión el martes en la mañana?"*. Elige uno de los horarios que te ofrece el agente y dale tu nombre y tu correo. El agente agenda la cita y te lee la confirmación. {% hint style="warning" %} Las llamadas de prueba agendan **citas reales** en tu cuenta de dCal, y la confirmación llega al correo que digas. Cancela tus citas de prueba en dCal cuando termines. {% endhint %} *** ## Qué hace el agente durante la llamada 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 dice en voz alta. Siempre consulta antes de nombrar un horario. | | **Agenda la cita** | Cuando la persona confirma un horario, agenda exactamente ese espacio y le lee la confirmación. | Una llamada normal va así: la persona pregunta, el agente consulta y ofrece, la persona elige, el agente agenda. Si pregunta por otro día, el agente vuelve a consultar. Para agendar, el agente necesita el **nombre completo** y el **correo** de la persona. Si el correo ya llega con la llamada, por ejemplo como variable del contacto en una secuencia de llamadas salientes, el agente lo usa. Si no, le pide que lo diga, y no agenda sin él. Cuando se crea la reserva, dCal envía un **correo de confirmación con una invitación de calendario** a la persona 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 a la persona, 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 Voz** | Qué reunión agenda este agente, la zona horaria en la que dice los 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 llamada. Nunca pegas ni administras una credencial. {% hint style="info" %} Los **Agentes de Texto** agendan igual, con la misma cuenta, las mismas reuniones y la misma disponibilidad. Mira [Agendar citas con dCal](/dapta-docs-es/agentes-de-texto/agendar-citas-con-dapta-calendars.md) para Agentes de Texto. {% endhint %} *** ## Requisitos y límites | | Detalle | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Disponibilidad** | Agentes de Voz en la infraestructura de voz actual de Dapta. Si **Agendamiento con Dapta Calendars** no aparece en el menú **+ Agregar**, escríbele a soporte. | | **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** | Unos días por defecto, y hasta **15 días** cuando la persona pregunta por una fecha más lejana. | | **Para agendar** | Nombre completo y correo de la persona. El agente pide el correo cuando la llamada no lo trae. | | **Reprogramar y cancelar** | Desde el correo de confirmación o en dCal, no a través del agente. | *** ## Solución de problemas
No veo Agendamiento con Dapta Calendars en el menú + Agregar La acción está disponible para Agentes de Voz en la infraestructura de voz actual de Dapta. Si tu workspace todavía no se ha movido a ella, la opción no aparece: escríbele a soporte y te contamos en qué punto estás.
El agente dice que no tiene horarios disponibles Revisa en dCal que la reunión tenga horario laboral en los días que pide la persona. Ten presente también la antelación mínima de 2 horas: en una llamada para el mismo día, las dos horas siguientes quedan fuera a propósito.
El agente ofreció horarios en la zona horaria equivocada Los horarios usan la **Zona horaria por defecto** de la acción, salvo que la persona diga dónde está durante la llamada. 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 de quien llama, agrega en las **Instrucciones importantes** que el agente debe preguntarle dónde está antes de ofrecer horarios.
Mi configuración de agendamiento desapareció después de agregar la acción otra vez Elegir **Agendamiento con Dapta Calendars** otra vez y guardar reemplaza la acción que tenía el agente. Abre la fila con el **ícono de lápiz**, vuelve a elegir la reunión, la zona horaria y las instrucciones, y haz clic en **Guardar**.
La lista de reuniones está vacía, o la reunión que elegí desapareció 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**.
"Se requieren permisos de administrador" 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.
*** ## Páginas relacionadas {% content-ref url="/pages/4sjQF2Y5oUTsnmgjhhKJ" %} [Acciones del Agente](/dapta-docs-es/agentes-de-voz-ia/acciones-del-agente.md) {% endcontent-ref %} {% content-ref url="/pages/xbnRPLCuSKODU3jyjJA9" %} [Agendar citas con dCal](/dapta-docs-es/agentes-de-texto/agendar-citas-con-dapta-calendars.md) {% endcontent-ref %} {% content-ref url="/pages/ifV5SHzhs3WLn002HiJP" %} [Deja que tu agente de Dapta agende](/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-voz-ia/acciones-del-agente/agendar-citas-con-dapta-calendars.md?ask=&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.