Propósito: Descubre cómo habilitar el feedback del webhook en Sendcloud y configurarlo para tus integraciones personalizadas.
¿Qué es el Feedback del Webhook?
El feedback del webhook permite que tu aplicación reciba actualizaciones en tiempo real desde Sendcloud cada vez que ocurra un evento importante, como un cambio en el estado de una expedición. En lugar de tener que enviar solicitudes manuales o periódicas, Sendcloud envía automáticamente estas actualizaciones directamente a tu aplicación.
API vs. Webhook:
- API: Tu aplicación envía regularmente solicitudes para obtener datos, incluso cuando no hay nuevas actualizaciones.
- Webhook: Sendcloud envía automáticamente los datos a tu aplicación tan pronto como ocurre un evento (por ejemplo, un cambio en el estado de una expedición).
Ejemplo: Actualizaciones de seguimiento mediante Webhooks
- API: Tu aplicación envía solicitudes a intervalos regulares para obtener los datos de seguimiento de Sendcloud, aunque no haya nuevas actualizaciones.
- Webhook: Sendcloud envía inmediatamente las actualizaciones de seguimiento a tu aplicación cuando hay nueva información disponible, permitiéndote ofrecer actualizaciones en tiempo real a tus clientes.
Si quieres saber más, consulta nuestro artículo: ¿Qué son los webhooks y cómo configurarlos en Sendcloud?
Cómo configurar los Webhooks en Sendcloud
1. Crea un Endpoint API
Para recibir actualizaciones a través de webhook, necesitas un endpoint API que pueda manejar las solicitudes entrantes de Sendcloud.
2. Configura el feedback del Webhook en Sendcloud:
- Accede al panel de control de Sendcloud y ve a Configuración > Integraciones > Configurar.
- Marca la casilla para habilitar el Feedback del webhook.
3. Introduce la URL del Webhook:
- Copia la URL del webhook desde tu aplicación y pégala en el campo URL del Webhook en Sendcloud.
4. Si es necesario, configura una Webhook Signature Key:
Esta es una contraseña utilizada para firmar todas las solicitudes de webhook enviadas por Sendcloud. La clave debe:
- Tener al menos 16 caracteres.
- Contener al menos un número, una letra mayúscula, una letra minúscula y un carácter especial.
5. Prueba tu Webhook:
Haz clic en el botón Test API Webhook para verificar la configuración. Si el webhook funciona correctamente, deberías empezar a recibir los payloads en tu aplicación.
6. Guarda:
Haz clic en Guardar para finalizar la configuración.
Webhook Events soportados por Sendcloud
Existen dos categorías de integraciones soportadas por los webhooks de Sendcloud:
1. Para integraciones API:
Sendcloud soporta los siguientes eventos webhook:
- Webhook Parcel Status Changed Event: Activado cada vez que cambia el estado de una expedición.
- Webhook Integration Event: Activado cuando una nueva integración API es conectada, eliminada o actualizada en Sendcloud.
- Webhook Refund Requested Event: Activado cuando se solicita un reembolso para una expedición.
2. Para las siguientes integraciones:
Sendcloud solo soporta el Webhook Parcel Status Changed Event, que envía actualizaciones cuando cambia el estado de una expedición:
- Amazon v2
- Bol
- CCVshop v2
- Ebay v2
- Epages
- Etsy v2
- Lightspeed v2
- Magento v2
- Mijnwebwinkel
- Prestashop
- Prestashop v2
- Shopify
- Shopify v2
- Woocommerce
- Woocommerce v2
Para estas integraciones, Sendcloud envía automáticamente las actualizaciones sobre el estado de las expediciones directamente a tu aplicación, permitiendo actualizaciones automáticas en tu plataforma e-commerce.
Pruebas y Solución de Problemas
Una vez que hayas configurado el webhook, es importante probarlo haciendo clic en el botón Test API Webhook en el panel de Sendcloud. Esto confirmará que la configuración es correcta y que tu endpoint está recibiendo correctamente las actualizaciones.