Cómo conectar un formulario a un webhook
Form webhooks envían datos de envío de un elemento Form a un endpoint HTTPS externo en tiempo real — junto con almacenamiento en Leads.
Configura el webhook en el formulario en Page Builder. Usa Form webhook delivery para monitorizar y reenviar — no para añadir la URL la primera vez.
Antes de empezar
Asegúrate de tener:
- Una página con un elemento Form (o sigue Cómo agregar un formulario a una página primero).
- Un endpoint HTTPS listo para aceptar payloads POST.
- Permiso para publicar la página tras guardar la configuración del webhook.
- Opcional: Webhook API keys si tu receptor valida firmas Atomicat.
Consulta Elemento Form — configuración de webhook y Form webhook delivery.
Paso 1: Abrir el Form en Page Builder
- Ve a Pages y haz clic en Edit en la página objetivo.
- Haz clic en el elemento Form en el canvas.
- Abre el panel de edición a la derecha.
Paso 2: Añadir configuración de webhook
En el panel del formulario, encuentra la configuración Webhook (cuando esté disponible en tu workspace):
| Configuración | Qué hace |
|---|---|
| Webhook name | Etiqueta interna para tu equipo y logs de entrega. |
| Webhook URL | Endpoint HTTPS que recibe JSON de envío. |
| Description | Nota opcional sobre destino CRM/automatización. |
| Send abandoned leads | Envía datos parciales cuando el visitante empieza pero no termina. |
Rellena name y URL antes de probar. Usa nombres descriptivos (Meta lead – VSL page) para que las pantallas de entrega sigan siendo buscables.
Paso 3: Opcional — Leads abandonados
Activa Send abandoned leads solo si:
- Tu proceso de follow-up maneja envíos incompletos, y
- Las reglas de compliance permiten exportar datos parciales.
El tráfico abandonado puede aumentar el volumen de webhook — confirma que tu endpoint deduplica o etiqueta leads parciales.
Paso 4: Guardar y publicar la página
- Haz clic en Save en Page Builder.
- Publish la página en el sitio/dominio en vivo. Consulta Publicar una página.
La configuración de webhook en una página solo borrador no envía tráfico de producción a tu endpoint.
Paso 5: Probar en la URL publicada
- Abre la URL HTTPS en vivo en incógnito.
- Envía el formulario con datos de prueba realistas (todos los campos obligatorios).
- Confirma:
- El lead aparece en Form leads
- Tu endpoint registró el payload con los campos esperados
- Prueba fallos de validación (campos obligatorios vacíos) para asegurar que envíos inválidos no se envían incorrectamente.
Repite con comportamiento abandoned si está activado (relleno parcial, salir de la página — el comportamiento depende de las reglas del producto).
Paso 6: Monitorizar y reenviar entregas
- Abre Form leads → acceso directo del encabezado Webhooks (o navega a Form webhook delivery).
- Revisa tarjetas de resumen: total, successful, failed, success rate.
- Filtra por status, form o search de texto de URL.
- Haz clic en View details en una fila para payload y cuerpo de respuesta.
- Usa Resend en filas fallidas cuando el destino estuvo temporalmente caído.
No puedes editar la URL del webhook en esta pantalla — vuelve a la configuración del elemento Form en Page Builder para cambiar URL, luego republica.
Opcional: Historial de webhook en el Form
Algunos workspaces exponen Webhook history en el panel del elemento Form (estado de entrega, intentos, estado de retry). Úsalo para comprobaciones rápidas mientras editas la misma página.
Buenas prácticas
- Prueba cada mapeo de campo implícitamente — tu endpoint debe esperar claves de campo Atomicat.
- Usa API keys en el receptor cuando la política de seguridad lo exija.
- Republica tras cambios de URL antes de volver a ejecutar tráfico de pago.
- Mantén un webhook por destino cuando los payloads difieren; usa nombres claros.
Solución de problemas
| Problema | Qué probar |
|---|---|
| No se recibe webhook | ¿Página publicada? Prueba URL en vivo, no vista previa del builder. |
| 4xx/5xx en el receptor | Inspecciona detalles de entrega; valida auth y schema. |
| Payloads duplicados | Abandoned + submit pueden dispararse por separado — trátalo en el servidor. |
| Cambio de URL no en vivo | Guarda formulario, republica página, limpia CDN/caché si aplica. |
| No encuentra configuración de webhook | Plan/workspace puede ocultar webhooks — consulta referencia del elemento Form. |
Resultado
Tu formulario envía envíos a tu endpoint HTTPS en la página en vivo mientras Atomicat almacena leads en Form leads — con monitorización y reenvío disponibles en Form webhook delivery.
Documentación relacionada
- Referencia del elemento Form
- Form webhook delivery
- Webhook API keys
- Cómo ver y exportar leads de formulario
- Solución de problemas de webhooks
Preguntas frecuentes
¿Dónde configuro la URL del webhook?
En el elemento Form en Page Builder — no en la pantalla de monitorización Form webhook delivery.
¿Los envíos siguen apareciendo en Leads?
Sí cuando el formulario está configurado correctamente. Los webhooks son un canal adicional de entrega en tiempo real.
¿Debo publicar tras cambiar la URL del webhook?
Sí. Los visitantes en vivo usan la configuración de la página publicada.
¿HTTP vs HTTPS?
Usa endpoints HTTPS en los que confíe tu stack. Sigue los mensajes de validación en el panel del formulario.
¿Un formulario puede tener varios webhooks?
Depende de la UI del workspace — si solo se muestra una fila, usa middleware para fan-out o contacta soporte para patrones multi-destino.