> 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/dforms/connect/hubspot/form-elements.md).

# Elementos del formulario: UTMs, puntaje, resultado, fecha de envío

Envía a HubSpot los metadatos que dForms captura por su cuenta: los cinco parámetros UTM, el puntaje del lead, el titular del resultado y la fecha de envío. Más los interruptores para inferir la empre

No todo lo que vale la pena enviar a HubSpot es una respuesta. dForms también captura de dónde vino la persona, cuánto puntuó, en qué resultado cayó y cuándo envió. La sección **Asignar elementos del formulario** es donde decides qué propiedad del contacto recibe cada una de esas cosas.

Abre tu formulario, haz clic en **Conectar**, y baja dentro de la tarjeta de **HubSpot** hasta **Asignar elementos del formulario**. La sección se describe como **Envía los metadatos capturados (UTMs, puntuación, resultado y fecha de envío) a propiedades de HubSpot.**

***

**Paso 1:** Mapea los parámetros de campaña en **Mapeo de UTM**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-f8712d4d08457d16416ada1683ac20033e2baa09%2Fforms-form-elements-01-utm-mappings.png?alt=media" alt="El bloque Mapeo de UTM con filas para utm_source, utm_medium, utm_campaign, utm_term y utm_content, tres de ellas apuntando a propiedades de HubSpot"><figcaption><p>Cinco filas fijas, una por parámetro UTM. Deja una fila en <strong>(ninguna)</strong> para saltártela.</p></figcaption></figure>

Las cinco filas son `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` y `utm_content`. Cada vez que alguien abre el formulario público con esos parámetros en la URL, dForms los captura solo: no tienes que añadir preguntas ocultas para ellos. Cuando el formulario está insertado con el fragmento completo y su propia dirección no lleva parámetros UTM, los toma de la página que lo inserta. Mira [Insertar en tu sitio web](/dapta-docs-es/dforms/share/embed.md#lo-que-tu-pagina-le-cuenta-al-formulario).

Las UTMs se envían en respuestas **parciales y completas**, así que un lead abandonado igual llega con su campaña adjunta.

> **💡 Tip:** Los mismos valores viajan en el payload del webhook bajo `utm`, y también se ven en cada respuesta. Los scripts de seguimiento se configuran aparte, en [Seguimiento y píxeles](/dapta-docs-es/dforms/connect/tracking-and-pixels.md).

***

**Paso 2:** Elige a dónde van el puntaje del lead y la fecha de envío.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-22a21399fe1f5d48a3f1d9e967bdaf00087fe2cf%2Fforms-form-elements-02-score-and-date.png?alt=media" alt="Los selectores Propiedad de puntuación y Propiedad de fecha de envío, con el selector Zona horaria del día junto a una propiedad de tipo fecha"><figcaption><p><strong>Propiedad de puntuación</strong> y <strong>Propiedad de fecha de envío</strong>. Una propiedad de tipo fecha muestra <strong>Zona horaria del día</strong> a su lado.</p></figcaption></figure>

| Campo                           | Qué recibe                                                                                                                                                                                                                                            |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Propiedad de puntuación**     | El puntaje total como número. **Recibe el puntaje total como número, solo en respuestas completadas.** Elige una propiedad numérica de HubSpot.                                                                                                       |
| **Propiedad de fecha de envío** | Cuándo se hizo la respuesta. Lo que se escribe depende del tipo de la propiedad en HubSpot: una propiedad de **fecha y hora** conserva la hora exacta, y una propiedad de **fecha** recibe el día calendario, contado en la **Zona horaria del día**. |

La **Zona horaria del día** aparece junto al selector cuando la propiedad es de tipo fecha. Es una lista de zonas horarias con buscador, y si no la tocas se usa **UTC (predeterminada)**. Decide el día calendario: una respuesta a las 9 pm en Bogotá sigue siendo de hoy allí, pero en UTC ya es mañana. El mismo valor lo comparten todas las propiedades de fecha de la tarjeta de HubSpot, incluida la fecha de reserva de la [sincronización de reservas](/dapta-docs-es/dforms/connect/hubspot/booking-sync.md).

> **⚠️ Nota:** En un formulario sin pregunta de correo, la respuesta llega a HubSpot cuando alguien agenda en el paso de agendador. En ese caso la **Propiedad de fecha de envío** recibe el día calendario en UTC, sin importar su tipo ni lo que diga la **Zona horaria del día**.

El puntaje se configura en la pestaña **Lógica**. Si tu formulario no usa puntos, deja la **Propiedad de puntuación** en **(ninguna)**. Mira [Puntaje](/dapta-docs-es/dforms/logic/scoring.md).

***

**Paso 3:** Envía el resultado que vio la persona.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-3ba7b9d41d29756fc45150cc39e5bf6ade114895%2Fforms-form-elements-03-outcome.png?alt=media" alt="El selector Propiedad de resultado con el texto de ayuda que explica que recibe el titular del rango de puntaje que coincide"><figcaption><p>La <strong>Propiedad de resultado</strong> recibe el titular exacto del rango de puntaje que coincidió.</p></figcaption></figure>

Recibe el **titular que escribiste en el rango de puntaje que coincide, en Resultados**: el mismo texto que lee la persona en la pantalla final, no un código. Se escribe solo en respuestas completadas, y solo cuando un rango de puntaje coincide de verdad. Con el puntaje apagado, no se envía nada. Mira [Resultados](/dapta-docs-es/dforms/logic/outcomes.md).

***

**Paso 4:** Decide qué más debe hacer la sincronización, con los tres interruptores bajo las secciones de mapeo.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-236d08c6b1d456b6e98ae2e1f84434787f914007%2Fforms-form-elements-04-toggles.png?alt=media" alt="Los interruptores Inferir la empresa desde el email, Crear una nota en respuestas completadas y Registrar la respuesta como form submission en HubSpot: el primero desactivado y los otros dos activados"><figcaption><p>Tres interruptores. Aquí la nota y el registro de la respuesta están activados, e Inferir la empresa está desactivado.</p></figcaption></figure>

| Interruptor                                                | Qué hace                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Inferir la empresa desde el email**                      | Cuando la persona usa un correo corporativo, llena las propiedades de empresa y sitio web a partir de su dominio. Los dominios de correo gratuito (gmail, outlook y similares) se saltan, y un valor que hayas mapeado tú nunca se sobrescribe.                                                                                                                                                                   |
| **Crear una nota en respuestas completadas**               | Adjunta al contacto una nota con el nombre del formulario, la fecha y hora de envío (UTC), el puntaje, el resultado, la página donde se respondió el formulario (una línea **Page:**, cuando se conoce) y cada propiedad que escribió la respuesta. Activado por defecto.                                                                                                                                         |
| **Registrar la respuesta como form submission en HubSpot** | Crea un formulario equivalente en tu portal, para que cada respuesta completada aparezca en el contacto como una **actividad de form submission** que lista las propiedades que escribió, no solo como una nota. El formulario lleva el nombre del tuyo, con **(dForms)** añadido. También lleva la página en la que la persona convirtió y su cookie de HubSpot, que une al contacto con sus visitas anteriores. |

**Registrar la respuesta como form submission en HubSpot** necesita los permisos `forms` y `form-submissions-write` en la app privada que hay detrás de tu conexión. Si tu portal lo rechaza, la tarjeta muestra **HubSpot no pudo configurarlo: {reason}** y el resto de tus ajustes se guarda igual. Lo que se necesita para unir los contactos con sus visitas está en [Página de origen y atribución en HubSpot](/dapta-docs-es/dforms/connect/hubspot/attribution.md).

Duplicar un formulario no copia su vínculo con el formulario equivalente en HubSpot. La copia crea el suyo la primera vez que se guardan sus ajustes de HubSpot con el interruptor activado, así cada formulario registra sus respuestas en su propio formulario de tu portal.

> **⚠️ Nota:** La nota y la actividad de form submission solo ocurren en respuestas **completadas**. **Inferir la empresa desde el email** también actúa en las respuestas parciales.

***

## Referencia

| Ajuste                                                     | Se envía en parcial | Se envía en completa                    |
| ---------------------------------------------------------- | ------------------- | --------------------------------------- |
| **Mapeo de UTM**                                           | Sí                  | Sí                                      |
| **Propiedad de puntuación**                                | No                  | Sí                                      |
| **Propiedad de resultado**                                 | No                  | Sí, cuando coincide un rango de puntaje |
| **Propiedad de fecha de envío**                            | Sí                  | Sí                                      |
| **Inferir la empresa desde el email**                      | Sí                  | Sí                                      |
| **Crear una nota en respuestas completadas**               | No                  | Sí                                      |
| **Registrar la respuesta como form submission en HubSpot** | No                  | Sí                                      |

Con la [protección contra spam](/dapta-docs-es/dforms/connect/spam-protection.md) activa, no se envía nada en una respuesta parcial: todo lo de la columna **Se envía en completa** sale cuando la persona termina.

***

## Qué sigue

* [Mapas de valores y propiedades estáticas](/dapta-docs-es/dforms/connect/hubspot/value-maps-and-static-properties.md): traduce respuestas y marca valores fijos.
* [Página de origen y atribución en HubSpot](/dapta-docs-es/dforms/connect/hubspot/attribution.md): une los contactos con la página en la que convirtieron.
* [Sincronización de reservas](/dapta-docs-es/dforms/connect/hubspot/booking-sync.md): las propiedades que se escriben cuando alguien reserva una reunión.
* [Cómo funciona la sincronización y solución de problemas](/dapta-docs-es/dforms/connect/hubspot/how-sync-works.md): lee el registro de entregas y arregla una sincronización que no corre.


---

# 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/dforms/connect/hubspot/form-elements.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.