El buzón de entrada: qué es un Webhook

Objetivo práctico

Al terminar esta lección podrás explicar qué es un Webhook, en qué se diferencia de una API «normal», y por qué es la pieza que dispara la automatización cada vez que ocurre algo importante durante una llamada.

Resultado que obtendrás

Un modelo mental correcto de Webhook, necesario para entender el Tool Calling (módulo 3.4) y la automatización con n8n y Make (módulo 3.3).

Dónde encaja dentro del sistema final

Cuando el LLM decide activar una herramienta (Tool Calling) —por ejemplo, para reservar una cita— la forma técnica en que se lo comunica al sistema de automatización es, casi siempre, mediante un Webhook.

Conocimientos previos

• API (lección anterior).

Herramientas necesarias

• Un navegador con NVDA activo, en modo de exploración.

Modelo mental

Piensa en un buzón de entrada al que llega un recado. En lugar de que tú tengas que llamar cada cinco minutos preguntando «¿ha pasado ya algo?», dejas dicho tu buzón, y en cuanto ocurre el suceso que te interesa, alguien deposita ahí el recado automáticamente, sin que tengas que preguntar. Eso es un Webhook: en lugar de estar consultando constantemente si ha ocurrido algo, un sistema «avisa» automáticamente a otro, enviándole la información en el momento exacto en que sucede.

Explicación

Un Webhook es una URL (una dirección en internet) que un sistema pone a disposición de otro para recibir avisos automáticos cuando ocurre un evento concreto. Técnicamente, cuando ocurre ese evento, el sistema origen envía una petición HTTP de tipo POST a esa URL, con la información del suceso empaquetada normalmente en formato JSON (que verás en detalle en la siguiente lección).

En el sistema de este curso, un Webhook es la pieza que conecta el «cerebro» del agente (a través del Tool Calling) con la automatización externa (n8n o Make): cuando el LLM decide que hay que reservar una cita, no reserva la cita él mismo, sino que envía los datos necesarios a la URL de un Webhook, que n8n o Make están «escuchando». A partir de ahí, la automatización se encarga del resto: hablar con Google Calendar o Cal.com, y devolver una confirmación.

Vocabulario nuevo

Webhook

Piénsalo así: Un buzón de entrada al que llega un recado automáticamente, sin tener que preguntar.

URL que recibe automáticamente una notificación (mediante una petición HTTP POST) cuando ocurre un evento concreto en otro sistema.

Ejemplo: El agente activa una herramienta de reserva de cita; esa activación se traduce en el envío de los datos de la cita al Webhook configurado en n8n.

POST

Piénsalo así: Depositar un paquete cerrado con contenido en el buzón, en lugar de simplemente llamar a la puerta.

Método HTTP usado para enviar datos a un sistema (por ejemplo, a un Webhook), a diferencia de simplemente solicitar información sin enviar nada.

Ejemplo: El envío de los datos de una cita nueva hacia el Webhook de n8n se realiza mediante una petición POST.

Preparación

No se requiere preparación técnica.

Procedimiento paso a paso

1. Contexto: Vas a localizar los dos términos de esta lección, «Webhook» y «POST», en el Glosario del curso.

   Acción de teclado: Abre el Glosario (/glosario.php) y pulsa H hasta el encabezado de nivel 3 «Webhook», en el bloque «W».

   Respuesta esperada de NVDA: NVDA debería anunciar «Webhook, encabezado de nivel 3».

   Qué significa: Confirmas que el término está documentado y localizable por encabezados.

   Acción siguiente: Usa Ctrl + F para buscar «POST» dentro de la misma página y lee su definición.

2. Contexto: Practica la búsqueda cruzada de estos dos términos desde el Buscador del curso, no sólo desde el glosario.

   Acción de teclado: Ve al Buscador (/buscar.php), escribe Webhook en el campo «Término de búsqueda» y pulsa Enter.

   Respuesta esperada de NVDA: NVDA debería anunciar el número de lecciones encontradas que mencionan «Webhook» en su vocabulario o resumen.

   Qué significa: Un mismo término técnico puede aparecer en varias lecciones a lo largo del curso; el buscador te ayuda a encontrarlas todas.

   Acción siguiente: Abre uno de los resultados para comprobar en qué otro contexto se menciona «Webhook».

Errores frecuentes y diagnóstico

El agente confirma verbalmente una acción, pero el sistema de automatización nunca la recibe.

Cómo localizarlo: Puede deberse a una URL de Webhook mal configurada, a que la automatización no está activa, o a un error de autenticación entre el agente y el Webhook.

Solución: Se diagnostica revisando los registros (logs) tanto del agente como de n8n/Make, buscando si la petición POST llegó o no. Se practica en detalle en el módulo 3.4 y en el módulo 4.1.

Comprobación final

Explica con tus palabras la diferencia entre «preguntar constantemente si ha pasado algo» y «recibir un aviso automático cuando pasa». Si tu explicación usa correctamente la palabra Webhook, la comprobación es positiva.

Qué acabas de conseguir

Entiendes el mecanismo que conecta el razonamiento del agente con las acciones reales en el mundo exterior (reservar una cita, actualizar un dato), pieza central del módulo 3.4, Tool Calling.

Ejercicio práctico

Piensa en un ejemplo cotidiano de «buzón de avisos automáticos» que ya uses (una notificación de una app, una alerta de un banco) y describe qué evento la dispara y qué información contiene.

Resumen de lo imprescindible

• Un Webhook es una URL que recibe avisos automáticos cuando ocurre un evento concreto.
• Técnicamente, se implementa mediante una petición HTTP POST, normalmente con datos en formato JSON.
• Es la pieza que conecta el Tool Calling del agente con la automatización externa (n8n, Make).
• Si una acción confirmada verbalmente no llega a ejecutarse, el Webhook es uno de los primeros puntos a revisar.

No necesitas aprender todavía

Todavía no necesitas crear ningún Webhook a mano: en el módulo 3.4 se proporciona la configuración completa ya preparada.

Estoy preparado para continuar si puedo…

• Explicar qué es un Webhook usando la analogía del buzón de avisos.
• Explicar la diferencia entre «preguntar constantemente» y «recibir un aviso automático».
• Situar el Webhook dentro del flujo completo de Tool Calling.

Fuentes

• What is a Webhook? — Twilio (consultado el 2026-08-30)

Última actualización de esta lección: 2026-02-10.

Test de la lección

Para realizar el test y obtener Puntos de profesionalidad necesitas iniciar sesión o crear una cuenta.

Navegación

Lección anterior: La ventanilla de la oficina: qué es una API

Continuar con la siguiente lección: El formulario con casillas: qué es JSON

Descargar esta lección en PDF accesible