Glosario de IA · Integración
Webhook
En una frase
Un webhook es un aviso automático que un sistema envía a una dirección web de otro cuando ocurre un evento, por ejemplo una cita nueva o un mensaje recibido, para que ese segundo sistema reaccione al momento sin tener que preguntar.
También se llama: web hook · callback HTTP · notificación por evento · API inversa
¿Qué es un webhook?
Imagina que esperas un paquete. Puedes bajar al portal cada diez minutos a ver si ha llegado, o puedes dejar tu número para que el repartidor te llame. Lo primero es consultar una API una y otra vez. Lo segundo es un webhook: el sistema que tiene la novedad te avisa en cuanto ocurre.
Llévalo a tu empresa
La IA de UTIO, por API
Desde 29 €/mes + IVA
Para desarrolladores y agencias que montan sus propios productos.
Ver el API de IATécnicamente, un webhook es una llamada HTTP, casi siempre un POST, que un servicio envía a una URL que tú le has dado. Lleva un pequeño paquete de datos que describe el evento. Tu sistema lo recibe, contesta «recibido» y actúa.
Relacionado con este término
API de IA
- Transcripción, voz, texto, imagen, OCR y embeddings
- Claves por cliente con tope de gasto
- Monedero prepago: recarga mínima de 50 €
Desde 29 €/mes + IVA Cuenta con panel, más consumo
Ver el API de IACómo funciona
- Suscripción. En el servicio de origen indicas qué eventos te interesan (mensaje recibido, pago confirmado, llamada terminada) y a qué URL avisar.
- Evento. Cuando pasa algo, el servicio envía a esa URL un JSON con los datos.
- Respuesta rápida. Tu sistema confirma con un código 200. Si no responde, el emisor suele reintentar.
- Acción. Con los datos, tu sistema hace lo que toque: crear una ficha, enviar un correo, lanzar un flujo.
Un aviso típico tiene esta forma:
{
"event": "appointment.created",
"occurred_at": "2026-10-07T09:30:00Z",
"data": { "customer": "Ana López", "service": "Revisión" }
}Dos cuidados básicos: comprobar la firma del aviso y no procesar dos veces el mismo evento si llega repetido.
No confundas webhook con otros términos vecinos. Una API espera a que le preguntes. El MCP y el function calling sirven para que un modelo de IA use herramientas cuando lo decide. El webhook va al revés: es el mundo exterior el que despierta a tu sistema.
Ejemplo
Una autoescuela de Zaragoza usa una herramienta de reservas online. Cada vez que alguien reserva una clase práctica, la herramienta dispara un webhook. Un pequeño flujo de automatización con IA lo recibe, redacta un mensaje de bienvenida con la fecha y el nombre del profesor y lo deja en la ficha del alumno. Antes, alguien de la oficina revisaba las reservas dos veces al día.
Cómo te afecta en tu empresa
Los webhooks son el pegamento entre herramientas. Si quieres que un agente de IA reaccione a lo que pasa en tu tienda online, tu agenda o tu ERP, alguien tiene que avisarle, y lo normal es hacerlo así.
En UTIO, la API de IA es la otra mitad de esa conversación: tu sistema recibe el aviso y llama a la API para transcribir un audio, generar un texto o enviar un mensaje por WhatsApp, voz o email. Las llamadas que envían por un canal exigen la cabecera Idempotency-Key, así que si tu flujo reintenta porque un webhook llegó dos veces, el cliente no recibe el mensaje duplicado.
Preguntas frecuentes
¿Qué diferencia hay entre un webhook y una API?
En una API tu programa pregunta cuando lo necesita. En un webhook el otro sistema te avisa cuando ocurre algo, sin que preguntes. Por eso al webhook a veces se le llama «API inversa».
¿Qué pasa si mi servidor está caído cuando llega un webhook?
Depende de quien lo envía. Lo habitual es que reintente varias veces durante un tiempo. Por eso conviene que tu sistema sepa reconocer un aviso repetido y no lo procese dos veces.
¿Cómo sé que un webhook es legítimo?
Los servicios serios firman cada aviso con una clave secreta compartida. Tu sistema comprueba esa firma antes de hacer nada y descarta lo que no cuadre.
Términos relacionados
- API
Una API (interfaz de programación de aplicaciones) es un conjunto de reglas que permite que un programa pida datos o acciones a otro: envías una petición con un formato acordado y recibes una respuesta, sin necesidad de saber cómo está hecho por dentro.
- Automatización con IA
La automatización con IA es el uso de modelos de inteligencia artificial para hacer tareas que antes exigían criterio humano, como leer un mensaje, entender qué pide y decidir el siguiente paso, y no solo repetir pasos fijos definidos de antemano.
- Function calling
El function calling es la capacidad de un modelo de lenguaje de responder, en lugar de con texto, con una petición estructurada para usar una función concreta, con su nombre y sus parámetros. Tu sistema ejecuta esa función y le devuelve el resultado al modelo.
- MCP (Model Context Protocol)
MCP (Model Context Protocol) es un estándar abierto que define cómo una aplicación de IA se conecta a herramientas y fuentes de datos externas. Cada servicio se expone una vez como «servidor MCP» y cualquier asistente compatible puede usarlo sin una integración a medida.
Actualizado el