Webhooks

Envía cada respuesta de Dapta Forms como un POST JSON a una URL que tú controlas. Define el endpoint, un secreto de firma opcional, elige si las respuestas parciales y completas lo disparan, manda una

Un webhook manda cada respuesta como JSON (POST) a un endpoint tuyo: tu CRM, una herramienta de automatización, un conector de hojas de cálculo, o tu propio backend. Se configura por formulario desde la pestaña Conectar. La entrega es duradera: la respuesta se guarda primero y el webhook se encola, se reintenta si falla, y se registra para que veas qué se envió y qué contestó tu endpoint.

Esta página cubre la tarjeta del webhook. El formato de la petición está en Referencia del payload y las cabeceras, la autenticación en Verificar la firma, y las pruebas en Probar y ver el historial de entregas.

---

Paso 1: Abre tu formulario en el editor y haz clic en Conectar en la barra superior. En la sección Integraciones, busca la tarjeta de Webhook («Envía cada respuesta como JSON (POST) a una URL que tú controlas.») y activa el interruptor. La etiqueta pasa de Desactivado a Activado y la tarjeta se despliega.

Activa el interruptor para revelar los ajustes del webhook.

---

Paso 2: Pega tu URL en URL del endpoint. Tiene que empezar por https:// (se acepta http:// pelado solo para localhost, para desarrollo local). Cualquier otra cosa muestra «Introduce una URL https:// válida (http solo se permite para localhost).» En cuanto la URL es válida se guarda: el pie dice Cambios guardados automáticamente, y el webhook está en vivo en el formulario publicado desde ese momento.

Paso 3 (recomendado): Escribe un Secreto de firma (opcional). Cuando está definido, cada petición se firma con HMAC-SHA256 en la cabecera X-Forms-Signature, para que tu endpoint pueda verificar que la petición vino de verdad de Dapta Forms. Al salir del campo se enmascara y dice Hay un secreto guardado: déjalo en blanco para conservarlo o escribe uno nuevo. El secreto no se vuelve a mostrar nunca.

URL del endpoint y secreto de firma. Los dos se guardan solos.

---

Paso 4: En Disparar en, elige qué respuestas se envían: Respuestas parciales, Respuestas completas, o las dos. Las dos vienen marcadas por defecto y al menos una tiene que quedar marcada.

Elige qué respuestas se envían a este webhook.

• Una respuesta parcial se envía cuando la persona pasa el Punto de envío parcial del formulario (por ejemplo justo después de la pregunta de correo) y todavía no ha terminado. En una pantalla de Diapositivas que muestra varias preguntas, se envía cuando la persona envía la pantalla que contiene el punto. Mira Varias preguntas en una pantalla.

• Una respuesta completa se envía cuando la persona llega al final. La misma sesión produce una entrega parcial y luego una completa; las dos llevan el mismo submission.id, y phase las distingue.

Con la protección contra spam activa, las respuestas parciales se guardan pero no se envían. Respuestas parciales sigue marcada y muestra En pausa mientras la protección contra spam está activa, y un webhook que solo escucha parciales avisa Este webhook no se va a disparar: solo escucha respuestas parciales, que están en pausa mientras la protección contra spam está activa.

---

Paso 5: Haz clic en Enviar prueba. Dapta Forms manda un cuerpo de ejemplo con la forma real, firmado con tu secreto, con respuestas inventadas, "test": true en los datos y un visit de ejemplo. Un aviso verde Prueba entregada: tu endpoint la aceptó. significa que tu endpoint contestó con un estado 2xx. Si no fue así, el aviso explica qué volvió (mira Probar y ver el historial de entregas).

Una prueba correcta. La petición de ejemplo llega a tu endpoint de verdad.

⚠️ Nota: Enviar prueba está disponible para Owners y Admins. Cualquier miembro puede editar los campos del webhook.

---

Referencia de ajustes

Ajuste	Qué hace
Interruptor Activado / Desactivado	Enciende o apaga el webhook sin perder sus ajustes. Apagado significa que no se encola nada para este webhook.
URL del endpoint	La URL https:// que recibe el POST. Vaciar el campo quita el webhook. Las direcciones privadas, de loopback, link-local y de metadatos de nube se bloquean antes de enviar.
Enviar prueba	Manda una petición de ejemplo firmada. Desactivado hasta que hay una URL guardada (si no: «Primero guarda una URL de webhook.»).
Secreto de firma (opcional)	Clave de la firma HMAC-SHA256 en X-Forms-Signature. Déjalo en blanco para conservar el actual; escribe un valor nuevo para rotarlo.
Disparar en	Respuestas parciales o Respuestas completas. Al menos una.
Historial del webhook	Una etiqueta de {n} entregas (o un {n} con error rojo) y el botón Ver historial que abre el registro de entregas.

Cómo se comporta una entrega

• Método POST, cabecera content-type: application/json, cuerpo = el sobre JSON descrito en Referencia del payload y las cabeceras.

• Tu endpoint tiene 10 segundos para contestar. Cualquier 2xx cuenta como entregada. Un 3xx nunca se sigue y cuenta como fallo, igual que 4xx, 5xx, tiempos agotados y errores de red.

• Los fallos se reintentan solos con retrasos crecientes (1 s, 2 s, 4 s, 8 s…), hasta 5 intentos. Después la entrega queda marcada con Falló y se conserva en el historial. Mira Entrega, reintentos e historial.

• No se envía nada a un webhook Desactivado, y una respuesta siempre se guarda aunque el webhook esté caído.

• Con la protección contra spam activa, solo se envían las respuestas completas y verificadas.

Varios webhooks en un formulario

Cada formulario puede tener más de un webhook, pero la tarjeta edita solo el primero. Cuando existen otros ves Este formulario tiene {count} webhook(s) más con la nota de que siguen funcionando exactamente como están y se guardan sin tocar, solo que no se editan desde aquí. Todos aparecen en el inventario de Webhooks de la página de Conexiones.

💡 Tip: Los parámetros UTM del enlace público (utm_source, utm_medium, …) viajan en el cuerpo de cada webhook, anidados en data.utm y otra vez en el nivel superior en utm, para que tu endpoint pueda atribuir el lead. Un formulario insertado con el fragmento completo los toma de la página que lo inserta cuando su propio enlace no trae ninguno. La página en sí viaja en visit: mira Referencia del payload y las cabeceras.

Qué sigue

• Referencia del payload y las cabeceras: todos los campos y cabeceras.

• Verificar la firma: fragmentos en Node.js y Python.

• Probar y ver el historial de entregas: cómo leer el diálogo de historial.

• Respuestas parciales: dónde va el punto de envío parcial.