Qué son API y webhook: así se hablan entre sí tus programas
Con una API tu programa pregunta y el otro contesta. Con un webhook el otro te avisa en cuanto pasa algo. Casi toda automatización se sostiene sobre API y webhook.
Descubre en 5 minutos cómo automatizar ese proceso que te está haciendo perder tiempo y dinero
Qué es, en corto
Una API es la puerta por la que un programa pide datos a otro o le entrega los suyos, siguiendo unas reglas publicadas. Un webhook es el aviso que ese otro programa envía en el instante en que ocurre algo, sin que nadie pregunte: con la API llamas tú y con el webhook te llaman a ti. Casi todo lo que se automatiza en una empresa se apoya en las dos cosas.
Estás en una reunión, alguien dice que tu programa de gestión «tiene API pero no manda webhooks» y todo el mundo asiente. Tú también. Media hora después esa frase decide si conectar tus sistemas cuesta dos días o dos semanas, así que conviene entenderla.
API y webhook, la diferencia en una frase
API y webhook resuelven la misma necesidad desde lados opuestos: que dos programas que no se conocen puedan trabajar juntos. Con la API preguntas tú; con el webhook te avisan a ti. Todo lo demás son detalles.
La API, con un ejemplo de mostrador
Imagina la ventanilla de un almacén. No entras a coger la mercancía por tu cuenta: pides lo que necesitas por la ventanilla, con un impreso concreto, y te lo dan. La API es esa ventanilla. Define qué se puede pedir, por ejemplo «dame los pedidos de hoy», qué se puede dejar, por ejemplo «crea este cliente», y en qué formato. Tú nunca entras en la base de datos del otro programa: hablas con su ventanilla y ella decide qué te enseña.
Eso tiene una ventaja que se agradece cuando algo va mal: si la API está bien hecha, no puedes romper nada por dentro. Y tiene un límite: solo puedes hacer lo que esa ventanilla ofrezca. Si el fabricante no ha publicado la operación que necesitas, no existe, por mucho que el dato esté ahí.
El webhook, el aviso que llega solo
Podrías pasarte por la ventanilla cada cinco minutos a preguntar si ha llegado el paquete. Se hace cuando no queda otra, se llama consultar en bucle y consume tiempo y recursos para casi siempre oír «todavía no». El webhook es que te llamen al móvil en cuanto llega: el programa que tiene la novedad manda un aviso a una dirección tuya y tu flujo arranca en ese mismo segundo. Por eso una tienda online puede facturar un pedido al instante en vez de en la revisión de la noche.
Dónde aparecen API y webhook en tu empresa
- La pasarela de pago avisa por webhook de cada cobro y de cada devolución.
- El formulario de la web entrega el contacto al CRM, el programa donde vive tu cartera de clientes, por su API.
- El programa de facturación acepta facturas nuevas por API y devuelve el número y el enlace al documento.
- El calendario confirma por webhook que se ha reservado un hueco, y así el agente no ofrece dos veces la misma hora.
- La tienda avisa de cada pedido y el almacén responde con el número de seguimiento.
Qué preguntar sobre API y webhook a tu proveedor de software
- ¿Hay API documentada y accesible, o hay que pedirla y esperar?
- ¿Manda webhooks y para qué eventos exactamente?
- ¿Cuántas peticiones por minuto aguanta antes de cortar?
- ¿Existe un entorno de pruebas para no ensuciar los datos reales?
- ¿Qué pasa cuando sacan una versión nueva y con cuánto tiempo avisan?
Esas cinco preguntas deciden el alcance entero. Las hacemos nosotros en la primera reunión, y si la respuesta es que no hay nada, lo decimos ahí mismo en vez de descubrirlo a mitad del proyecto.
Lo que hay que cuidar en un montaje con API y webhook
Las claves de acceso son la llave de tu sistema: viven en un almacén de secretos, nunca dentro del flujo ni en un correo. Los avisos se firman, para saber que vienen de quien dicen venir y no de alguien que ha adivinado la dirección. Todo paso que escriba en tu programa se protege contra duplicados, porque un webhook puede llegar dos veces y nadie quiere dos facturas iguales. Y cuando falla la red se reintenta con pausas, en vez de darse por vencido en el primer intento.
Queda lo más aburrido y lo que más rompe: los fabricantes cambian sus API y jubilan versiones. Enterarse antes que tú, probarlo y ajustarlo es parte del Servicio Gestionado, no una licencia de software.
Cuando tu programa no tiene API
Pasa más de lo que parece, sobre todo con software antiguo o muy vertical. Entonces se busca otro camino: leer un buzón de correo donde ese programa deja sus informes, tratar un fichero que se exporta a una carpeta cada noche, o en el peor caso un robot que imita clics en la pantalla. Funciona, es más frágil y se plantea como lo que es. Cuando el programa sí abre la puerta pero nadie ha construido el puente, eso es un conector a medida.
Dónde encaja esto
Los flujos de n8n, la herramienta con la que montamos las automatizaciones, hablan con tus programas por su API y se disparan con webhooks. Un agente de IA ejecuta acciones reales a través de ellas: por eso puede darte cita de verdad y no solo decirte que llames. Sin API y webhook no hay automatización que valga, solo pantallas bonitas.
Un ejemplo
Una tienda online con seiscientos pedidos al mes tiene un webhook en la pasarela de pago. En cuanto un pedido se cobra, el aviso llega al flujo: se emite la factura en el programa de facturación por su API, se descuentan las existencias, se avisa al almacén y el cliente recibe su documento. Si el pago se devuelve, otro aviso dispara la rectificativa. Si la factura ya se había emitido para ese pedido, el flujo lo detecta y no la duplica. Nadie mira el panel de la tienda a las once de la noche y nadie pasa el sábado cuadrando pedidos con facturas.
Con qué se confunde
Con estar integrado
Que tu programa tenga API y webhook no significa que esté conectado. La API es la puerta; la integración es el puente que alguien construye y mantiene. Que un software «se integre con todo» no quiere decir que esté integrado con lo tuyo.
Con una sincronización en los dos sentidos
Un webhook avisa en una dirección: el programa con la novedad te la cuenta. Que te llegue el aviso no implica que tu respuesta vuelva a él. La sincronización a dos bandas se diseña aparte, decidiendo quién manda cuando el dato cambia en ambos sitios.
Con una puerta abierta a cualquiera
Una API no es un acceso libre a tus datos. Se entra con clave, con permisos limitados y con registro de accesos. Los webhooks se firman para comprobar que el aviso viene de quien dice. Si nadie te habla de claves ni permisos, desconfía.
Saber qué significa una palabra está bien. Saber si te ahorra horas está mejor: eso es lo que te dice el diagnóstico.
Descubre en 5 minutos cómo automatizar ese proceso que te está haciendo perder tiempo y dinero
Lo que nos preguntan antes de decidirse
¿Qué diferencia hay entre API y webhook?
Quién da el primer paso. Con la API el primer paso lo das tú: tu sistema pregunta y el otro contesta, y por eso sirve para consultar y para escribir cuando tú decides. Con el webhook el primer paso lo da el otro: en cuanto pasa algo, te manda un aviso a una dirección tuya y tu flujo arranca solo. En un proyecto real se usan las dos: el webhook te dice que hay un pedido nuevo y la API te da el detalle y escribe la factura. Ni una sustituye a la otra ni hay que elegir.
¿Cómo sé si mi programa tiene API y webhook?
Búscalo en la documentación del fabricante, en la sección de desarrolladores o de integraciones, y si no lo encuentras pregunta por escrito. Lo que hay que confirmar son cinco cosas: si la API está documentada y accesible con tu plan, qué eventos manda por webhook, cuántas peticiones aguanta por minuto, si hay entorno de pruebas y con cuánto tiempo avisan de los cambios de versión. Muchos programas reservan la API a los planes altos, y eso conviene saberlo antes de cerrar el alcance, no después.
¿Se puede automatizar algo sin API y webhook?
Sí, y se hace a menudo, pero es peor. Cuando el programa no abre ninguna puerta se recurre a leer un buzón de correo donde deja sus avisos, a tratar un fichero exportado cada noche a una carpeta o a un robot que imita los clics de una persona en la pantalla. Las tres opciones funcionan y las tres son más frágiles: un cambio de formato, de asunto del correo o de posición de un botón las rompe. Por eso se plantean como lo que son, con más mantenimiento, y se avisa desde el principio.
¿Es seguro dejar que otro programa entre por una API?
Lo es si se monta con cabeza. Cada conexión usa su propia clave, con permisos limitados a lo estrictamente necesario, y esas claves viven en un almacén de secretos, nunca escritas dentro de un flujo ni enviadas por correo. Los webhooks entrantes se firman y se comprueba la firma antes de hacer nada. Todo queda registrado: quién pidió qué y cuándo. Si el trato con datos sensibles lo exige, el flujo y los registros se ejecutan en servidores propios en la Unión Europea con acuerdo de tratamiento firmado.
¿Qué pasa si un aviso llega dos veces o no llega?
Se contempla desde el diseño, porque las dos cosas pasan. Contra los avisos repetidos se usa una marca única por operación: si esa marca ya está registrada, el flujo lo ignora y no emite dos facturas del mismo pedido. Contra los avisos perdidos hay dos redes: reintentos con pausas cuando la red falla y una revisión periódica que compara lo que hay en el origen con lo que hay en el destino y recupera lo que falte. Cada ejecución queda en un registro, así que siempre se puede reconstruir qué pasó a las tres de la madrugada.
¿Cuánto se tarda en conectar dos programas?
Con API documentada y buenos accesos, una conexión sencilla se monta y se prueba en días. Lo que alarga el plazo casi nunca es programar: son los permisos, el entorno de pruebas que hay que pedir, los casos raros que aparecen al ver datos reales y las decisiones sobre qué hacer cuando el mismo dato cambia en los dos lados. Por eso el trabajo empieza con esas cinco preguntas al fabricante y con una prueba pequeña de principio a fin antes de montar nada grande.
Términos relacionados
¿Tus programas no se hablan entre ellos?
Dinos con qué software trabajas y qué datos copias de uno a otro. Te decimos qué se conecta por API y qué habrá que resolver de otra forma.
Descubre en 5 minutos cómo automatizar ese proceso que te está haciendo perder tiempo y dinero