3.5Webhooks e integraciones a medida
Lo esencial en 30 segundos
- El webhook desencadena en tiempo real: una URL proporcionada por tu escenario; en cuanto un servicio envía datos a ella, el escenario arranca instantáneamente.
- El módulo HTTP lo llama todo: petición GET/POST (URL, método, encabezados, cuerpo) hacia cualquier API, respuesta a menudo en JSON para mapear.
- Los secretos siguen siendo secretos: clave de API vía las conexiones cifradas de la herramienta, nunca en claro — y webhook probado antes de construir lo siguiente.
Minicaso seguido — Lina une su herramienta de negocio sin conector
Lina, encargada de digitalización en Orán, usa una herramienta de negocio sin conector listo para usar: imposible de enchufar en estándar. Crea un escenario desencadenado por webhook, pega la URL proporcionada en los ajustes de notificaciones de la herramienta y luego envía una llamada de prueba cuya estructura observa. En el otro sentido, añade un módulo HTTP que llama a la API del servicio (con la clave guardada en la conexión cifrada), recupera la respuesta y mapea sus campos hacia la base. El no-code se vuelve sin límite.
Último episodio del hilo Lina — de la elección de la herramienta a las integraciones a medida: la automatización avanzada de principio a fin.
1. El webhook, desencadenante universal
Cuando una aplicación no tiene conector listo, se pasa por los webhooks y las llamadas de API. Un webhook es una URL que proporciona tu escenario: en cuanto otro servicio envía datos a esa URL (validación de un pago, de un formulario, de un evento a medida), el escenario se desencadena instantáneamente con esos datos. Es el desencadenante universal, en tiempo real.
El principio que hay que entender: «una dirección que, cuando se le habla, despierta mi automatización». No hace falta programar: se pega la URL en los ajustes «webhook / notificaciones» del otro servicio, se envía una llamada de prueba y se observa la estructura recibida para el mapping.
2. El módulo HTTP y la disciplina de los secretos
En el otro sentido, el módulo HTTP permite llamar a cualquier API: enviar una petición (GET, POST…) a un servicio, con sus parámetros y su autenticación, y recuperar la respuesta (a menudo en JSON) para lo siguiente del escenario. Comprender las bases (URL, método, encabezados, cuerpo, JSON) abre el acceso a miles de servicios incluso sin conector oficial.
Disciplina no negociable: la clave de API es una contraseña — conexiones cifradas de la herramienta, derechos mínimos, regeneración si ha podido filtrarse, nunca en claro en el escenario ni en una captura compartida. Webhooks (entrada) + llamadas HTTP (salida) hacen que el no-code sea realmente sin límite: también es el puente hacia la IA y las integraciones a medida del nivel 4.
🔎 Ejemplo concreto — Recibir por webhook y luego llamar a una API
Lina enchufa lo inenchufable, en ambos sentidos.
Desencadenante: Webhook (URL proporcionada por el escenario)
→ el servicio envía datos (JSON) con cada evento
Módulo HTTP: llamar a una API (GET/POST, encabezados, clave cifrada)
→ recuperar la respuesta JSON, mapear hacia la acción siguiente.Lectura: entrada en tiempo real por un lado, salida a medida por el otro.
Lección: probar la recepción del webhook antes de construir lo siguiente.
Vocabulario de la sección
- Webhook
- URL proporcionada por tu escenario; recibir datos en ella lo desencadena instantáneamente (desencadenante universal, tiempo real).
Ejemplo sencillo: La URL que Lina pega en las notificaciones de su herramienta de negocio.
Lo que no es: una comprobación periódica con retardo (polling).
Reflejo: enviar una llamada de prueba y observar la estructura recibida.
- API
- Interfaz que permite a dos programas comunicarse: se envía una petición, se recibe una respuesta (a menudo en JSON).
Ejemplo sencillo: La API de la herramienta de negocio que Lina interroga vía HTTP.
Lo que no es: un conector listo para usar ya integrado.
Reflejo: leer la documentación de la API antes de la primera llamada.
- Petición HTTP
- Llamada a una API (método GET/POST…, URL, encabezados, cuerpo) para leer o enviar datos.
Ejemplo sencillo: La llamada parametrizada de Lina hacia el servicio externo.
Lo que no es: un simple desencadenante por formulario.
Reflejo: verificar método, URL y encabezados antes de enviar.
- JSON
- Formato de texto estándar de intercambio de datos estructurados (pares clave/valor, listas) devuelto por la mayoría de las API.
Ejemplo sencillo: La respuesta recibida por Lina, mapeada campo por campo.
Lo que no es: un documento con formato para impresión.
Reflejo: mapear cada clave JSON hacia el campo destinatario correcto.
- Autenticación (API key/token)
- Mecanismo que prueba tu identidad ante una API (clave, token), para transmitir en la petición y mantener en secreto.
Ejemplo sencillo: La clave de Lina guardada en la conexión cifrada de la herramienta.
Lo que no es: una clave pegada en claro en el escenario compartido.
Reflejo: secreto cifrado + derechos mínimos + regeneración en caso de duda.
En la práctica — Desencadenar por webhook y llamar a una API
- Crea un escenario desencadenado por un webhook: copia la URL proporcionada y configura un servicio para que le envíe datos.
- Envía una primera llamada de prueba y observa los datos recibidos (estructura JSON) en el escenario.
- Añade un módulo HTTP para llamar a una API externa (método, URL, encabezados, clave vía la conexión cifrada).
- Recupera la respuesta JSON y mapea sus campos hacia la acción siguiente; prueba de principio a fin.
Guion listo para decir — enchufar una herramienta sin conector (30 s)
«Esta herramienta no tiene conector, así que paso a medida. Uno: creo un desencadenante webhook, pego su URL en las notificaciones de la herramienta y envío una llamada de prueba. Dos: añado un módulo HTTP para llamar a su API, clave en la conexión cifrada, y mapeo la respuesta JSON hacia nuestra base. Pruebo de principio a fin antes de activar.»
Para decir antes de enchufar; no pegar nunca una clave real en una demo compartida.
Modelo copiar-pegar — payload webhook (ejemplo ficticio)
// PAYLOAD RECIBIDO EN EL WEBHOOK — datos y URL ficticios (ejemplo pedagógico)
// URL ficticia : https://exemple-fictif.test/crochet/abc123 (no utilizar tal cual)
{
"evenement": "demande_recue",
"contact": { "nom": "Exemple Fictif", "objet": "DEVIS" },
"articles": [ { "nom": "Article A", "montant": 1200 } ]
}
// MAPEO → base de datos : nom → Contacto, objet → Título, articles → iterador (3.4)TPE / autónomo
Un webhook basta para unir un formulario o una herramienta sencilla en tiempo real, sin cambiar de suscripción.
Pyme en Orán
Lina une su herramienta de negocio al seguimiento interno: webhook en entrada, HTTP en salida, secretos cifrados.
Equipo digital
Documentar cada integración a medida (URL, método, mapping JSON) para mantenerla sin depender de una persona.
Principiante
Practicar primero solo con el webhook: recibir una llamada de prueba y observar los datos antes de cualquier llamada HTTP.
✓ Buenas prácticas
- Usar un webhook para un desencadenamiento universal en tiempo real.
- Llamar a las API ausentes vía el módulo HTTP (JSON).
- Guardar las claves de API de forma cifrada (conexiones integradas).
✗ Errores frecuentes
- Poner una clave de API en claro en el escenario.
- Olvidar la autenticación/los encabezados en una petición HTTP.
- No probar la recepción del webhook antes de construir lo siguiente.
Puntos clave
- Un webhook es una URL que desencadena el escenario instantáneamente cuando un servicio le envía datos.
- El módulo HTTP llama a cualquier API (GET/POST, encabezados, cuerpo) y recupera la respuesta.
- Los datos transitan a menudo en JSON (clave/valor, listas) para mapear hacia lo siguiente.
- Webhooks + llamadas HTTP dan acceso a los servicios sin conector oficial — el no-code sin límite.
Reto 48h — aplica mañana
Crea 1 escenario webhook, envía una llamada de prueba y observa la estructura JSON recibida.
- Sé lo que es un webhook en tiempo real.
- Sé llamar a una API vía HTTP + JSON.
- Mis claves están en conexión cifrada, nunca en claro.
Preguntas frecuentes
¿Un webhook es complicado? ¿Hay que programar?
No, no hace falta programar. En concreto, la herramienta te da una URL; basta con indicar esa URL en el otro servicio (en sus ajustes «webhook» / «notificaciones») para que envíe datos a ella con cada evento. Tu escenario los recibe y se desencadena. Lo único que hay que entender es el principio: «una dirección que, cuando se le habla, despierta mi automatización». Los datos llegan en JSON, que la herramienta muestra de forma legible para el mapping. Suele ser más sencillo y más instantáneo que un conector clásico, y funciona con casi todo servicio capaz de enviar un webhook.
¿Dónde pongo mi clave de API para llamar a un servicio con seguridad?
Nunca en claro en el cuerpo visible del escenario ni en un campo compartido. Los buenos reflejos: usar las conexiones/autenticaciones integradas de la herramienta (que guardan el secreto de forma cifrada), o variables de entorno/cajas de secretos cuando están disponibles (especialmente con n8n, nivel 4). Una clave de API es una contraseña: quien la obtiene puede actuar en tu nombre y consumir tus cuotas. Se mantiene en secreto, se regenera si se ha filtrado y se limitan sus derechos al mínimo necesario. La seguridad de los secretos se detalla en la sección 4.5.
¿Qué permite un webhook?