Un pedido nuevo de la tienda online, un formulario rellenado en la web, un pago desde una pasarela de pago - le mostramos cómo conectar este tipo de eventos con su sistema mediante un webhook, y cómo sacar datos hacia fuera mediante una API.
Una tienda online, un sitio web o una pasarela de pago suelen funcionar como sistemas independientes que no se conocen entre sí - hasta que alguien los conecta a mano copiando datos. Los webhooks y la API resuelven precisamente esto: permiten que dos sistemas se envíen datos automáticamente, en el momento en que ocurre algo, sin un solo paso manual entre ellos.
Dos direcciones de conexión
Webhook - los datos entran. Un servicio externo (tienda online, pasarela de pago, formulario de la web) llama a su dirección ante un evento determinado y envía datos. La automatización recibe el webhook y ejecuta los siguientes pasos a partir de él - por ejemplo, crear un nuevo registro.
API - los datos salen. En la dirección contraria, mediante una clave de API, un sistema externo puede acceder por sí mismo a sus datos - por ejemplo, descargar el estado actual de un pedido o escribir un resultado de vuelta.
La mayoría de las conexiones reales combinan ambas direcciones: la web envía un pedido nuevo hacia dentro mediante un webhook y, más tarde, pregunta mediante la API en qué estado está.
El webhook recibe datos de donde sea y dispara una automatización.
La tienda online o la web llama al webhook con cada pedido nuevo, la automatización recibe los datos y crea directamente el registro correspondiente.
El procedimiento típico para conectar una tienda online
- Crea un webhook en su automatización - obtiene una dirección única a la que el sistema externo envía los datos.
- Introduce esa dirección en la configuración de la tienda online, la pasarela de pago o el formulario como el lugar al que deben enviarse las notificaciones del evento.
- Mapea los campos de los datos entrantes (nombre, correo, partidas del pedido) con las columnas de su base de datos.
- Añade los pasos siguientes - creación del registro, envío de una confirmación, asignación a la persona responsable.
Cuándo conviene una clave de API en lugar de un webhook
Un webhook es adecuado para reaccionar ante un evento puntual. Una clave de API conviene cuando necesita leer o escribir datos desde fuera de forma periódica o bajo demanda - por ejemplo, una herramienta interna que pregunta por registros nuevos una vez por hora, o un informe externo que descarga las cifras actuales.
A qué prestar atención
Verificar el origen de los datos. Un webhook solo debería aceptar datos de una fuente de confianza - normalmente esto se resuelve con una clave secreta que envía el remitente y que la automatización verifica antes de procesar los datos.
Datos que faltan o están incompletos. No todas las solicitudes entrantes tendrán todos los campos rellenados - la automatización debería tener una condición para el caso de que falte un valor obligatorio, en lugar de crear en silencio un registro incompleto.
Volumen de solicitudes. Si la tienda online genera cientos de pedidos al día, conviene contar desde el principio con que la automatización se ejecutará a menudo, e incorporar un control de duplicados.
Preguntas frecuentes sobre webhooks y API
¿Necesito un programador para conectar un webhook a mi tienda online?
En la mayoría de las plataformas de comercio electrónico habituales basta con copiar la dirección del webhook en la configuración de notificaciones - el mapeo de campos y los pasos siguientes se montan visualmente, sin escribir código.
¿Cómo sé si debo usar un webhook o una clave de API?
Use un webhook cuando quiera reaccionar a un evento concreto (un pedido nuevo, un pago). Use una clave de API cuando necesite leer o escribir datos según haga falta, no solo como reacción a un único evento.
¿Qué pasa si el sistema externo envía los datos en un formato que no encaja con mi base de datos?
Entre la recepción del webhook y la creación del registro se puede insertar un paso que remapee o transforme los datos al formato correcto antes de escribirlos.