> 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/dapta-forms/connect/hubspot/map-questions.md).

# Asignar preguntas a propiedades del contacto

Asigna cada pregunta de un formulario de Dapta a una propiedad del contacto en HubSpot: usa el selector de propiedades buscable, deja que el mapeo automático llene las coincidencias obvias, añade clav

Mapear le dice a HubSpot dónde va cada respuesta. Hasta que una pregunta está mapeada, su respuesta se queda en Dapta Forms y nunca llega a tu CRM.

Abre tu formulario, haz clic en **Conectar** en la barra superior, y baja hasta la tarjeta de **HubSpot**.

***

**Paso 1:** Busca la sección **Mapear preguntas**. Lista cada pregunta del formulario bajo **Tu pregunta**, con su clave de campo debajo, y un selector bajo **Propiedad de HubSpot** junto a cada una.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-bffb5759d6b12a0b4a4b2c0814d33bf6b44f89a7%2Fforms-map-questions-01-section.png?alt=media" alt="La sección Mapear preguntas listando cinco preguntas con sus selectores de propiedad de HubSpot y el botón de mapeo automático"><figcaption><p><strong>Mapear preguntas</strong> empareja cada pregunta con una propiedad del contacto. El mapeo automático llena las obvias por ti.</p></figcaption></figure>

La línea de ayuda enuncia la única regla que importa: **Envía cada respuesta a una propiedad de contacto de HubSpot. Una pregunta debería apuntar a «email».**

***

**Paso 2:** Haz clic en el botón de mapeo automático para llenar las coincidencias obvias de una vez.

El mapeo automático lee el texto y los tipos de tus preguntas, en inglés y en español, y sugiere las propiedades estándar del contacto: una pregunta de correo a `email`, una de teléfono a `mobilephone` o `phone`, una de sitio web o URL a `website`, una de empresa a `company`, una de puesto a `jobtitle`, y nombre y apellido a `firstname` y `lastname`.

Nunca sobrescribe un mapeo que ya hiciste. Cuando encuentra algo obtienes **Se mapearon automáticamente {n} pregunta(s). Revisa y guarda.**, y cuando no queda nada por sugerir obtienes **No hay coincidencias nuevas que sugerir.**

> **💡 Tip:** Revisa siempre lo que eligió el mapeo automático. Es un atajo para las propiedades estándar, no un sustituto de leer la lista.

***

**Paso 3:** Pon el resto a mano. Haz clic en un selector para abrir la lista de propiedades, escribe en **Buscar…** para acotarla, y luego haz clic en la propiedad que quieras.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-f9e199242ca527d2336f1a06bef387ca910fe7cb%2Fforms-map-questions-02-property-picker.png?alt=media" alt="Un selector de propiedad de HubSpot abierto con la palabra job escrita en la búsqueda y tres propiedades coincidentes listadas"><figcaption><p>Cada propiedad de tu portal es buscable, y se muestra como <strong>Etiqueta (nombre_interno)</strong>.</p></figcaption></figure>

Cada entrada se lee **Etiqueta (nombre\_interno)**: la etiqueta es lo que ve tu equipo en HubSpot, y el valor entre paréntesis es el nombre interno que usa la API. Elige **(ninguna)** para limpiar un mapeo.

Dos detalles que conviene conocer:

* La misma pregunta puede alimentar varias propiedades. Mapéala una vez aquí, y añade los destinos extra en los mapeos de campo personalizados del paso siguiente.
* Si no se puede contactar a tu portal un momento, la tarjeta dice **Las propiedades de HubSpot no están disponibles temporalmente, pero todavía puedes escribir un nombre de propiedad.** El mapeo se guarda igual.

***

**Paso 4:** Usa los **mapeos de campo personalizados** para todo lo que no sea una pregunta normal: parámetros UTM, campos ocultos, o una clave que definas por la URL.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-b0b7f2e12052380acf1e8b0b872d3446cf12768a%2Fforms-map-questions-03-custom-field-key.png?alt=media" alt="El selector de clave de los mapeos de campo personalizados abierto, mostrando el grupo Preguntas del formulario, el grupo Campos del sistema con las cinco claves UTM, y la opción Clave personalizada"><figcaption><p>El selector de claves agrupa todo lo que puedes enviar: <strong>Preguntas del formulario</strong>, <strong>Campos del sistema</strong> y <strong>Clave personalizada…</strong>.</p></figcaption></figure>

Haz clic en **Añadir mapeo**, abre el selector de la izquierda y elige la clave:

| Grupo                        | Qué contiene                                                                                                                                                                                                                                                                                  |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Preguntas del formulario** | Cada pregunta del formulario, listada como **Texto de la pregunta (clave\_de\_campo)**. Úsalo para enviar una respuesta a una segunda propiedad.                                                                                                                                              |
| **Campos del sistema**       | Los cinco parámetros UTM capturados: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` y `utm_content`. En un formulario con paso de agendador también obtienes las claves de reserva (**Reserva: nombre completo**, **Reserva: nombre**, **Reserva: apellido**, **Reserva: teléfono**). |
| **Clave personalizada…**     | Escribe cualquier clave a mano, para un campo oculto o un valor que pases por la URL. **Volver a la lista** regresa a los grupos.                                                                                                                                                             |

Luego elige la propiedad de HubSpot a la derecha. **Quitar** borra la fila. Sin filas, la sección dice **Todavía no hay mapeos.**

> **💡 Tip:** Los campos ocultos y el prellenado con `?clave=valor` se explican en [Campos ocultos y prellenado por URL](/dapta-docs-es/dapta-forms/builder/hidden-fields-and-url-prefill.md). Todo lo que caiga en un campo del formulario se puede mapear aquí.

***

**Paso 5:** Comprueba que una pregunta apunte a **Email (email)**. Este es el mapeo del que depende toda la integración.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-af94e7dcc57265843539b4c59c9c1a726d1d0dbf%2Fforms-map-questions-04-email-row.png?alt=media" alt="Las filas de Mapear preguntas con la pregunta de correo de trabajo mapeada a Email (email) resaltada"><figcaption><p>Sin esta fila, las respuestas llegan sin nada con que identificar a la persona y no se crea ningún contacto.</p></figcaption></figure>

HubSpot empareja un contacto por dirección de correo: actualiza el que encuentra, o crea uno nuevo. Una respuesta que no lleva dirección no se puede emparejar, así que el lead no se sincroniza en absoluto. Si tu formulario no tiene pregunta de correo, la tarjeta reemplaza las secciones de mapeo por **Este formulario no tiene dirección de correo que sincronizar**.

Hay una excepción. En un formulario cuya única fuente de dirección es un paso de **agendador**, Calendly aporta la dirección del invitado cuando alguien reserva, y **no** deberías mapear nada a `email`. Hacerlo levanta la alerta **Este mapeo detiene la sincronización**. Mira [Cómo funciona la sincronización y solución de problemas](/dapta-docs-es/dapta-forms/connect/hubspot/how-sync-works.md).

***

## Qué sigue

* [Mapas de valores y propiedades estáticas](/dapta-docs-es/dapta-forms/connect/hubspot/value-maps-and-static-properties.md): traduce respuestas a los valores que esperan tus listas.
* [Elementos del formulario: UTMs, puntaje, resultado, fecha de envío](/dapta-docs-es/dapta-forms/connect/hubspot/form-elements.md): mapea los metadatos que Dapta Forms captura por su cuenta.
* [Cómo funciona la sincronización y solución de problemas](/dapta-docs-es/dapta-forms/connect/hubspot/how-sync-works.md): la regla del correo, los estados bloqueados y el registro de entregas.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dapta.ai/dapta-docs-es/dapta-forms/connect/hubspot/map-questions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.