> 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/integrations/hubspot.md).

# HubSpot

Conecta HubSpot una vez para todo el workspace de dCal y cada reserva aceptada se convierte en un contacto con una reunión. Conoce los dos permisos que necesita la aplicación privada, qué escribe dCal

Conecta HubSpot una vez y cada reserva que alguien de tu workspace acepte se convierte en un contacto de HubSpot con una reunión. Las reprogramaciones y cancelaciones actualizan esa misma reunión. En cada evento también puedes elegir qué respuestas de la reserva llenan qué propiedades del contacto.

***

## Qué llega a HubSpot

| Cuándo                               | Qué hace dCal en HubSpot                                                                                                               |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| Se acepta una reserva                | Busca el contacto por correo, o lo crea, y le agrega una reunión.                                                                      |
| La reserva se reprograma             | Mueve esa misma reunión al nuevo horario.                                                                                              |
| La reserva se cancela, o la rechazas | Marca esa misma reunión como cancelada y le pone al inicio del título `[Cancelada]` (`[Canceled]` si el anfitrión usa dCal en inglés). |

* **Solo reservas aceptadas.** Una reserva inmediata se escribe enseguida. Una solicitud que espera tu visto bueno se escribe cuando la confirmas, y una solicitud rechazada nunca se escribe.
* **Cuenta cualquier forma de reservar:** tus páginas de reservas, las páginas de equipo, las reservas que creas desde **Reservas**, tus agentes de Dapta y la API.
* **El contacto.** dCal busca el contacto por el correo exacto que escribió el invitado. Un contacto que ya existe conserva su nombre. Uno nuevo se crea con el correo, un nombre (la primera palabra del nombre que escribió el invitado) y un apellido (el resto). Solo la persona que reservó se convierte en contacto, nunca los invitados adicionales.
* **La reunión.** Su título es el nombre del evento, lleva la hora de inicio y de fin, y su cuerpo muestra el anfitrión, cada respuesta del invitado, la campaña de la reserva cuando tiene una (una línea como `utm_source: newsletter` por cada etiqueta UTM que guardó) y la referencia de la reserva. El texto que parece HTML, en una respuesta o en una etiqueta UTM, llega como texto plano. El enlace para gestionar la reserva nunca se incluye. dCal no le asigna un propietario de HubSpot: el anfitrión aparece como texto en el cuerpo.
* **Nunca se borra nada** en HubSpot, y dCal nunca crea propiedades ahí.
* **Nunca hace más lenta una reserva.** dCal escribe en HubSpot en segundo plano, así que la reserva del invitado se completa aunque HubSpot esté lento.

> **💡 Tip:** El **ID de seguimiento de HubSpot** que puedes poner en un evento, en **Conexión con el CRM** > **Seguimiento y píxeles**, es distinto de esta integración. Carga el código de seguimiento de HubSpot en la página de reservas de ese evento para que las visitas cuenten en HubSpot, y con los formularios recopilados activados en tu portal de HubSpot, HubSpot también puede capturar el formulario de reserva. Las reservas en sí llegan a HubSpot solo por esta integración. Mira [Seguimiento y píxeles](https://docs.dapta.ai/dapta-docs-es/dcal/events/event-settings.md#seguimiento-y-pixeles).

***

## Antes de empezar

* Eres administrador o propietario de tu workspace de dCal.
* Puedes crear una aplicación privada en tu cuenta de HubSpot.

***

## Conecta HubSpot

**Paso 1:** Entra a **Ajustes** > **Integraciones**, o abre [app.dcal.ai/admin/settings/integrations](https://app.dcal.ai/admin/settings/integrations). La tarjeta de **HubSpot** dice **Sin conectar**. Haz clic en **Conectar**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-2133a3e8bf39870841aa31a7d03e46921409a1fa%2Fdcal-hubspot-01-card-not-connected.png?alt=media" alt="La tarjeta de HubSpot en la pestaña Integraciones con la etiqueta Sin conectar y el botón Conectar, ambos marcados, y la línea Este espacio de trabajo no está enviando nada a HubSpot."><figcaption><p>Una tarjeta, una conexión para todo el workspace.</p></figcaption></figure>

***

**Paso 2:** El diálogo **Conectar HubSpot** muestra los dos permisos que necesita la aplicación privada. En HubSpot, crea una aplicación privada y concédele los dos:

* `crm.objects.contacts.read`
* `crm.objects.contacts.write`

Después copia el token de acceso de la aplicación. El diálogo te indica Configuración, Integraciones y Aplicaciones privadas en HubSpot; las cuentas más nuevas de HubSpot muestran las aplicaciones privadas en Development, Legacy apps. La [guía de aplicaciones privadas de HubSpot](https://developers.hubspot.com/docs/guides/apps/private-apps/overview) tiene los pasos actuales.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-9f73c9cbed86a6fd48f5adc006290414848a0f50%2Fdcal-hubspot-02-connect-dialog.png?alt=media" alt="El diálogo Conectar HubSpot con los dos permisos crm.objects.contacts.read y crm.objects.contacts.write como lista de verificación sin marcar y resaltada, el campo Token de acceso vacío, el campo opcional Nombre del portal y el botón Conectar todavía desactivado"><figcaption><p>Marca cada permiso a medida que lo concedes en HubSpot. Las marcas son solo una lista para ti.</p></figcaption></figure>

> **⚠️ Nota:** Concede los dos permisos antes de pegar el token. dCal comprueba el token leyendo de HubSpot, así que un token que solo puede leer igual se conecta, y la tarjeta pasa a **Requiere atención** con la primera reserva aceptada.

***

**Paso 3:** Pega el token en **Token de acceso**. Si quieres, ponle a la conexión un **Nombre del portal (opcional)**, como `Portal de ventas de Acme`, para reconocerla después. Haz clic en **Conectar**.

dCal comprueba el token con HubSpot antes de guardar nada y no vuelve a mostrarlo. Verás **HubSpot conectado.** y la tarjeta dice **Conectado**, con el nombre del portal, **Token terminado en** con sus últimos cuatro caracteres y **Última comprobación** con una fecha.

Si la comprobación falla, no se guarda nada y el diálogo te dice por qué:

| Mensaje                                                                                                  | Qué hacer                                                                                       |
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **HubSpot rechazó ese token. Comprueba que la aplicación privada esté activa y tenga los dos permisos.** | Vuelve a copiar el token de la aplicación privada y revisa que la aplicación esté activa.       |
| **HubSpot indica que faltan estos permisos:** seguido de los nombres de los permisos                     | Concede esos permisos a la aplicación privada en HubSpot y vuelve a hacer clic en **Conectar**. |
| **No pudimos contactar con HubSpot para comprobar ese token. Inténtalo de nuevo en un momento.**         | Espera un momento y vuelve a hacer clic en **Conectar**.                                        |

***

## Envía las respuestas de la reserva a propiedades del contacto

Las asignaciones se definen por evento. Cualquier persona que pueda editar el evento puede definirlas, una vez que el workspace está conectado.

**Paso 4:** Abre el evento desde **Eventos** y elige **Conexión con el CRM** > **Enviar respuestas a tu CRM**. Haz clic en **+ Asignar una respuesta**, elige la **Respuesta** y la **Propiedad de contacto** que llena, y haz clic en **Guardar cambios**.

| Grupo                        | Respuestas que puedes enviar                                                                                                                                                                                                                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Preguntas del formulario** | Las preguntas de la reserva de este evento.                                                                                                                                                                                                                                                                                                      |
| **Datos del invitado**       | **Teléfono**, **Notas**, **Zona horaria**, **Idioma**.                                                                                                                                                                                                                                                                                           |
| **Datos del evento**         | **Nombre del evento**, **Inicio de la reserva**, **Duración en minutos**, **Anfitrión asignado**, **Correo del anfitrión asignado**.                                                                                                                                                                                                             |
| **Campaña (UTM)**            | **Fuente (utm\_source)**, **Medio (utm\_medium)**, **Campaña (utm\_campaign)**, **Término (utm\_term)**, **Contenido (utm\_content)**: las etiquetas UTM del enlace desde el que reservó el invitado. 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). |

* **Siempre se envía:** el nombre y el correo identifican al contacto, por eso no se pueden asignar.
* **+ Añadir otra propiedad** envía la misma respuesta a más de una propiedad, hasta 10.
* Cada propiedad acepta una sola respuesta, y un evento admite hasta 50 asignaciones.
* La lista de propiedades solo ofrece las que encajan con la respuesta, como una propiedad numérica para una respuesta numérica, y solo las que dCal puede escribir. Si falta la que quieres, créala en HubSpot y haz clic en **Actualizar propiedades**.
* **Sugerir asignaciones** completa por ti los pares obvios. Revísalos: nada se guarda hasta que haces clic en **Guardar cambios**.
* En una pregunta de opciones, cada opción se empareja con una opción de HubSpot por su valor o su etiqueta, sin importar mayúsculas, tildes ni espacios. La sección te dice cuántas opciones coinciden, y una opción sin pareja no se envía.
* Una etiqueta UTM llena una propiedad de texto, o un desplegable de una sola opción, como el origen de un lead: ahí, el valor de la etiqueta se empareja con una opción de la misma forma, y un valor sin pareja no se envía.

Si el workspace todavía no conectó HubSpot, la sección dice **Todavía no hay ningún CRM conectado** con un enlace **Ir a Integraciones**. Las asignaciones que ya definiste se conservan y vuelven a funcionar cuando HubSpot se reconecta.

***

## Reglas de sobrescritura

| Regla                                                                | Qué significa para ti                                                                                                                                                                                                        |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Una propiedad asignada se sobrescribe en cada reserva aceptada.      | Siempre tiene la respuesta más reciente del contacto.                                                                                                                                                                        |
| Una respuesta vacía nunca borra un valor.                            | Una pregunta opcional sin responder conserva lo que HubSpot ya tiene.                                                                                                                                                        |
| La campaña se escribe como un solo conjunto.                         | Cuando una reserva tiene alguna etiqueta UTM, una etiqueta asignada que le falta vacía su propiedad, así que dos campañas nunca se mezclan en un contacto. Una reserva sin etiquetas UTM deja la campaña anterior como está. |
| El nombre y el correo solo se escriben cuando dCal crea el contacto. | Un contacto que HubSpot ya conoce conserva su nombre.                                                                                                                                                                        |
| Las propiedades asignadas se escriben cuando se acepta una reserva.  | Reprogramar o cancelar no las toca.                                                                                                                                                                                          |

***

## Estados de la conexión

| Etiqueta              | Qué significa                                                                                         | Qué hacer                                                                                                |
| --------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Sin conectar**      | Este workspace no envía nada a HubSpot.                                                               | Haz clic en **Conectar**.                                                                                |
| **Conectado**         | Las reservas aceptadas llegan a HubSpot.                                                              | Nada.                                                                                                    |
| **Requiere atención** | Las reservas dejaron de llegar a HubSpot. La tarjeta muestra los permisos que, según HubSpot, faltan. | Concede esos permisos en HubSpot. La próxima reserva aceptada pasa sola; no hay nada que volver a pegar. |
| **Desconectado**      | Se quitó el token. Las reservas existentes siguen apuntando a sus reuniones.                          | Haz clic en **Reconectar** y pega un token del mismo portal para retomar donde quedó.                    |

Para dejar de enviar reservas, haz clic en **Desconectar** y luego en **Sí, desconectar**. No se borra nada dentro de HubSpot: los contactos y las reuniones que ya están ahí se quedan tal cual.

## Relacionado

* [Preguntas de la reserva](https://docs.dapta.ai/dapta-docs-es/dcal/events/booking-questions.md): las preguntas que puedes asignar.
* [Confirmar o rechazar solicitudes](https://docs.dapta.ai/dapta-docs-es/dcal/bookings/confirm-or-decline.md): cuándo llega una solicitud a HubSpot.
* [Webhooks](https://docs.dapta.ai/dapta-docs-es/dcal/integrations/webhooks.md): envía las mismas reservas a tu propio sistema.
* [Integraciones](https://docs.dapta.ai/dapta-docs-es/dcal/integrations.md): todo lo que dCal puede conectar.


---

# 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/integrations/hubspot.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.
