Recientemente fui a acampar y, como estaba fuera de la red, las capacidades de mi smartphone eran bastante limitadas. Mi aplicación meteorológica no completó ningún dato, no pude ver mi ubicación en Apple Maps y no pude enviar ni recibir ningún mensaje directo. Una pesadilla de la era digital.
Ahora imagine tener una conexión celular e Internet perfecta pero lidiar con exactamente el mismo problema: así de inútil sería nuestra tecnología sin las interfaces de programación de aplicaciones (API) y los webhooks. Ambos son esenciales para la comunicación entre software, entonces ¿en qué se diferencian los webhooks y las API? Aquí está la esencia:
Las API abren la puerta a la comunicación de ida y vuelta entre aplicaciones de software a través de solicitudes: la aplicación A solicita información a la aplicación B, y la aplicación B decide si envía la información.
Un webhook es un tipo de API impulsada por eventos. En lugar de enviar información en respuesta a la solicitud de otra aplicación, un webhook envía información o realiza una función específica en respuesta a un trigger, como la hora del día, hacer clic en un botón o recibir el envío de un formulario. Dado que la aplicación que envía los datos inicia la transferencia, los webhooks suelen denominarse "APIs inversas".
En esta guía, desmitificaré los webhooks y las API para que puedas lograr que tus aplicaciones se comuniquen y envíen datos automáticamente de una a otra.
Tabla de contenido:
Cuándo usar un webhook
Los webhooks no requieren mucha "conversación": los datos fluyen en una dirección en lugar de dos. Son simplemente puntos de conexión API especificados por un desarrollador, lo que los hace bastante simples en comparación con las API completas.
Dado que están programados para no tener acceso a tanta información como los sistemas API completos, sus usos son bastante limitados. Sin embargo, resultan útiles cuando un usuario desea completar una función de una aplicación sin necesidad de abrirla. A continuación se presentan algunas ideas sobre cuándo tendría más sentido utilizar un webhook:
Actualización del estado de suscripción del usuario en su sistema de gestión de relaciones con el cliente (integración) cuando un usuario cancela su suscripción
Enviar recordatorios automáticos sobre reuniones cinco minutos antes de su inicio programado
Envío de notificaciones por correo electrónico que avisan a los usuarios que intentan comunicarse con un empleado con licencia de PTO sobre su fecha de regreso
Notificar a un usuario que posee acciones de una empresa cuando el precio de las acciones cae un 5% en un día
Cuando una solicitud de webhook no está formateada correctamente, no recibirás una respuesta detallada que te diga por qué falló tu función; solo recibirás un código de estado como 200 o 404. Por este motivo, es importante probar su webhook (y verificarlo periódicamente) para asegurarse de que funciona correctamente.
Por ejemplo, es posible que desee que un webhook agregue el nombre de un usuario a su integración, pero el webhook podría estar configurado para aceptar solo un formato de nombre específico (por ejemplo, solo dos conjuntos de caracteres: "nombre" y "apellido"). En este caso, cada usuario que ingrese un segundo nombre o que tenga dos nombres (por ejemplo, "George Michael Smith") confundiría el webhook y no se agregaría a la integración. Volver a verificar la configuración de su webhook podría identificar este problema y evitar la pérdida de datos.
Ejemplos de configuración de webhooks
Cadena de suministro de FedEx
FedEx Supply Chain es un proveedor de logística y subsidiaria de FedEx que se especializa en almacenamiento y distribución. Puede generar una URL de webhook en la aplicación para realizar un seguimiento de los eventos que suceden en ella. De esta manera, no necesita realizar llamadas frecuentes para obtener datos nuevos: simplemente recibe actualizaciones a medida que se producen. Por ejemplo, se podría programar un webhook para enviar actualizaciones a medida que un producto avanza por las etapas del proceso de distribución.
Zapier
Los webhooks tienen que ver con integraciones—la especialidad deZapier. Con Webhooks de Zapier, no es necesario jugar con el código para configurar un webhook. Puede habilitar fácilmente sus aplicaciones para que se comuniquen entre sí y personalizar el mensaje que desea que se envíe como webhook. Simplemente toma la URL que Zapier genera para el destinatario, conéctala a la plataforma desde donde quieres que provenga la notificación y redacta tu mensaje en Zapier.
Más información: 7 formas de usar webhooks para automatizar casi cualquier cosa
Slack
Slack ofrece webhooks como una forma de conectarse con aplicaciones y servicios externos. Con los webhooks entrantes, puedes enviar mensajes automatizados desde otras aplicaciones directamente a tus canales de Slack. Por ejemplo, puede configurar un webhook para notificar a su equipo sobre nuevos clientes futuribles, tickets de atención al cliente o cargas de archivos.
Cuándo utilizar una API
Las API mantienen la comunicación fluida entre sus aplicaciones en un formato legible por máquinas (generalmente JSON o XML), por lo que son su mejor opción cuando trabaja con datos que sabe que cambian o se actualizan constantemente. Piense en datos basados en el clima y la ubicación: prácticamente siempre hay algo nuevo para cargar.
La naturaleza comunicativa de las API también les permite realizar tareas que los webhooks por sí solos no pueden. A continuación se muestran algunos ejemplos comunes de casos en los que una API sería preferible a un webhook:
Seguimiento de envíos para un negocio de comercio electrónico
Extraer datos de tráfico para una aplicación de mapas
Usar una aplicación MFA de terceros para iniciar el registro en el portal de su empresa
Ejemplos de API en acción
PayPal
A través de las API, PayPal permite a sus clientes completar una variedad de transacciones, incluidos pagos, suscripciones, facturación y más. Tiene sentido por qué PayPal confía en las API. Es una billetera digital, lo que significa que debe comunicarse con su(s) banco(s), así como con innumerables sistemas POS para completar transacciones.
Spotify
Como cualquier otra aplicación de transmisión de música, Spotify depende de API para recuperar datos de música y mantener las listas de reproducción de los usuarios. Cuando un usuario busca un artista, álbum o canción específica, Spotify muestra resultados de la búsqueda del usuario a través de una API. La plataforma incluso extrae datos del historial de escucha de un usuario para crear mezclas y listas de reproducción diseñadas específicamente para ellos.
Uber
No debería sorprendernos que Uber utilice API para funcionar. Es necesaria mucha comunicación entre las bases de datos, los usuarios y el software para que la aplicación identifique las ubicaciones del usuario y del conductor, recopile datos de viajes y calificaciones, y comparta esos datos con ambas partes.
Webhook vs. API: El resultado final
Los webhooks y las API se utilizan ampliamente en el software que utilizamos a diario y son tan similares que sus usos individuales pueden resultar confusos. Dado que un webhook es solo un tipo específico de API, la confusión tiene sentido.
En resumen, los webhooks permiten compartir datos de manera liviana entre software cuando se lleva a cabo una acción específica, mientras que las APIs requieren la solicitud del usuario en un extremo para solicitar o modificar datos en el otro extremo.
Si desea enviar una notificación o actualizar información tan pronto como se cumpla un determinado criterio, evite la molestia de una API: simplemente implemente un webhook simple. Si está lidiando con datos fluctuantes o desea modificar los datos en lugar de simplemente enviar una notificación, probablemente necesitará implementar una API.
Al elegir entre los dos, la pregunta más importante que hay que hacerse es si los datos a los que se desea acceder se actualizan constantemente. Si es así, probablemente tendrá más sentido una API que un webhook. Si no es así, considere implementar un webhook en su lugar.
Al final, no hay necesidad de iniciar un debate sobre webhook frente a API: ambos son necesarios para que las aplicaciones que amamos funcionen.
Conecta todas tus aplicaciones usando webhooks de Zapier
Jugar con el código de tus aplicaciones puede ser tedioso y frustrante (o imposible, si no eres programador), por lo que Webhooks de Zapier te permite conectar tus aplicaciones e implementar webhooks sin necesidad de ingresar a los backends de tus aplicaciones y agregar un script JSON. Son webhooks sin código, y le permiten conectar todas sus aplicaciones para mantener sus flujos de trabajo de misión crítica en funcionamiento. A continuación se muestran algunos ejemplos para ayudarle a comenzar.
Agregar información a una hoja de cálculo de Google desde nuevas solicitudes POST de webhook
Enviar correos electrónicos con nuevos webhooks capturados
OBTENER datos de una URL de webhook todos los días
Zapier es la plataforma de orquestación de IA más conectada: se integra con miles de aplicaciones de socios como Google, Salesforce y Microsoft. Utilice interfaces, tablas de datos y lógica para crear sistemas seguros, automatizados y con tecnología de IA para sus flujos de trabajo críticos para el negocio en toda la pila tecnológica de su organización. Más información.
Preguntas frecuentes sobre webhooks y API
Ya sea que todavía tenga dudas o simplemente esté buscando refrescar la memoria, aquí encontrará respuestas claras a las preguntas más comunes.
¿Cuál es la diferencia clave entre un webhook y una API?
Las API son manuales: es necesario solicitarles que extraigan o modifiquen datos. Los webhooks envían datos automáticamente en respuesta a un evento específico sin ninguna solicitud de otro software.
Los webhooks son un subconjunto de las API y, por lo tanto, son mucho más limitados que las API: solo pueden enviar información. Las API son más versátiles. Son el intermediario entre diferentes programas, por lo que cuando usted, como usuario, intenta aprender o modificar algo en otro programa, la API verifica si tiene derecho a hacerlo y aprueba o rechaza la solicitud.
¿Un webhook es solo una API REST?
REST es un conjunto de reglas o restricciones arquitectónicas impuestas a las API, mientras que un webhook es un subconjunto de una API. Dado que una API REST requiere que un usuario haga una solicitud de datos para que se envíen esos datos, no es lo mismo que un webhook, que no requiere una solicitud de datos.
¿Cual es mejor?
Ni los webhooks ni las API son mejores que los demás; simplemente se utilizan para circunstancias diferentes. Las API son ciertamente más versátiles que los webhooks, mientras que los webhooks son más simples y livianos.
Lecturas relacionadas:
Este artículo fue publicado originalmente en diciembre 2022. La actualización más reciente, con contribuciones de Allisa Boulette, fue en diciembre 2024.
