Gravity Flow – Incoming Webhook Extension

Las reglas de tu formulario no vigilan lo que entra por el webhook

Tienes un desplegable obligatorio con las opciones de la A a la E. Una persona no puede saltárselo. Un sistema externo que actualiza esa entrada por webhook, en cambio, puede guardar el valor «Banana» y la entrada sigue su camino.

Gravity Flow limpia lo que llega, pero no comprueba que sea correcto. Los valores se sanean según el tipo de campo, lo que bloquea un script inyectado. Lo que no se revisa es si el campo es obligatorio o si el formato encaja. Si otra aplicación va a escribir en tus entradas, la calidad del dato depende de esa aplicación, y conviene comprobarla allí o ampliar la validación por tu lado.

Incoming Webhook permite que un flujo de Gravity Flow espere una señal externa y que otros sistemas creen entradas de formulario. No crea flujos ni envía datos hacia fuera: para esto último Gravity Flow tiene un paso aparte, Outgoing Webhook.

Retener una entrada o crear una nueva

Paso de flujo. Una persona envía el formulario y, en el punto que elijas, la entrada se detiene hasta recibir una petición autenticada.

Crear una entrada. Un sistema externo envía un POST a una dirección definida en un feed, se crea la entrada y arranca el flujo. Se configura en los ajustes del formulario, y puedes añadir varios webhooks para que varios sistemas alimenten el mismo formulario.

La elección es sencilla: si el flujo empieza con un formulario enviado por una persona, necesitas el paso. Si empieza fuera, necesitas el feed.

La petición que libera una entrada

• Dirección: un POST a /wp-json/gf/v2/entries/[ID]/workflow-hooks, con el ID de la entrada. La versión 2 de la API de Gravity Forms es la recomendada, y la 1 sigue admitida.
• Autenticación: workflow-api-key y workflow-api-secret, en el cuerpo o como parámetros de la URL.
• Sin mapeo de campos: con una petición válida, el flujo pasa al siguiente paso.
• Con mapeo: los valores recibidos se guardan en los campos elegidos.

La clave API no debería cambiar después de guardarla. Si la cambias con entradas en ese paso, pueden quedarse atascadas. El secreto, en cambio, conviene renovarlo cada cierto tiempo.

El feed de creación funciona distinto. Su URL lleva un ID y una clave, y quien la consiga puede crear entradas, así que trátala como una contraseña. Para una verificación más fuerte, el filtro gravityflowincomingwebhook_check_permissions admite código propio, como la comprobación de una firma HMAC.

Cómo se reparten los datos en los campos

La petición puede llevar form-data o JSON. Los campos con varias partes, como nombre o dirección, reciben el valor entero o por elementos, y las casillas admiten una lista de objetos con id y value. Para entrar en una estructura anidada se usa la barra invertida, con rutas como people\0\name.

Quedan fuera del mapeo estos tipos:

• Subida múltiple de archivos: la subida de un solo archivo sí funciona.
• Campos de entrada: título, contenido, extracto, etiquetas, categoría, imágenes y campo personalizado.
• Campos de precio: producto, cantidad, opciones, envío y total.

Si quieres validar valores u origen, la vía es usar la versión 2 de la API y ampliar la API REST de WordPress, lo que supone escribir código.

Conectar el primer sistema externo

Necesita Gravity Flow, que trabaja sobre Gravity Forms, y un certificado SSL en el servidor. Después, para el paso de flujo:

1. Añade un paso de tipo Incoming Webhook en el punto donde deba esperar.
2. Ponle nombre y fija la clave y el secreto.
3. Elige si la petición solo avanza el flujo o si además guarda campos.
4. Envía una entrada de prueba y lanza la petición con su ID, por ejemplo desde Postman.
5. Comprueba el resultado en la pantalla de estado del flujo.

Piezas cercanas para tus automatizaciones

Gravity Flow PDF Generator añade pasos de PDF al mismo flujo, por ejemplo después de que el sistema externo haya completado los datos.

Si buscas lanzar automatizaciones en lugar de flujos de aprobación, AutomatorWP Webhooks conecta peticiones externas con acciones en WordPress. Para enviar envíos de WPForms a otra API, está WPForms Webhooks.

Respuestas y errores de cada petición

¿Qué responde al crear una entrada?

Un código 200 con el ID de la entrada nueva.

¿Qué reviso si recibo un error 400 o 500?

Que la cabecera Content-Type coincida con la codificación del cuerpo, y que las claves del JSON sean las del mapeo de campos.