¿Qué son los webhooks y cómo configurarlos en Sendcloud?

Ojetivo: aprende lo básico sobre webhooks y cómo configurarlos en tu panel de Sendcloud.

Para obtener más información sobre los webhooks de Sendcloud, consulta la sección sobre webhooks de nuestra documentación sobre la API. 

¿Qué son los webhooks?

Los webhooks hacen posible que las aplicaciones se comuniquen entre ellas en "tiempo real". Otra forma de que las aplicaciones se comuniquen es a través de una API. A diferencia de una API que funciona con polling (sondeo), un webhook recibe los datos en cuanto la aplicación los gestiona. No es necesario realizar ninguna solicitud, ya que se trata de un proceso automático. Por tanto, no tienes que preocuparte por un retraso en la comunicación.

Ejemplo: recepción de actualizaciones de seguimiento de Sendcloud

(Ver imagen más abajo como referencia)

1. Cuando recibes actualizaciones de seguimiento a través de la API, ocurre lo siguiente:
   Tu aplicación intenta obtener datos de seguimiento de Sendcloud por intervalos. Lo hará incluso cuando no haya nuevos datos disponibles.
2. Cuando quieres recibir actualizaciones de seguimiento a través de un webhook, sucede lo siguiente:
   Sendcloud envía las actualizaciones de seguimiento a tu aplicación tan pronto como estén disponibles en Sendcloud.

Webhooks de Sendcloud

Webhook Objeto de Integración: este webhook entra en juego cuando se añade una nueva integración API a Sendcloud. Se activa cuando se conecta, elimina o actualiza una integración API. Haz clic aquí para ver qué contiene la carga útil de este webhook.

Webhook Objeto Estado del Paquete Cambiado: este webhook se activa cuando cambia el estado de un paquete; no importa cuál sea el cambio de estado. Haz clic aquí para ver qué contiene la carga útil de este webhook.

Webhook Objeto Reembolso Solicitado: este webhook entra en juego cuando se solicita un reembolso. Haz clic aquí para ver la carga útil de este webhook.

¿Cómo configurar webhooks en Sendcloud?

Para que Sendcloud comunique activamente las actualizaciones de paquetes (como las actualizaciones de seguimiento), necesitas crear un endpoint API. Cada vez que se produzca una actualización, Sendcloud realizará una solicitud a través de ese endpoint. Para obtener más información, consulta la sección Webhooks de nuestra documentación API. 

1. Copia la URL del webhook de tu aplicación
2. Ve a tu panel de Sendcloud y abre la configuración de tu integración API en Configuración > Integraciones > Configurar
3. Marca la casilla Activar comentarios de Webhook
4. Copia la URL de tu webhook en el campo que se muestra a continuación
   
5. Prueba tu webhook haciendo clic en el botón Test API webhook
6. Haz clic en Guardar

¡Listo! Tu webhook ya está configurado y la carga útil debería empezar a llegar a tu aplicación. Puedes utilizarlo para configurar desencadenantes que conduzcan a determinadas acciones. Un ejemplo sería conectar tus correos electrónicos de seguimiento a las actualizaciones de seguimiento entrantes. De esta forma podrás proporcionar actualizaciones instantáneas a tus clientes.

En el caso de los paquetes devueltos, solo recibirás actualizaciones del webhook si el envío saliente se creó a través de la tienda API.

Haz clic aquí para ir a nuestra referencia de la API de Sendcloud y ver la carga útil del webhook.