> 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/delivery-and-retries.md).

# Entrega, reintentos e historial

Cómo entrega dForms las respuestas a webhooks, HubSpot, Google Sheets, Salesforce, HighLevel y correo sin bloquear nunca a quien responde: qué fase recibe cada uno, la cola, el calendario de reintento

Cada integración de dForms sigue la misma regla: **guardar la respuesta primero, entregar después, reintentar si falla, y dejar registro.** Esta página explica ese proceso para que sepas qué esperar cuando un endpoint va lento, un CRM está caído, o alguien envía dos veces.

***

## Nada bloquea una respuesta

Cuando alguien pasa el punto de envío parcial o termina el formulario, sus respuestas se guardan de inmediato y ve el siguiente paso o la pantalla final. Solo entonces dForms encola las entregas de cada integración activada:

| Integración                    | Qué se encola                                                                                           | En qué fase                                                                                                                                                                                            |
| ------------------------------ | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Webhook**                    | Un POST por webhook                                                                                     | Parcial o completa, según las casillas de **Disparar en**                                                                                                                                              |
| **HubSpot**                    | Alta o actualización del contacto y propiedades mapeadas                                                | Parcial y completa por defecto; solo completa con **Enviar también respuestas parciales** apagado (puntaje, resultado, propiedades estáticas, nota y actividad de form submission solo en la completa) |
| **Google Sheets**              | Una fila nueva en la hoja vinculada                                                                     | Solo completa, siempre                                                                                                                                                                                 |
| **Salesforce**                 | Una actualización de Contact o de Lead, o un Lead nuevo                                                 | Solo completa por defecto; también parcial con **Enviar también respuestas parciales** encendido                                                                                                       |
| **HighLevel**                  | Un alta o actualización del contacto, y después las etiquetas                                           | Solo completa por defecto; también parcial con **Enviar también respuestas parciales** encendido                                                                                                       |
| **Correos**                    | Un **Aviso de nueva respuesta** por cada dirección de **Enviar a**, y la **Confirmación al encuestado** | Solo completa                                                                                                                                                                                          |
| **Sincronización de reservas** | Propiedades de reserva de HubSpot                                                                       | Después de una reserva en el agendador, unos 15 segundos más tarde                                                                                                                                     |

HubSpot, Salesforce y HighLevel tienen cada uno un interruptor **Enviar también respuestas parciales** en su tarjeta, como las casillas **Disparar en** del webhook. Arranca encendido en HubSpot, así una tarjeta de HubSpot sigue haciendo lo de siempre, y apagado en Salesforce y HighLevel. Google Sheets no tiene interruptor: una hoja solo agrega filas, así que una parcial dejaría media fila encima de la completa.

En una pantalla de Diapositivas que muestra varias preguntas, la parcial se envía cuando la persona envía la pantalla que contiene el punto de envío parcial. Con la [protección contra spam](https://docs.dapta.ai/dapta-docs-es/dforms/connect/spam-protection.md) activa, una parcial se guarda pero no se encola nada para los webhooks ni para los CRM, diga lo que diga su interruptor: solo se entrega la respuesta completa y verificada. Una tarjeta de Google Sheets activada pero sin hoja vinculada no encola nada.

Un destino lento o roto, por tanto, nunca ralentiza a quien responde, y nunca pierde las respuestas: el envío ya está en **Respuestas** y en el CSV antes de que se intente ninguna entrega.

***

## Calendario de reintentos

Una entrega se recoge en unos segundos. Si falla de una forma que podría funcionar en otro intento (un estado distinto de 2xx en un webhook, una redirección, un tiempo agotado, un error de red, un proveedor caído o por encima de su límite) se reintenta con backoff exponencial: unos **1 s, 2 s, 4 s, 8 s…** entre intentos, con tope de 5 minutos, hasta un máximo de **5 intentos**. Mientras hay reintentos pendientes la fila dice **En curso** y el conteo de intentos sube.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-b0d901faf38bc1f906ce19f50e37471edf99f41e%2Fforms-delivery-and-retries-02-in-progress.png?alt=media" alt="El diálogo Historial del webhook con dos filas marcadas En curso, HTTP 500, 2 intentos"><figcaption><p>Entre reintentos, una entrega se muestra como <strong>En curso</strong> con su conteo de intentos.</p></figcaption></figure>

Tras el quinto fallo la entrega queda marcada con **Falló** y se conserva como registro, con el último error y la última respuesta del endpoint.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-3dd5d536e21bb227d05de8e6ed30d8025f2539d4%2Fforms-delivery-and-retries-03-failed-row.png?alt=media" alt="Una fila Falló desplegada en el diálogo Historial del webhook mostrando el cuerpo en Lo que enviamos y la respuesta en Lo que respondió HTTP 500"><figcaption><p>Una entrega que se rindió tras <strong>5 intentos</strong>. La transcripción sigue disponible.</p></figcaption></figure>

***

## Qué significan los estados

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-a4d128e583265da1fd2febcee83f16864c9f2062%2Fforms-delivery-and-retries-01-history-statuses.png?alt=media" alt="El diálogo Historial del webhook listando filas Entregada, algunas con una insignia Prueba"><figcaption><p>Píldoras de estado y la insignia <strong>Prueba</strong> en un diálogo de historial.</p></figcaption></figure>

| Estado           | Qué significa                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | ¿Se reintenta?                                                             |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| **Entregada**    | El destino la aceptó (2xx en un webhook, una llamada de API correcta en HubSpot, el correo entregado al proveedor).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | No hace falta.                                                             |
| **En curso**     | Encolada, enviándose, o esperando su siguiente intento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Sí, automáticamente.                                                       |
| **Falló**        | Reintentos agotados. La fila conserva el último mensaje de error y, en los webhooks, **Lo que respondió**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | No. Arregla el destino; la siguiente respuesta o **Enviar prueba** pasará. |
| **No entregada** | No se hizo, para siempre, con el motivo en la fila. O el proveedor la rechazó de una forma que un reintento no cambia (las reglas de validación de Salesforce, un campo obligatorio, un permiso que le falta al usuario de integración, una hoja que ya no existe), o no podía aplicar (una respuesta para HubSpot o Salesforce sin correo, una respuesta para HighLevel sin correo ni teléfono, una sincronización de reserva en un formulario cuyo destino de HubSpot se apagó entretanto, una reserva que la protección contra spam no pudo emparejar con una persona verificada). Se registra una vez, nunca se reintenta. | No. Arregla la causa; la siguiente respuesta pasa.                         |

Un rechazo muestra las palabras del propio proveedor después de la frase de dForms. En Salesforce es el código y el mensaje de error, como *Rechazada por Salesforce con HTTP 400: FIELD\_CUSTOM\_VALIDATION\_EXCEPTION: Region is required for web leads \[Region\_\_c]*, así sabes qué regla o qué campo arreglar. La parte de dForms se lee en español; la parte del proveedor se conserva siempre tal como la escribió el proveedor. Abre la fila para ver **Lo que enviamos** y **Lo que respondió**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-ccc67a01ddbb19f4492e203b3de738f012bae4b7%2Fforms-salesforce-05-not-delivered.png?alt=media" alt="Una fila No entregada desplegada en el Historial de Salesforce con el código y el mensaje de error de Salesforce"><figcaption><p><strong>No entregada</strong>: rechazada por el proveedor, con su motivo, y sin reintentos.</p></figcaption></figure>

> **⚠️ Nota:** No hay botón de reenvío manual. Las entregas fallidas son un registro, no una cola que puedas reproducir. Si se perdió un lead porque tu endpoint estaba caído, exporta la respuesta desde **Respuestas** o pídele a la persona que vuelva a enviar.

***

## Historial por integración

La pestaña **Conectar** guarda un registro por integración: **Historial del webhook**, **Historial de HubSpot**, **Historial de Google Sheets**, **Historial de Salesforce**, **Historial de HighLevel** e **Historial de correos**, cada uno se abre con **Ver historial** y muestra las últimas 25 filas, de la más reciente a la más antigua, con las horas en la zona horaria de tu workspace. Cuando algunas necesitan una revisión, una etiqueta roja como **Para revisar: 2** aparece junto al título. Cuenta justo las filas que el diálogo pinta de rojo: las filas **Falló** y las respuestas completas que el proveedor rechazó (**No entregada**). Una respuesta parcial que se omitió aparece como **No entregada**, pero no se cuenta.

Cada fila dice qué momento la envió: **Respuesta completa**, **Respuesta parcial**, **Actualización por agendamiento** (una [sincronización de reservas](https://docs.dapta.ai/dapta-docs-es/dforms/connect/hubspot/booking-sync.md) en HubSpot), **Aviso de nueva respuesta**, **Confirmación a quien respondió** o **Invitación**. Las filas de webhook incluyen la petición y la respuesta completas; las de HubSpot incluyen cualquier error que devolviera el CRM; las de Google Sheets incluyen la respuesta de Google, como *Rechazada por Google Sheets con HTTP 404: Requested entity was not found.* para una hoja que se borró; las de Salesforce incluyen los campos enviados y la respuesta de Salesforce; las de HighLevel incluyen la respuesta de HighLevel, con su propio mensaje cuando rechazó un valor; las de correo muestran qué aviso se envió, una fila por destinatario.

Solo el **Historial del webhook** explica las entregas de prueba («Las entregas de prueba también aparecen…»), porque el webhook es la única tarjeta con **Enviar prueba**.

A nivel de cuenta, el inventario de **Webhooks** de la página de [Integraciones](https://docs.dapta.ai/dapta-docs-es/dforms/connect/connections.md) muestra una columna de **Entrega** por formulario: vacía cuando está sano, o un **{n} sin entregar** rojo con **Último fallo: {fecha}**. Los fallos se cuentan por formulario, así que un formulario con dos webhooks muestra el mismo conteo en las dos filas.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-2573dd7dcb6c4fa7374d9bc0fabe4d55f9d73d50%2Fforms-delivery-and-retries-04-connections-delivery.png?alt=media" alt="La tabla de Webhooks de la página de Integraciones con una insignia roja de 4 sin entregar en la columna Entrega"><figcaption><p>El inventario marca los formularios cuyo webhook tiene entregas fallidas.</p></figcaption></figure>

***

## Sin duplicados al reenviar

Cada entrega lleva una clave de idempotencia (`submission:{submissionId}:{phase}:webhook:{index}`, enviada como `x-forms-delivery` y como `id` en el cuerpo). Si la misma sesión envía otra vez la misma fase, por ejemplo porque la persona volvió atrás y pulsó Enviar dos veces, las entregas pendientes de esa fase se reemplazan en lugar de duplicarse, y una fase que ya llegó no se vuelve a encolar. HubSpot se indexa por el correo de quien responde, así que una repetición actualiza el mismo contacto en lugar de crear uno nuevo. Salesforce busca el correo antes de cada intento, así que un reintento actualiza el registro que creó el primer intento. HighLevel empareja el contacto por correo o por teléfono en cada intento, y agregar una etiqueta que ya tiene no cambia nada, así que un reintento nunca duplica un contacto ni una etiqueta. Google Sheets solo recibe la respuesta completa, una vez. En tu propio endpoint, guarda la clave e ignora una petición cuya clave ya procesaste.

***

## Guardar cambios en la pestaña Conectar

Todo lo que cambias en la pestaña Conectar se guarda solo. Dos indicadores te dicen cómo fue: un estado en la esquina de abajo de la página, y el estado de la barra superior, junto a **Vista previa**. Los dos muestran siempre el mismo estado.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-0aee0d19e6c767834462466350838e6c257263fd%2Fforms-delivery-and-retries-06-save-saved.png?alt=media" alt="La pestaña Conectar con Guardado en la barra superior y Cambios guardados automáticamente en la esquina de abajo"><figcaption><p>Un guardado que llegó: <strong>Guardado</strong> arriba, <strong>Cambios guardados automáticamente</strong> abajo.</p></figcaption></figure>

| Esquina de abajo                                          | Barra superior        | Qué significa                                                                                                                                                                                     |
| --------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Guardando…**                                            | **Guardando…**        | El cambio va en camino.                                                                                                                                                                           |
| **Cambios guardados automáticamente**                     | **Guardado**          | El cambio quedó guardado. Al rato la esquina se reduce a **Guardado** y luego desaparece.                                                                                                         |
| **Se guardó todo menos el webhook.** y el motivo          | **Guardado en parte** | Se guardó todo menos un webhook que todavía no se puede guardar, por ejemplo uno activado sin URL: «Pega la URL del webhook para empezar a enviar. Mientras tanto, el webhook no queda guardado.» |
| **Se perdió la conexión. Reintentando…**                  | **Reintentando…**     | No se pudo contactar al servidor. Tu cambio se conserva y se vuelve a guardar solo.                                                                                                               |
| **No se pudieron guardar las integraciones.** o el motivo | **Sin guardar**       | El guardado falló. Tu cambio no quedó guardado.                                                                                                                                                   |

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-7b474791ad91037c26a238d210e8ba7b02573a8a%2Fforms-delivery-and-retries-07-partly-saved.png?alt=media" alt="La tarjeta de Webhook activada con la URL del endpoint vacía, Guardado en parte en la barra superior y Se guardó todo menos el webhook en la esquina de abajo"><figcaption><p>Un webhook sin URL es el motivo más común de <strong>Guardado en parte</strong>.</p></figcaption></figure>

Si sales de la pestaña mientras un guardado sigue en curso, dForms lo reintenta unas cuantas veces en segundo plano. Si aun así no puede guardarlo, la barra superior termina en **Sin guardar**, un aviso lo dice una vez, y la próxima vez que abras la pestaña Conectar un mensaje arriba dice «Tu último cambio en esta pestaña no se pudo guardar después de que saliste, así que no está en las integraciones de abajo.» Haz clic en **Entendido** para cerrarlo, y vuelve a hacer el cambio.

Algunas tarjetas también dicen en la propia tarjeta cuando algo quedó guardado pero todavía no se envía, por ejemplo **Todavía no se envía nada: crea o elige una hoja.** en Google Sheets, o «Guardada. Elige el campo de Salesforce para enviarla.» bajo una fila de Salesforce sin terminar.

## Qué sigue

* [Webhooks](https://docs.dapta.ai/dapta-docs-es/dforms/connect/webhooks.md) y [Probar y ver el historial de entregas](https://docs.dapta.ai/dapta-docs-es/dforms/connect/webhooks/test-and-history.md)
* [Google Sheets](https://docs.dapta.ai/dapta-docs-es/dforms/connect/google-sheets.md), [Salesforce](https://docs.dapta.ai/dapta-docs-es/dforms/connect/salesforce.md) y [HighLevel](https://docs.dapta.ai/dapta-docs-es/dforms/connect/highlevel.md)
* [Cómo funciona la sincronización con HubSpot y solución de problemas](https://docs.dapta.ai/dapta-docs-es/dforms/connect/hubspot/how-sync-works.md)
* [Correos de respuesta](https://docs.dapta.ai/dapta-docs-es/dforms/connect/emails.md)
* [Solución de problemas](https://docs.dapta.ai/dapta-docs-es/dforms/troubleshooting.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/dforms/connect/delivery-and-retries.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.
