Browse all articles

Configurer les webhooks de commandes Shopify

Last updated

Connectez d’abord votre boutique Shopify

ChannelDock reconnaît un webhook par le domaine .myshopify.com de la boutique. Si la boutique n’est pas encore connectée comme canal de vente dans ChannelDock, le webhook est rejeté avec No API!. Connectez la boutique sous My Channels avant de continuer.

Le point de terminaison webhook

Champ Valeur
URL https://channeldock.com/portal/webhook/shopify/orders
Event / topic Order creation
Format JSON
API version Latest (laissez la valeur par défaut Shopify)

Copiez l’URL exactement — sans barre oblique finale. ChannelDock associe l’appel entrant à votre boutique connectée automatiquement via l’en-tête X-Shopify-Shop-Domain.

Étapes dans l’admin Shopify

1 Ouvrez votre admin Shopify

Allez sur admin.shopify.com et connectez-vous à la boutique que vous avez connectée à ChannelDock.

2 Allez dans Settings → Notifications

Cliquez sur Settings (en bas à gauche), puis sur Notifications.

3 Ouvrez la section Webhooks

Sur la page Notifications, cliquez sur Webhooks (près du bas). Puis cliquez sur Create webhook.

4 Configurez le webhook

Renseignez la fenêtre de dialogue exactement comme ci-dessous :

Paramètre Choisir
Event Order creation
Format JSON
URL https://channeldock.com/portal/webhook/shopify/orders
Webhook API version Laisser par défaut

5 Enregistrer

Cliquez sur Save. Shopify enverra désormais chaque nouvelle commande à ChannelDock dès qu’elle arrive.


Optionnel : ajouter d’autres événements

La même URL accepte d’autres événements de commande. Répétez l’étape 4 pour chacun que vous souhaitez, en utilisant la même URL et le format JSON.

Order creation

Recommandé. Importe les nouvelles commandes instantanément. C’est le seul événement dont vous avez besoin pour une importation en temps réel.

Order payment

Optionnel. Utile si vous souhaitez agir uniquement sur les commandes une fois qu’elles sont marquées comme payées.


Vérifier que cela fonctionne

  1. Passez une commande test dans votre boutique Shopify (ou utilisez le bouton Send test notification de Shopify à côté du webhook).
  2. En un instant, la commande devrait apparaître dans ChannelDock sous vos commandes.

Dépannage

Vous voyez Signification / solution
No API! La boutique n’est pas connectée dans ChannelDock, ou l’URL ne correspond pas au domaine .myshopify.com de la boutique. Reconnectez sous My Channels.
Webhook échoue / non-200 dans Shopify Vérifiez que l’URL est exacte (pas de barre oblique finale, https) et que le format est JSON.
La commande n’apparaît pas ChannelDock ignore les commandes qu’il possède déjà. Utilisez une nouvelle commande test pour confirmer l’importation.

Les webhooks complètent — ils ne remplacent pas — la synchronisation ChannelDock régulière. Si un webhook est manqué, la synchronisation planifiée normale récupère quand même la commande.


Was this helpful?

Related articles