> 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/share/embed.md).

# Inserta dCal en tu sitio web

Pon tu página de reservas de dCal dentro de tu propio sitio web. Copia el código del diálogo Insertar en tu sitio, pégalo en WordPress, Webflow o HTML plano, deja que el marco ajuste su alto solo, cam

En lugar de mandar a tus visitantes a un enlace de dCal, puedes mostrar tu página de reservas dentro de una de tus propias páginas. Los invitados eligen un horario y reservan sin salir de tu sitio, y la reserva llega a tu panel y a tu calendario como cualquier otra.

***

## Consigue el código

**Paso 1:** Busca el botón **Insertar en tu sitio** (el ícono de código) de lo que quieres insertar:

| Para insertar                              | Dónde está el botón                                                              |
| ------------------------------------------ | -------------------------------------------------------------------------------- |
| Un evento                                  | **Eventos**, en la fila del evento, o arriba en la página de edición del evento. |
| Tu página de perfil, con todos tus eventos | **Ajustes** > **Página de reservas**, en **Perfil**.                             |
| Un evento de equipo                        | **Equipos**, entra al equipo, en la fila del evento.                             |

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-6edfbffac5e4121abb91e6a3bc9ee44d2342871c%2Fdcal-embed-01-embed-button.png?alt=media" alt="La fila de Llamada inicial en la página Eventos con el ícono Insertar en tu sitio marcado, junto a Copiar enlace"><figcaption><p>Cada evento tiene su propia inserción. El botón está junto a <strong>Copiar enlace</strong>.</p></figcaption></figure>

***

**Paso 2:** Se abre el diálogo **Insertar en tu sitio**. En **Color de acento**, deja **Usar el estilo de mi página de reservas** para que combine con tu página de reservas, o elige **Elegir un color para esta inserción** y escoge un color solo para esta inserción.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-4e294a1421b2ba1ce42904aabb85151f69e476a5%2Fdcal-embed-02-dialog.png?alt=media" alt="El diálogo Insertar en tu sitio con su texto de introducción y las opciones marcadas de Color de acento, Usar el estilo de mi página de reservas (elegida) y Elegir un color para esta inserción con una muestra de color"><figcaption><p>El color de acento es la única opción del diálogo. Todo lo demás sigue a tu página de reservas.</p></figcaption></figure>

***

**Paso 3:** Haz clic en **Copiar código**. El botón cambia a **Copiado**. Haz clic en **Listo** para cerrar el diálogo.

El código tiene dos partes: un `iframe` que muestra tu página de reservas y un script pequeño, `embed.js`, que ajusta el tamaño del marco. Se ve así, con tu propia dirección:

```html
<iframe data-dapta-calendars src="https://book.dcal.ai/k7m2xq/jdoe/intro-call?embed=1"
        title="Intro call" loading="lazy"
        style="width:100%;border:0;min-height:700px;"></iframe>
<script src="https://book.dcal.ai/embed.js" async></script>
```

| Parte                  | Para qué está                                                                                                                                            |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `?embed=1`             | Le dice a la página que corre dentro de tu sitio, así que quita el espacio exterior e informa su alto. Sin esto, los parámetros de más abajo se ignoran. |
| `data-dapta-calendars` | La marca que busca el script. Déjala: sin ella, el marco no cambia de tamaño.                                                                            |
| `title`                | El evento o tu nombre, que leen los lectores de pantalla. Cámbialo si quieres otra redacción.                                                            |
| `width:100%`           | La página de reservas toma el ancho del contenedor, así sigue siendo adaptable.                                                                          |
| `min-height:700px`     | El alto con el que empieza el marco, antes de que el script mida la página.                                                                              |
| `embed.js`             | Ajusta el marco al alto de la página. Una sola copia se encarga de todas las inserciones de tu página.                                                   |

Con un color de acento propio, la dirección termina también con el color, por ejemplo `?embed=1&amp;brand_color=%231a73e8`. `&amp;` es la forma de escribir `&` dentro de HTML, y `%23` significa `#`.

> **💡 Tip:** Los códigos que copiaste antes de que las páginas de reservas pasaran a `book.dcal.ai` tienen `app.dcal.ai`. Siguen funcionando tal como están: el marco nunca se manda a otra dirección. Copia el código otra vez cuando puedas, para que tu inserción tenga todo lo de esta página, incluidas las etiquetas de [Seguimiento y píxeles](https://docs.dapta.ai/dapta-docs-es/dcal/events/event-settings.md#seguimiento-y-pixeles).

***

**Paso 4:** Pega el código en tu página, donde debe aparecer la página de reservas.

* **WordPress:** edita la página, añade un bloque **HTML personalizado** y pega el código dentro.
* **Webflow:** añade un elemento **Embed**, pega el código en el editor de código y publica el sitio.
* **HTML plano, o cualquier otro creador de sitios web:** pégalo en el cuerpo de la página, dentro del contenedor que debe tener la página de reservas.

***

**Paso 5:** Abre tu página y revísala. La página de reservas debe quedar dentro de tu diseño, sin barra de desplazamiento propia. Haz una reserva de prueba para ver el flujo completo.

***

## El alto se ajusta solo

La página de reservas cambia de alto cuando el invitado pasa del calendario al formulario y a la confirmación. Cada vez, informa su nuevo alto y `embed.js` ajusta el marco, así que tu página crece y se achica con ella. Cuando llega el primer alto, el marco también puede quedar más bajo que 700 píxeles, para que una página corta no deje espacio vacío.

* Varias inserciones en una misma página ajustan cada una su propio alto. Deja una sola línea de `embed.js`.
* Si el script está bloqueado, la página de reservas igual carga y recibe reservas. El marco simplemente conserva el alto de `min-height`.

***

## Cambia el aspecto de una inserción

Una inserción se ve como tu página de reservas. Para cambiarla solo en una inserción, añade parámetros a la dirección de `src`, después de `?embed=1`, cada uno con `&` adelante. Equivalen a los ajustes de [Colores, fuentes y estilos predefinidos](https://docs.dapta.ai/dapta-docs-es/dcal/design/look-and-presets.md).

| Parámetro     | Valores                                                                                     | Equivale a este ajuste      |
| ------------- | ------------------------------------------------------------------------------------------- | --------------------------- |
| `brand_color` | Seis dígitos hexadecimales, por ejemplo `1a73e8` (o `%231a73e8`, donde `%23` significa `#`) | **Color de acento**         |
| `theme`       | `light`, `dark`                                                                             | **Tema**                    |
| `template`    | `classic`, `split`, `banded`                                                                | **Plantilla**               |
| `card_style`  | `outline`, `elevated`, `filled`                                                             | **Estilo de tarjeta**       |
| `corners`     | `sharp`, `soft`, `round`                                                                    | **Esquinas**                |
| `buttons`     | `rounded`, `pill`, `square`                                                                 | **Botones**                 |
| `density`     | `comfortable`, `compact`                                                                    | **Densidad**                |
| `font`        | `sans`, `rounded`, `serif`                                                                  | **Fuente**                  |
| `slot_layout` | `grid`, `list`                                                                              | **Disposición de horarios** |
| `day_group`   | `flat`, `boxed`                                                                             | **Agrupación por día**      |
| `slot_select` | `soft`, `solid`                                                                             | **Selección de horario**    |

Por ejemplo, una inserción oscura con los horarios en lista:

```html
<iframe data-dapta-calendars src="https://book.dcal.ai/k7m2xq/jdoe/intro-call?embed=1&amp;theme=dark&amp;slot_layout=list"
        title="Intro call" loading="lazy"
        style="width:100%;border:0;min-height:700px;"></iframe>
<script src="https://book.dcal.ai/embed.js" async></script>
```

* Un valor que dCal no reconoce se ignora. Los demás parámetros se aplican igual.
* Los parámetros solo cambian el aspecto. Los ajustes de tu página de reservas quedan como están, y tus enlaces compartidos no cambian.
* El diálogo lista todos los parámetros menos `theme`, que funciona igual.

***

## Qué páginas puedes insertar

| Página                                 | Dirección en `src`                                                                                   |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Tu página de perfil                    | `book.dcal.ai/{código de cuenta}/{identificador}?embed=1`                                            |
| Un evento                              | `book.dcal.ai/{código de cuenta}/{identificador}/{identificador del evento}?embed=1`                 |
| Una página de equipo                   | `book.dcal.ai/{código de cuenta}/team/{identificador del equipo}?embed=1`                            |
| Un evento de equipo                    | `book.dcal.ai/{código de cuenta}/team/{identificador del equipo}/{identificador del evento}?embed=1` |
| Un enlace de invitación de un solo uso | `book.dcal.ai/booking/{código}?embed=1`                                                              |

El diálogo te da el código para tu página de perfil, tus eventos y los eventos de equipo. Para una página de equipo, copia cualquier código y reemplaza la dirección de `src` por el enlace de la página del equipo, manteniendo `?embed=1`.

> **⚠️ Nota:** Inserta solo eventos visibles. La dirección de un evento oculto no abre, ni dentro de una inserción ni en ningún otro lugar. Mira [Tus enlaces y tu página de perfil](https://docs.dapta.ai/dapta-docs-es/dcal/share/your-booking-page.md#tu-pagina-de-perfil).

El panel de dCal y la página **Gestiona tu reserva** de tus invitados no se pueden mostrar dentro de otro sitio.

***

## Después de que un invitado reserva

* La confirmación se muestra dentro de tu página. **Gestiona tu reserva** se abre en una pestaña nueva.
* Si el evento tiene [Redirigir después de reservar](https://docs.dapta.ai/dapta-docs-es/dcal/events/event-settings.md#redirigir-despues-de-reservar), toda tu página va a esa dirección, no solo el marco. Si el navegador lo bloquea, la confirmación se queda en el marco con un enlace **Continuar**.
* Si el evento tiene [Seguimiento y píxeles](https://docs.dapta.ai/dapta-docs-es/dcal/events/event-settings.md#seguimiento-y-pixeles), las etiquetas corren dentro del marco, en la página de reservas insertada, no en tu página. Google Tag Manager, Google Analytics 4 y HubSpot corren solo en marcos de `book.dcal.ai`, así que un código anterior con `app.dcal.ai` tiene solo el píxel de Meta y PostHog. Google Analytics 4 cuenta las visitas y las reservas del marco en los navegadores que aceptan cookies particionadas, como Chrome.
* La reserva guarda las etiquetas UTM de la dirección de tu página, siempre que `embed.js` esté en tu página. Mira [Mide el origen de tus reservas](https://docs.dapta.ai/dapta-docs-es/dcal/share/your-booking-page.md#mide-el-origen-de-tus-reservas).

***

## Mensajes que recibe tu página

La página de reservas insertada le cuenta a tu página lo que hace el invitado, para que puedas contar cada paso en tu propia analítica. Cada mensaje tiene un `event` y un `payload`:

| `event`                             | Cuándo                                                                  | `payload`                                                         |
| ----------------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `dapta-calendars.event_type_viewed` | Se abre la página de reservas de un evento en el marco                  | `eventTypeSlug`: el final de la dirección del evento              |
| `dapta-calendars.date_selected`     | El invitado elige un día                                                | `eventTypeSlug` y `date`, el día en formato `YYYY-MM-DD`          |
| `dapta-calendars.time_selected`     | El invitado elige una hora                                              | `eventTypeSlug` y `startUtc`, el inicio en UTC                    |
| `dapta-calendars.booking_scheduled` | El invitado reserva, también en las solicitudes que aún debes confirmar | `uid` (la referencia de la reserva), `startUtc` y `eventTypeSlug` |

Cualquier página que inserte una página de reservas puede recibir estos mensajes, por eso nunca incluyen el nombre, el correo ni las respuestas del invitado.

Revisa de dónde viene un mensaje antes de usarlo. Un código que copias hoy de **Insertar en tu sitio** envía sus mensajes desde `https://book.dcal.ai`; un código anterior los envía desde `https://app.dcal.ai`. Acepta el que usa tu código, o los dos. Por ejemplo, para enviar las reservas a tu analítica:

```html
<script>
  window.addEventListener('message', function (e) {
    if (e.origin !== 'https://book.dcal.ai' && e.origin !== 'https://app.dcal.ai') return;
    if (e.data && e.data.event === 'dapta-calendars.booking_scheduled') {
      console.log('Booked', e.data.payload.eventTypeSlug, e.data.payload.startUtc);
    }
  });
</script>
```

***

## Para tener en cuenta

* La inserción va en línea: se queda en tu página donde la pegas. No hay una versión de ventana emergente ni de botón flotante.
* La insignia **Hecho con dCal.ai de Dapta** aparece dentro de la inserción, salvo que tu workspace oculte la marca de Dapta. Mira [La insignia de Dapta](https://docs.dapta.ai/dapta-docs-es/dcal/design/dapta-branding.md).
* Las direcciones insertadas no aparecen en los buscadores, así que nunca compiten con tu propia página.
* El código sigue funcionando si tu workspace obtiene después un [enlace personalizado](https://docs.dapta.ai/dapta-docs-es/dcal/share/custom-link.md): la dirección anterior lleva el marco a la nueva y conserva tus parámetros.
* Si cambias tu identificador o el final de la dirección de un evento, actualiza el `src` de tus códigos: la dirección anterior deja de abrir.
* Para fijar el idioma de una inserción, añade `&amp;lang=es` o `&amp;lang=en` al `src`. Funciona en todas las páginas que puedes insertar.
* No hay parámetros para completar por adelantado el nombre o el correo del invitado.
* Si tu sitio solo permite marcos y scripts de las direcciones que lista, añade `https://book.dcal.ai` a esa lista antes de pegar un código nuevo.

## Relacionado

* [Tus enlaces y tu página de perfil](https://docs.dapta.ai/dapta-docs-es/dcal/share/your-booking-page.md)
* [Colores, fuentes y estilos predefinidos](https://docs.dapta.ai/dapta-docs-es/dcal/design/look-and-presets.md)
* [Enlace personalizado](https://docs.dapta.ai/dapta-docs-es/dcal/share/custom-link.md)
* [Lo que ven tus invitados](https://docs.dapta.ai/dapta-docs-es/dcal/what-guests-see.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/share/embed.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.
