Automatización
API y webhook: integración entre sistemas explicada para gerentes
En toda conversación sobre automatización aparecen dos palabras: API y webhook. Quien decide la inversión generalmente no es técnico y se queda sin saber si lo que le proponen es simple o complicado, barato o caro. Este texto explica las dos cosas sin código, desde el punto de vista de quien tiene que decidir.
Por qué integrar sistemas
La mayor parte del trabajo manual en una oficina existe porque los sistemas no conversan entre sí. La venta se registra en un lugar y alguien la copia en otro. El pago llega al banco y alguien lo da de baja en finanzas. Cada copia consume tiempo y abre espacio para el error.
Asana estimó, en el Anatomy of Work Index de 2021, que cerca del 60% del tiempo en el trabajo de oficina se va en actividades alrededor de la tarea, como buscar información y pasar datos de un lugar a otro. Integrar sistemas ataca directamente esa parte. El principio es uno solo: el dato entra una vez y llega solo a todos los lugares que lo necesitan.
Qué es una API
Una API es la puerta de servicio de un sistema. Por la pantalla, quien lo usa es una persona: hace clic, escribe y lee. Por la API, quien lo usa es otro sistema: pide una información o manda una instrucción, en un formato acordado, y recibe la respuesta.
Una comparación que ayuda: la pantalla es el salón del restaurante y la API es el mostrador de pedidos para llevar. El plato es el mismo, pero el mostrador fue hecho para atender pedidos en volumen, sin conversación.
Cuando un proveedor dice que el sistema "tiene API", está diciendo que otros sistemas pueden consultar y guardar datos ahí sin que nadie tenga que abrir la pantalla. Conviene preguntar qué permite exactamente la API, porque algunas habilitan solo la consulta y otras cubren casi todo.
Qué es un webhook
Con la API, un sistema tiene que preguntar: "¿llegó un pago nuevo?". Para enterarse rápido, tendría que preguntar todo el tiempo. El webhook invierte la dirección. Es un aviso automático: cuando algo ocurre, el sistema de origen envía un mensaje a una dirección acordada. "Pago confirmado, pedido 1048."
Volviendo al restaurante: la API es llamar para saber si el pedido ya salió. El webhook es que el restaurante te avise cuando sale.
En la práctica, los dos trabajan juntos. El webhook avisa que algo ocurrió, y la API se usa a continuación para buscar los detalles y guardar el resultado en otro lugar.
Cuándo usar cada uno
| Situación | Camino habitual |
|---|---|
| Reaccionar al instante a un evento (pago, mensaje recibido, formulario enviado) | Webhook |
| Buscar o guardar datos bajo demanda | API |
| Rutina con hora fija (reporte diario, conciliación nocturna) | API en una tarea programada |
| Sistema antiguo sin API ni webhook | Exportación de archivo o cambio de sistema |
La última fila es la que más pesa en una decisión de compra. Un sistema barato sin puerta de integración sale caro, porque condena a alguien a copiar datos para siempre.
Cómo queda una integración en la práctica
Imagina una tienda que vende por su sitio web y atiende por WhatsApp. Hoy, cuando se paga un pedido, una persona revisa el banco, marca el pedido como pagado, avisa al almacén y le manda un mensaje al cliente. Con integración, el flujo queda así:
- El medio de pago envía un webhook: pago confirmado.
- La automatización recibe el aviso y, por la API de la tienda, marca el pedido como pagado.
- Por la API del sistema de inventario, reserva los productos.
- Por la API oficial de WhatsApp, envía la confirmación al cliente.
- Registra todo en un historial y avisa a una persona si alguna etapa falla.
Nadie tocó nada, y el cliente recibió la confirmación en segundos. El quinto paso es lo que separa una integración seria de una improvisación.
Preguntas para hacerle al proveedor o a quien va a construir
No necesitas entender el código. Necesitas hacer las preguntas correctas.
- ¿Qué pasa cuando falla? Los sistemas se caen. La integración tiene que reintentar y avisar a alguien, no perder el dato en silencio.
- ¿Dónde veo lo que corrió? Tiene que existir un registro de lo que entró, de lo que salió y de lo que dio error.
- ¿Quién recibe la alerta? Una persona con nombre, no "el equipo".
- ¿Cómo se guardan las contraseñas y las claves? Una clave de API es como la llave de la empresa. No va en una hoja de cálculo ni en un mensaje.
- ¿La API es oficial? Una integración por un camino no oficial suele romperse cuando el sistema cambia y puede violar los términos de uso. En WhatsApp esto es especialmente importante, como explicamos en Agente de IA en WhatsApp.
- ¿Hay límite de uso? Muchas API limitan el número de llamadas por minuto o cobran por volumen.
Una buena integración es la que nadie nota hasta el día en que falla. Y, ese día, avisa.
Plataforma lista o código propio
Hay dos caminos para construir, y ninguno es siempre mejor.
Las plataformas de automatización conectan sistemas conocidos con bloques visuales. Son rápidas para empezar y buenas para flujos simples. El costo crece con el volumen, y los flujos complejos se vuelven difíciles de mantener.
El código propio da más control sobre las reglas, la seguridad, el costo por volumen y el manejo de fallas. Exige a alguien que lo mantenga.
El criterio es el mismo que en cualquier decisión de proceso: elige el sistema más pequeño que resuelva el problema. Muchas operaciones conviven bien con los dos, usando plataforma para lo simple y código para lo crítico.
Por dónde empezar
Haz una lista de los sistemas que usa la empresa y, para cada par, responde: ¿qué dato copia hoy alguien de uno al otro? Esa lista es tu mapa de integraciones. Ordénala por tiempo gastado y riesgo de error, como mostramos en Qué automatizar primero, y empieza por la primera.
La automatización de rutinas e integraciones es uno de los servicios de delpra™. Si quieres saber en qué punto está tu operación antes de invertir, el diagnóstico gratuito te lo muestra.
Escrito por el equipo delpra™Procesos, automatización e IA para que la operación escale con eficiencia.