WPForms Webhooks

Un webhook puede responder que todo fue bien y perder el dato

Conectas el formulario con tu CRM. Alguien lo envía, WPForms guarda la entrada, la API contesta 200 y el contacto aparece sin teléfono. Tu clave se llamaba phone y la API esperaba phone_number. Nadie recibe un error: la API aceptó la petición e ignoró lo que no reconoció.

Quitar el conector intermedio te libra de sus cuotas, y también de quien traducía tus campos al idioma del destino: ese trabajo pasa a ser tuyo.

WPForms Webhooks es el complemento de WPForms que envía los datos de un formulario a URL externas, CRM y otras herramientas al enviarse, sin límite de transferencias al mes. Compensa cuando tienes delante la documentación de la API de destino.

Lo que se configura en cada webhook

• Método: GET, POST, PUT, PATCH o DELETE.
• Formato: JSON o FORM.
• Secreto: genera un hash por petición, incluido en la cabecera, para verificar el origen. Está pensado para quien integra con su propia API.
• Cabeceras y cuerpo: pares de clave y valor, que pueden tomar campos del formulario o Smart Tags.
• Lógica condicional: dispara el webhook solo según las respuestas, por ejemplo cuando un mensaje contiene «Help».

Cómo leer los fallos y qué detalles de formato los causan

El código que devuelve la API suele señalar el problema:

• 401 o 403: autenticación. Clave errónea o caducada, o nombre de cabecera equivocado.
• 404: la URL. Una errata, un segmento de versión que falta o una barra final.
• 400 o 422: la API rechazó el contenido, a menudo por un parámetro obligatorio ausente o una fecha ilegible.
• 200 sin datos: las claves no coinciden, el caso del principio.

Para ver esas respuestas, activa el registro en WPForms, Tools, Logs, con los tipos Providers y Errors. Después apágalo, porque esas entradas pueden guardar datos que no quieres dejar en el servidor.

Si un webhook falla, la entrada y las notificaciones siguen su curso, porque es una petición aparte. Para un proceso crítico, vigila también el lado que recibe.

Los valores múltiples van unidos. Casillas, selección múltiple y direcciones se envían separados por dos barras verticales (||). Si la API espera una lista, tendrás que partir esa cadena en el servidor.

Los números viajan como texto. De forma predeterminada, los valores se envían como cadenas. Para mandarlos como números hace falta un fragmento de código.

La clave de API se puede guardar en un campo oculto. Un Hidden Field permite rellenarla en las cabeceras, y quien tenga acceso al constructor podrá leerla. Usa claves de alcance reducido.

Un solo suceso: el envío del formulario

El suceso es el envío del formulario. Entre sus funciones no hay recepción de datos externos ni cadenas de varios pasos.

No siempre es la vía fácil. Para Slack existe un complemento dedicado de WPForms, y enviar varios campos por webhook exige trabajo de desarrollo. Si existe una integración directa con tu servicio, compárala antes.

Requisitos y primer webhook de prueba

Necesitas WPForms instalado y activo, en su última versión, y un destino que acepte peticiones. Para empezar:

1. Abre el formulario en el constructor y entra en Settings, Webhooks.
2. Activa Enable Webhooks y ponle nombre.
3. Pega la URL y elige método y formato.
4. Copia los nombres de las claves desde la documentación de la API, respetando mayúsculas y guiones bajos.
5. Asigna a cada clave su campo del formulario y guarda.
6. Envía el formulario y comprueba en el destino que ha llegado cada campo, no solo el registro.

Otros caminos para sacar datos de WordPress

WPForms es el constructor sobre el que funciona. WP Webhooks Pro envía peticiones HTTP cuando algo ocurre en la web, recibe acciones desde fuera y encadena pasos en flujos, justo lo que este complemento deja fuera.

AutomatorWP Webhooks hace algo parecido dentro de AutomatorWP, enviando y recibiendo datos con servicios compatibles.

Dudas al conectar un formulario con una API

¿Necesito saber programar?

No para lo básico, aunque ayudan unos conocimientos técnicos. Convertir números o añadir el ID de la entrada sí pide código.

¿Se pierde la entrada si falla el webhook?

No. La entrada y las notificaciones se completan igualmente.

¿Puedo disparar el webhook solo en ciertos casos?

Sí, con la lógica condicional de cada webhook.