Cómo Conectar un Formulario a un Webhook
Los webhooks de formulario envían datos de envío desde un elemento Formulario a un endpoint HTTPS externo en tiempo real — junto con el almacenamiento en Leads.
Configura el webhook en el formulario en Page Builder. Usa Entrega de webhooks de formulario para monitorear y reenviar — no para agregar la URL la primera vez.
Antes de Empezar
Asegúrate de tener:
- Una página con un elemento Formulario (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 después de guardar la configuración de webhook.
- Opcional: Claves API de webhook si tu receptor valida firmas de Atomicat.
Consulta Elemento Formulario — configuración de webhook y Entrega de webhooks de formulario.
Paso 1: Abrir el Formulario en Page Builder
- Ve a Pages y haz clic en Edit en la página objetivo.
- Haz clic en el elemento Formulario en el canvas.
- Abre el drawer de edición a la derecha.
Paso 2: Agregar Configuración de Webhook
En el drawer del formulario, encuentra la configuración de Webhook (cuando esté disponible en tu workspace):
| Configuración | Qué hace |
|---|---|
| Nombre del webhook | Etiqueta interna para tu equipo y logs de entrega. |
| URL del webhook | Endpoint HTTPS que recibe JSON de envío. |
| Descripción | Nota opcional sobre destino CRM/automatización. |
| Enviar leads abandonados | Envía datos parciales cuando el visitante empieza pero no termina. |
Completa nombre y URL antes de probar. Usa nombres descriptivos (Lead Meta – página VSL) para que las pantallas de entrega sean buscables.
Paso 3: Opcional — Leads Abandonados
Habilita Enviar leads abandonados solo si:
- Tu proceso de seguimiento maneja envíos incompletos, y
- Las reglas de cumplimiento permiten exportar datos parciales.
El tráfico abandonado puede aumentar el volumen de webhooks — confirma que tu endpoint deduplica o etiqueta leads parciales.
Paso 4: Guardar y Publicar la Página
- Haz clic en Guardar en Page Builder.
- Publica 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 Leads de formulario
- Tu endpoint registró el payload con los campos esperados
- Prueba fallos de validación (campos obligatorios vacíos) para asegurar que envíos incorrectos no se envíen.
Repite con comportamiento abandonado si está habilitado (llenado parcial, salir de la página — el comportamiento depende de reglas del producto).
Paso 6: Monitorear y Reenviar Entregas
- Abre Leads de formulario → atajo Webhooks del encabezado (o navega a Entrega de webhooks de formulario).
- Revisa tarjetas de resumen: total, exitosos, fallidos, tasa de éxito.
- Filtra por estado, formulario o texto de búsqueda de URL.
- Haz clic en Ver detalles en una fila para payload y cuerpo de respuesta.
- Usa Reenviar 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 Formulario en Page Builder para cambiar la URL, luego republica.
Opcional: Historial de Webhook en el Formulario
Algunos workspaces exponen Historial de webhook en el drawer del elemento Formulario (estado de entrega, intentos, estado de reintento). Úsalo para verificaciones rápidas mientras editas la misma página.
Mejores Prácticas
- Prueba cada mapeo de campo implícitamente — tu endpoint debe esperar las claves de campo de Atomicat.
- Usa Claves API en el receptor cuando la política de seguridad lo requiera.
- Republica después de cambios de URL antes de ejecutar tráfico pagado de nuevo.
- Mantén un webhook por destino cuando los payloads difieren; usa nombres claros.
Solución de Problemas
| Problema | Qué intentar |
|---|---|
| No se recibió 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 esquema. |
| Payloads duplicados | Abandonado + envío pueden dispararse por separado — maneja en el servidor. |
| Cambio de URL no en vivo | Guarda formulario, republica página, limpia CDN/caché si aplica. |
| No encuentro configuración de webhook | El plan/workspace puede ocultar webhooks — consulta referencia del elemento Formulario. |
Resultado
Tu formulario envía envíos a tu endpoint HTTPS en la página en vivo mientras Atomicat almacena leads en Leads de formulario — con monitoreo y reenvío disponibles en Entrega de webhooks de formulario.
Documentación Relacionada
- Referencia del elemento Formulario
- Entrega de webhooks de formulario
- Claves API de webhook
- Cómo ver y exportar leads de formulario
- Solución de problemas de webhooks
FAQ
¿Dónde configuro la URL del webhook?
En el elemento Formulario en Page Builder — no en la pantalla de monitoreo de Entrega de webhooks de formulario.
¿Los envíos aún aparecen en Leads?
Sí cuando el formulario está configurado correctamente. Los webhooks son un canal de entrega en tiempo real adicional.
¿Debo publicar después de cambiar la URL del webhook?
Sí. Los visitantes en vivo usan la configuración de página publicada.
¿HTTP vs HTTPS?
Usa endpoints HTTPS que tu stack confíe. Sigue los mensajes de validación en el drawer del formulario.
¿Un formulario puede tener múltiples webhooks?
Depende de la UI del workspace — si solo se muestra una fila, usa middleware para distribuir o contacta soporte para patrones multi-destino.