Inhoud
Pour lier une boutique en ligne Woocommerce, vous avez besoin de trois « clés » (keys). Une clé API, une clé API secrète et une clé webhook secrète.
Conseil de pro
Assurez-vous qu'avant de créer la connexion, toutes les commandes « ouvertes » aient été traitées dans votre boutique en ligne Woocommerce. De cette façon, vous évitez les éventuelles différences de stock.
Création de clés API
La connexion API permet à Webship de communiquer avec votre boutique Woocommerce. Il s’agit notamment de consulter des commandes, des informations sur les produits et d’adapter le statut des commandes. Il s’agit notamment de demander des commandes et des informations sur les produits, de modifier le statut des commandes, etc. Nous vous présentons ci-dessous le plan étape par étape pour lier une boutique en ligne Woocommerce à Webship Online.
- Connectez-vous à votre boutique en ligne Woocommerce
- Allez dans « Woocommerce » => « Paramètres » => « Avancé »
- Cliquez sur « Rest API »
- Cliquez sur « Ajouter une clé »
- Remplissez le champ « Description »: Webship Online
- Sous « Droits », sélectionnez: Lire/Écrire
- Vous verrez les deux premières clés
- Attention: ne fermez pas cette fenêtre, vous ne verrez ces clés qu’une seule fois
- Ouvrir Webship Online dans un nouvel onglet ou une nouvelle fenêtre
- Allez dans « Boutiques » et ajoutez une nouvelle boutique.
- Donnez un nom à la boutique et choisissez « Boutique en ligne », puis choisissez « Woocommerce »
- Sous « Configuration de l’API », saisissez les deux clés générées
- API key = clé client, API secret = secret client
- N’oubliez pas de saisir l’URL complète de votre boutique (y compris http ou https) dans le champ « API endpoint »
- Ne pas fermer la fenêtre dans Webship Online mais revenir à Woocommerce
Attention
Après avoir configuré l'API et avant de configurer les webhooks, vous devez effectuer une synchronisation des produits et des commandes, dans cet ordre. Après avoir défini les clés API, vous verrez deux boutons de synchronisation sous vos paramètres API dans Webship Online.
Ajouter des webhooks
Les webhooks garantissent que Woocommerce notifie immédiatement (en temps réel) notre application de tout changement au niveau des commandes. Sans les webhooks, Webship Online recevra les changements à des heures fixes et non en temps réel.
Premier webhook: mise à jour de la commande
- Enfin, nous devons ajouter trois webhooks dans Woocommerce. Cela permet de garantir que les changements de statut des commandes dans Woocommerce sont également transmis à Webship Online
- Nous commençons par le premier webhook
- Dans Woocommerce, accédez à « Woocommerce » => « Paramètres » => « Avancé » => « Webhooks »
- Cliquez sur « Ajouter webhook »
- Veuillez remplir les champs suivants:
- Nom: Webship Online – order updated
- Statut: Actif
- Objet: Commande mise à jour (Order updated)
- Url de livraison: https://app.webship.online/webhooks/woocommerce
- Secret: (laissez ouvert pour le moment)
- Version de l’API: WP REST API-intégration V3
- Cliquez sur « Sauvegarder webhook »
- Le champ « Secret » sera rempli automatiquement après l’enregistrement
- Copiez cette clé secrète et retournez à Webship Online
- Sous « Configuration des webhooks », entrez cette clé secrète partagée sous « Clé secrète »
- N’oubliez pas d’indiquer le nom de domaine complet de votre boutique en ligne dans la rubrique « Origine » (y compris http ou https)
- Choisissez les commandes que vous souhaitez recevoir dans Webship Online en utilisant le filtre de statut ou un filtre avancé (le statut le plus utilisé est « processing »)
- Sauvegarder cette configuration dans Webship Online
Deuxième webhook: commande créée
- Dans Woocommerce, accédez à « Woocommerce » => « Paramètres » => « Avancé » => « Webhooks »
- Cliquez sur « Add webhook »
- Veuillez remplir les champs suivants:
- Nom: Webship Online – commande créée
- Statut: Actif
- Objet: Ordre créé (Order created)
- Url de livraison: https://app.webship.online/webhooks/woocommerce
- Secret: copiez ici la clé secrète précédemment créée à partir du premier webhook
- Version de l’API: WP REST API-intégration V3
- Cliquez sur « Sauvegarder Webhook »
Troisième webhook: commande supprimée
- Cliquez sur « Ajouter webhook »
- Veuillez remplir les champs suivants:
- Nom: Webship Online – order deleted
- Statut: Actif
- Objet: Commande supprimé (Order deleted)
- Url de livraison: https://app.webship.online/webhooks/woocommerce
- Secret: copiez ici la clé secrète précédemment créée à partir du premier webhook
- Version de l’API : WP REST API-intégration V3
- Cliquez sur « Sauvegarder webhook »