Webhooks entrantes

Los sistemas externos envían eventos (p. ej. pedidos de Shopify) a Docklify — sin login, verificación HMAC.

Punto de entrada#

Los sistemas externos envían POST a POST /api/integration/webhooks/[code], donde code es el código del conector (P0: shopify). Sin login. La plataforma ejecuta el flujo webhook habilitado y publicado del tenant.

POST /api/integration/webhooks/shopify
x-shopify-topic: orders/create
x-shopify-shop-domain: my-store.myshopify.com
x-shopify-hmac-sha256: <hmac-signature>
Content-Type: application/json

{ "id": 123456789, "order_number": 1001, "line_items": [ … ], … }

Verificación HMAC y enrutamiento de tenant#

• Cuando trigger_config define webhook_secret, se verifica la firma x-shopify-hmac-sha256.
• Enrutamiento: x-shopify-shop-domain se compara con store_domain de la conexión; sin coincidencia pero candidato único, se usa; si no, 404.