> 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/dcal/key-concepts.md).

# Conceptos clave

Definiciones simples de las palabras que usan el panel y la documentación de dCal, desde evento, enlace de reservas y horario de disponibilidad hasta solicitudes, reservas temporales, equipos, roles y

Esta página define las palabras que usa el resto de la documentación de dCal. Léela una vez y el panel, tu página de reservas y tus correos tendrán mucho más sentido.

***

## Evento

Un evento es un tipo de reunión que la gente puede reservar contigo, como "Llamada inicial", "Demo" o "Consulta". El panel los muestra en **Eventos**. Cada evento tiene un título, un identificador (la última parte de su dirección), una sola duración en minutos, un lugar opcional, un horario de disponibilidad, preguntas, recordatorios y algunas reglas: antelación mínima, con cuánta anticipación se puede reservar, márgenes antes y después, intervalo entre horarios, cupos, y si confirmas tú cada reserva.

Un evento es **personal** (tú eres el anfitrión) o un **evento de equipo** (pertenece a un equipo y agenda a uno o varios de sus miembros). Los eventos nuevos empiezan con una antelación mínima de 2 horas, así que nadie puede reservar una hora que empiece antes de eso.

Cada evento tiene una sola duración. Para ofrecer una versión de 30 minutos y otra de 60, crea dos eventos.

Un evento se ve en tu página de perfil salvo que lo marques como **Oculto**. Un evento oculto no tiene página pública: su dirección muestra "Página no encontrada", y solo un [enlace de invitación de un solo uso](https://docs.dapta.ai/dapta-docs-es/dcal/events/one-off-links.md) puede reservarlo.

Mira [Eventos](https://docs.dapta.ai/dapta-docs-es/dcal/events.md).

## Enlace de reservas y página de perfil

En el panel, **Tu enlace de reservas** es tu **página de perfil**: una sola dirección que muestra todos tus eventos visibles. Cada evento tiene además su propia página, que abre directo en el calendario de ese evento.

Las páginas de reservas viven en `book.dcal.ai`, aparte de tu panel en `app.dcal.ai`. Todos los enlaces que te da dCal usan `book.dcal.ai`. Los enlaces anteriores que empiezan con `app.dcal.ai` siguen funcionando y llevan a los invitados a la misma página en `book.dcal.ai`.

| Página                                        | Dirección                                                                    |
| --------------------------------------------- | ---------------------------------------------------------------------------- |
| Tu página de perfil ("Tu enlace de reservas") | `book.dcal.ai/{código de cuenta}/{identificador}`                            |
| La página de un evento                        | `book.dcal.ai/{código de cuenta}/{identificador}/{identificador del evento}` |
| La página de un equipo                        | `book.dcal.ai/{código de cuenta}/team/{identificador del equipo}`            |

| Parte de la dirección        | Qué es                                                                                                                                  | Dónde la cambias                                                                           |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Código de cuenta**         | Seis caracteres que identifican tu workspace, creados automáticamente. Con un enlace personalizado, el nombre que eliges toma su lugar. | **Ajustes** > **Página de reservas** (enlace personalizado, para clientes que pagan Dapta) |
| **Identificador público**    | Tú, dentro del workspace. dCal lo crea a partir de tu nombre la primera vez que entras: Jane Doe recibe `jdoe`.                         | **Ajustes** > **General** > **Identificador público**                                      |
| **Identificador del evento** | El evento, completado a partir de su título cuando lo creas.                                                                            | **Enlace del evento**, en **General**                                                      |

Cuando tienes exactamente un evento visible, tu enlace de perfil abre ese evento directamente. Para mostrar el perfil incluso así, activa **Mostrar siempre mi perfil, aunque tenga un solo tipo de evento** en **Ajustes** > **Página de reservas**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-6d98f834c1430e71e3624ecdbc7055762410e949%2Fdcal-key-concepts-01-profile-page.png?alt=media" alt="La página de perfil de Jane Doe con las iniciales JD, su nombre y su bio, y tres eventos: Reunión de 30 minutos y Llamada inicial (30 min) y Consulta (60 min)"><figcaption><p>Una página de perfil muestra cada evento visible. Cada fila abre la página propia de ese evento.</p></figcaption></figure>

> **⚠️ Nota:** Cambiar tu identificador público o el identificador de un evento cambia la dirección. Los enlaces que ya compartiste con el identificador anterior dejan de abrir, así que comparte el enlace nuevo después del cambio. Un enlace personalizado funciona distinto: tu código anterior sigue funcionando y lleva a los visitantes a la dirección nueva.

## Horario de disponibilidad

Un horario es un conjunto de horas semanales, excepciones por fecha y una zona horaria. Las horas semanales pueden tener varios rangos por día, por ejemplo de 09:00 a 12:00 y de 14:00 a 18:00. Una excepción por fecha reemplaza las horas semanales en una fecha específica. Los horarios se gestionan en **Disponibilidad**.

Cada anfitrión recibe un horario llamado **Working hours** (así, en inglés), de lunes a viernes de 09:00 a 17:00, la primera vez que abre el panel, con la zona horaria de su navegador. Es tu horario predeterminado. Elige el origen de sus horas en **General** > **Horario para reservar**.

Mira [Define tus horarios](https://docs.dapta.ai/dapta-docs-es/dcal/calendars-and-availability/set-your-hours.md).

En **General** > **Horario para reservar**, un evento personal puede seguir **Mi horario de trabajo**, usar **Un horario guardado** o tener **Horario propio de este evento**. Este último guarda rangos semanales y zona horaria solo para ese evento, sin crear otro horario en **Disponibilidad**.

Un asistente también puede usar [create\_event](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md#create_event) para poner un evento directamente en tu calendario con título y horario propios. Ese evento no tiene tipo de evento ni enlace para reservar.

## Calendario conectado

Un calendario conectado es una cuenta completa de Google Calendar o de Outlook / Microsoft 365 que vinculas en **Calendarios**. Puedes conectar varias cuentas, y cada una tiene dos ajustes:

| Ajuste                         | Qué hace                                                                                                                                              |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verificar conflictos**       | Las horas ocupadas en este calendario bloquean nuevas reservas. Viene activado en cada cuenta que conectas.                                           |
| **Añadir eventos nuevos aquí** | Las reuniones reservadas se escriben en este calendario. Solo un calendario puede recibir eventos; la primera cuenta que conectas recibe este ajuste. |

Sin un calendario conectado, dCal igual recibe reservas, pero solo ve tus reservas de dCal, no tus otras reuniones, y no puede crear enlaces de reunión en línea.

Mira [Conecta tu calendario](https://docs.dapta.ai/dapta-docs-es/dcal/calendars-and-availability/connect-a-calendar.md).

## Reserva y sus estados

Una reserva es una reunión que alguien reservó en uno de tus eventos. La página **Reservas** muestra cada reserva con uno de cuatro estados:

| Estado        | Qué significa                                                                          |
| ------------- | -------------------------------------------------------------------------------------- |
| **aceptada**  | La reunión está en pie, ya sea de inmediato o después de que confirmaste la solicitud. |
| **pendiente** | Una solicitud que espera que la confirmes o la rechaces.                               |
| **cancelada** | Tú o el invitado la cancelaron.                                                        |
| **rechazada** | Rechazaste la solicitud.                                                               |

Reprogramar no es un estado: una reserva que se movió sigue **aceptada**, con su nueva hora.

Mira [Reservas](https://docs.dapta.ai/dapta-docs-es/dcal/bookings.md).

## Solicitud

Una solicitud es una reserva en un evento personal que tiene **Requiere confirmación** activado. El invitado ve **Reserva solicitada**, y la reserva queda **pendiente** hasta que haces clic en **Confirmar** o **Rechazar** en la página **Reservas**. Un agente de IA que conectes a dCal también puede confirmarla o rechazarla por ti. Nada se escribe en tu calendario hasta que confirmas.

Mientras una solicitud espera, su horario queda bloqueado para todos los demás. Una solicitud no vence sola, así que respóndela pronto.

Mira [Pedir confirmación](https://docs.dapta.ai/dapta-docs-es/dcal/events/require-confirmation.md).

## Reserva temporal

Cuando un invitado elige una hora en un evento personal de un solo cupo, dCal le guarda esa hora por 10 minutos mientras llena sus datos, para que nadie más la tome. El formulario muestra **Reservado hasta las** y la hora. Volver atrás o elegir otra hora libera la reserva temporal, y cerrar la página la deja vencer a los 10 minutos. Los eventos de equipo y los eventos grupales no hacen reservas temporales.

Un agente de IA que conectes a dCal puede apartar una hora de la misma forma en un evento de un solo anfitrión, por unos 10 minutos, mientras confirma los datos con la persona, y luego reservarla. Mira [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md).

## Equipo y métodos de programación

Un equipo es un grupo de personas de tu workspace que comparten reservas. Tiene su propia página pública y sus propios eventos de equipo. Cuando guardas un evento de equipo, cada miembro del equipo pasa a ser uno de sus anfitriones, y cada evento de equipo usa un método de programación:

| Método                        | Quién asiste                                                                                                                                                                                                                            | Qué horarios se ofrecen                                                                                                                                                                                                                                 |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Por turnos**                | Un anfitrión por reserva: entre los anfitriones libres dentro de su horario de trabajo, el de prioridad más alta, y luego según el peso. Con **Distribución** en **Distribución equitativa**, el que tenga menos reservas de ese evento | Los horarios en que algún anfitrión está libre dentro de su horario de trabajo. Con **Distribución equitativa**, un anfitrión que tiene 3 o más reservas por encima del anfitrión con menos reservas no ofrece horarios hasta que los demás lo alcancen |
| **Colectiva**                 | Todos los anfitriones                                                                                                                                                                                                                   | Solo los horarios en que todos están libres dentro de su horario de trabajo                                                                                                                                                                             |
| **Turnos con anfitrión fijo** | Los anfitriones fijos más uno por turnos                                                                                                                                                                                                | Los horarios en que cada anfitrión fijo y al menos otro anfitrión están libres dentro de su horario de trabajo                                                                                                                                          |

Solo los propietarios y los administradores crean equipos y eventos de equipo. Mira [Equipos](https://docs.dapta.ai/dapta-docs-es/dcal/teams.md).

## Workspace

Tu workspace de dCal se crea a partir de tu workspace de Dapta. Todas las personas que entran a dCal desde el mismo workspace de Dapta comparten un solo workspace de dCal y el mismo código de cuenta en sus enlaces. Las personas que invitas por correo también pueden unirse, y conservan su propio workspace; quien está en varios workspaces pasa de uno a otro con el selector de workspaces.

| Compartido por todo el workspace                                                                                                                                                           | Propio de cada anfitrión                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| Miembros y roles, equipos y eventos de equipo, el kit de marca, el ajuste de la marca de Dapta, el enlace personalizado, los ajustes de correos, HubSpot, los webhooks y las claves de API | Tus eventos, tus horarios de disponibilidad, tus calendarios conectados y el diseño de tu página de reservas |

Mira [Workspaces](https://docs.dapta.ai/dapta-docs-es/dcal/account/workspaces.md).

## Roles

Cada persona del workspace tiene un rol:

| Rol               | Qué puede hacer                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Propietario**   | Todo lo que hace un administrador, más transferir la propiedad. La primera persona de un workspace que entra a dCal pasa a ser su propietario.                                                                                                                                                                                                                                                                            |
| **Administrador** | Gestiona a los miembros (excepto a los propietarios), los eventos, horarios y reservas de todos, los equipos y eventos de equipo, el kit de marca y los ajustes del workspace: **Notificaciones**, **Miembros** e **Integraciones**, además de **Conecta tu agente**, **Herramientas** y **API y webhooks** en el menú de la izquierda, donde se conecta un agente de IA y se gestionan las claves de API y los webhooks. |
| **Miembro**       | Gestiona sus propios eventos, horarios, reservas, calendarios y página de reservas.                                                                                                                                                                                                                                                                                                                                       |

Las personas de tu workspace de Dapta que entran después del propietario se unen como miembros. Las personas que invitas reciben un correo de invitación, se unen cuando la aceptan y reciben el rol que elegiste. Mira [Miembros y roles](https://docs.dapta.ai/dapta-docs-es/dcal/account/members-and-roles.md) e [Invita a tu equipo](https://docs.dapta.ai/dapta-docs-es/dcal/account/invite-teammates.md).

## Kit de marca

El kit de marca es un solo estilo para todo el workspace: logo, color de acento, fondo claro u oscuro, tipografía, esquinas, botones y estilo de tarjeta. Los propietarios y los administradores lo guardan en **Ajustes** > **Página de reservas** > **Kit de marca**.

Las páginas de equipo siempre llevan el kit de marca actual. Tus propias páginas lo toman solo cuando haces clic en **Aplicar kit de marca** en el estudio de tu página de reservas. Eso copia el kit en tu página una vez; los cambios posteriores del kit no cambian tu página hasta que lo vuelvas a aplicar.

Mira [Kit de marca](https://docs.dapta.ai/dapta-docs-es/dcal/design/brand-kit.md).

## Enlace de gestión

El enlace de gestión es un enlace privado que dCal le da a tu invitado en sus correos y en la pantalla de confirmación (**Gestiona tu reserva**). Abre una página donde el invitado puede reprogramar a un horario de las próximas tres semanas, o cancelar, en cualquier momento antes de que empiece la reunión. Una solicitud que sigue pendiente solo se puede cancelar desde ahí.

Cada reprogramación crea un enlace de gestión nuevo, así que el enlace de un correo anterior deja de funcionar. El correo más reciente siempre trae el vigente.

> **💡 Tip:** En un evento que requiere confirmación, el enlace de gestión llega en el correo "Solicitud recibida" del invitado. Cuando confirmas, el correo de confirmación del invitado no lo repite, así que el enlace del correo "Solicitud recibida" es el que debe guardar para reprogramar o cancelar.

Mira [Reprogramar y cancelar](https://docs.dapta.ai/dapta-docs-es/dcal/bookings/reschedule-and-cancel.md).

## Enlace de invitación de un solo uso

Un enlace de invitación de un solo uso reserva un evento una sola vez y luego deja de funcionar. Los creas en la sección **Enlaces de invitación de un solo uso** del evento, con **Crear enlace de invitación**. Un enlace sigue activo hasta que se usa o lo revocas, y cancelar la reserva no lo reactiva.

En un evento visible, un enlace de invitación no limita nada, porque cualquiera con el enlace normal puede reservar igual. Marca el evento como **Oculto** para que los enlaces de invitación sean la única vía.

Mira [Enlaces de invitación de un solo uso](https://docs.dapta.ai/dapta-docs-es/dcal/events/one-off-links.md).

## Evento grupal

Un evento grupal es un evento cuyo campo **Cupos / horario (grupo)** es 2 o más. Varias personas pueden reservar el mismo horario hasta que se llenan sus cupos. En la página de reservas cada horario muestra cuántos cupos quedan, o **Lleno**.

Mira [Eventos grupales](https://docs.dapta.ai/dapta-docs-es/dcal/events/group-events.md).

## Relacionado

* [Inicia aquí](https://docs.dapta.ai/dapta-docs-es/dcal/dcal.md)
* [Primeros pasos](https://docs.dapta.ai/dapta-docs-es/dcal/getting-started.md)
* [Lo que ven tus invitados](https://docs.dapta.ai/dapta-docs-es/dcal/what-guests-see.md)
* [Cómo se calculan los horarios libres](https://docs.dapta.ai/dapta-docs-es/dcal/calendars-and-availability/how-open-times-work.md)


---

# 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/dcal/key-concepts.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.
