AutomatorWP Webhooks

Una URL de webhook es una puerta con acciones detrás

Tu aplicación avisa a WordPress de un pago y WordPress inscribe a esa persona en un curso. Sin nadie en medio y con una sola petición a una dirección web.

Esa dirección ya no es un simple aviso: es un interruptor que ejecuta lo que hayas colgado de él. Si detrás hay una matrícula, un rango o un usuario nuevo, quien consiga hacer esa petición con los datos correctos activa ese proceso. La pregunta de seguridad no es si el webhook funciona, sino qué tiene que traer una petición para que tu web la obedezca.

Webhooks es el complemento de AutomatorWP que permite a WordPress enviar y recibir datos con cualquier web, aplicación o servicio compatible con webhooks o con una API REST.

Un disparador, una acción y dos etiquetas

Todo lo que añade es de la edición PRO y aparece dentro de la integración AutomatorWP.

• Recibir datos de un webhook: disparador para automatizaciones normales y anónimas, con su propia URL.
• Enviar datos a un webhook: acción con método POST, GET o PUT y formato FORM o JSON.
• Etiqueta de disparador: recupera los campos del webhook recibido.
• Etiqueta de respuesta: recupera lo que devuelve el servidor para usarlo en las acciones siguientes.
• Campos anidados: las claves se escriben separadas por barras, como data/first_name, con niveles ilimitados.

Con esas piezas se conectan dos webs (una compra en una inscribe en un curso en la otra), se clonan entradas o usuarios entre sitios, se enlaza con Zapier o Integromat, o se da a una aplicación propia una forma de inscribir usuarios o añadirlos a un grupo.

Qué debe traer una petición para ser aceptada

Una contraseña en forma de campo. Añade un campo, márcalo como obligatorio e indica el valor requerido, que debe coincidir exactamente. Si el valor se deja vacío, no se exige ninguno.

Los campos que esperas. Cada uno tiene clave, tipo y marca de obligatorio. El botón Get samples escucha una petición real y propone los campos.

Una forma de saber quién es el usuario. En automatizaciones con usuario, se asigna de tres maneras: el usuario conectado por la API REST de WordPress, un campo con su ID o un campo con su correo. Las automatizaciones anónimas no necesitan usuario asignado.

Cada entrada del registro de webhooks recoge la URL de origen, el método, los parámetros y el usuario asignado. Es el sitio para revisar qué ha llegado de verdad.

Depende de AutomatorWP y de lo que haya al otro lado

No funciona por sí solo. Es un complemento de AutomatorWP.

Para hablar con otro WordPress hace falta preparación en ambos lados. El otro sitio debe tener AutomatorWP y este complemento, o bien ofrecer su API REST.

Entre sus funciones no hay reintentos ni colas de envío.

Requisitos y primer webhook

Necesitas AutomatorWP, que pide WordPress 4.4 o superior y PHP 7.0 o superior. Para recibir datos:

1. Instala el complemento y crea una automatización.
2. Añade el disparador de recibir datos, dentro de la integración AutomatorWP.
3. Copia la URL en el servicio que enviará la petición.
4. Usa Get samples para capturar los campos de una petición real.
5. Añade un campo obligatorio con un valor requerido.
6. Configura cómo se determina el usuario y añade las acciones.
7. Revisa el registro antes de activar el proceso real.

Otras formas de conectar WordPress con el exterior

AutomatorWP Pro es la versión de pago de la plataforma sobre la que trabaja este complemento. WP Webhooks Pro es un plugin dedicado a lo mismo: envía peticiones HTTP cuando algo ocurre en la web, recibe acciones desde fuera y encadena pasos en flujos. Uncanny Automator Pro es otro sistema de automatización dentro de WordPress, basado en recetas, con condiciones y filtros.

Contraseña, JSON, respuestas y pruebas del webhook

¿Se puede proteger la URL con una contraseña?

Sí. Añade al disparador un campo obligatorio con un valor requerido. La petición debe enviarlo tal cual.

¿Envía JSON?

Sí. La acción de envío admite FORM o JSON. Con JSON y método POST o PUT, la cabecera Content-Type se ajusta sola a application/json.

¿Puedo leer lo que responde el servidor?

Sí. La etiqueta de respuesta deja esos datos disponibles para las acciones siguientes, incluidos los campos anidados.

¿Se puede probar antes de activar?

Sí. La acción de envío tiene un botón para mandar una petición de prueba, y el disparador puede escuchar una petición entrante.