Enviar datos del formulario a un webhook

La pestaña Webhook envía un envío AJAX aceptado como un POST JSON a través de HTTPS. Úsala cuando otro servicio necesite valores estructurados después de la validación de POM Forms.

Prepara el receptor

El endpoint debe:

• Usar HTTPS.
• Aceptar JSON.
• Devolver una respuesta 2xx en caso de éxito.
• Gestionar entregas duplicadas de forma segura.
• Verificar la firma cuando se configure un secreto.
• Ignorar los campos que no necesite.

No uses una URL temporal de inspección de solicitudes en un formulario publicado.

Configura la entrega

1. Abre el formulario.
2. Elige Webhook → Webhook Configuration.
3. Activa Enable Webhook.
4. Introduce la Webhook URL.
5. Opcionalmente, introduce la Secret Key.
6. Guarda el formulario.
7. Usa la prueba de webhook disponible con datos de ejemplo no confidenciales.
8. Envía el formulario activo y verifica el receptor de producción.

El secreto crea un encabezado X-POM-Forms-Signature con este formato:

sha256=HMAC_OF_RAW_JSON_BODY

El receptor debe calcular el HMAC SHA-256 sobre el cuerpo exacto de la solicitud sin modificar con el secreto compartido y compararlo de forma segura.

Comprende la estructura del JSON

La carga útil agrupa:

• form: ID y nombre del formulario
• submission: ID almacenado cuando está disponible, tiempo de procesamiento y estado
• fields: valores de campo visibles y saneados
• files: información de archivos locales o de Drive
• meta: URL del sitio, URL de referencia y agente de usuario del navegador cuando están disponibles

Los campos ocultos por lógica condicional se omiten. El ID de envío es null cuando el almacenamiento está desactivado o no se almacenó ningún registro.

Conoce el límite de la entrega

El procesamiento del webhook ocurre después del almacenamiento y las notificaciones, y antes de la creación opcional de entradas. Un error del webhook se registra en el historial de eventos del envío cuando existe una entrada almacenada, pero el visitante puede recibir igualmente la respuesta de éxito del formulario. Supervisa el servicio receptor cuando la entrega del webhook sea crítica para el negocio.

Form Action URL (GET) y Form Action URL (POST) son modos de envío independientes. Eluden la pestaña Webhook y el resto de la cadena de acciones interna.

Si la entrega falla, confirma que la URL es HTTPS pública, que el receptor acepta JSON dentro del tiempo de espera de la solicitud y que devuelve 2xx. Rota el secreto compartido en ambos lados si queda expuesto.