Synchronisation du commerce externe

Aperçu

Canaux et intégrations → Commerce externe (/fr/integrations/commerce) maintient le processus de paiement sur Shopify ou WooCommerce tout en reflétant les données prises en charge dans OrderInChat. Le widget, l’IA WhatsApp et Instagram, les automatisations et les étiquettes d'expédition optionnelles utilisent les données reflétées.

Cette intégration ne clone pas le thème source et ne remplace pas le paiement externe.

Connexion Shopify

OrderInChat utilise Shopify OAuth afin que vous n'ayez pas à copier les jetons manuellement.

1. Dans le tableau de bord des partenaires Shopify, créez une application appelée Order in Chat.
2. Ajoutez l'URL de rappel https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback à URL(s) de redirection autorisées.
3. Accordez ces autorisations d'API Admin : read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. Dans OrderInChat, allez à Canaux et intégrations → Commerce externe, choisissez Shopify, entrez l'URL de la boutique HTTPS (par exemple https://your-store.myshopify.com) et cliquez sur Connecter avec Shopify.
5. Approuvez les autorisations dans Shopify. Vous revenez automatiquement à OrderInChat. Ensuite, cliquez sur Tester la connexion, Enregistrer les webhooks et Synchroniser maintenant.

Si vous ne pouvez pas utiliser OAuth, développez la section Configuration manuelle des jetons et collez le jeton d'accès API Admin et la clé secrète de l'application personnalisée. La clé secrète est nécessaire pour vérifier les signatures HMAC des webhooks Shopify. OrderInChat crypte les identifiants et ne les affiche plus jamais.

Guides officiels : Applications personnalisées Shopify et Jetons d'accès API Admin.

Connexion WooCommerce

Dans WordPress, ouvrez WooCommerce → Paramètres → Avancé → REST API, créez une clé avec une permission de lecture pour une synchronisation uniquement miroir, ou une permission de lecture/écriture si les modifications de l'éditeur en masse doivent être réécrites dans WooCommerce, et entrez l'URL de la boutique HTTPS, la clé consommateur et le secret consommateur. Pour synchroniser les pages et articles WordPress, entrez également un nom d'utilisateur WordPress et un Mot de passe d'application depuis Utilisateurs → Profil.

Guide officiel : API REST WooCommerce.

Certains hébergeurs rejettent l'authentification HTTP Basic. Le connecteur peut réessayer les requêtes WooCommerce avec une authentification par chaîne de requête ; les identifiants sont masqués dans les journaux.

Comportement de synchronisation

1. Enregistrez et testez la connexion.
2. Enregistrer les webhooks — crée des abonnements sur la boutique externe afin que les modifications de produit, de commande et de client notifient OrderInChat presque en temps réel. OrderInChat vérifie aussi régulièrement les modifications au cas où un webhook serait manqué.
3. Sélectionnez les ressources à refléter.
4. Exécutez la synchronisation initiale.

Par sécurité, OrderInChat vérifie chaque webhook et revérifie les données auprès de Shopify ou WooCommerce avant de les enregistrer. Les vérifications régulières rattrapent les webhooks manqués uniquement tant que l'utilisation comme source de commerce est activée. Si le statut du webhook indique une erreur et que la connexion est inactive, utilisez Enregistrer les webhooks et Synchroniser maintenant après des modifications sur la boutique source ; Tester la connexion seul ne met pas à jour les produits. Les mises à jour répétées ne créent pas de doublons.

Le poids d'expédition des variantes Shopify est importé depuis le poids de la variante dans Shopify ; l'éditeur de produit l'affiche dans l'unité de poids configurée pour la boutique. Les métadonnées de dimension nommées length, width ou height sont converties en centimètres. Les descriptions de produits Shopify proviennent de la description propre au produit, et non des sections ou bannières de thème partagées ; le texte du thème ne devient pas une description spécifique au produit. Les produits en brouillon et archivés ne sont pas affichés aux clients.

Lorsque votre boutique utilise le commerce externe, les clients achètent via l'URL du produit source. Le paiement du panier OrderInChat et les flux de paiement WhatsApp sont désactivés pour cette boutique.

Emplacements d'inventaire

Les emplacements Shopify et les niveaux d'inventaire par variante sont reflétés dans les enregistrements d'entrepôt/emplacement d'OrderInChat. Le stock des produits et des variantes affiche le total de tous les emplacements pour le chat et le paiement. Le cœur de WooCommerce expose une valeur totale de stock, donc elle est reflétée dans un emplacement virtuel par défaut ; le stock multi-emplacements provenant de plugins WooCommerce nécessite un plugin pris en charge.

Vous pouvez ajouter vos propres emplacements OrderInChat sous Catalogue → Inventaire. Les cellules de stock de l'éditeur en masse s'étendent par emplacement. Envoyer l'inventaire vers Shopify met à jour uniquement l'emplacement sélectionné et nécessite la portée write_inventory. Les champs de stock verrouillés ne sont pas écrasés par une synchronisation d'inventaire ultérieure.

Étiquettes d'expédition

Les étiquettes d'expédition OrderInChat sont désactivées par défaut. Activez-les uniquement si OrderInChat doit être le seul endroit où les étiquettes sont créées. Même lorsqu'elles sont activées, OrderInChat n'achète pas d'étiquette lorsque la commande externe a déjà des informations de traitement ou de suivi.

Extrait de widget

Shopify : Enregistrer les webhooks essaie également d'installer automatiquement le widget de chat sur votre boutique Shopify. Vous pouvez toujours coller l'extrait dans Custom Liquid si nécessaire. Accordez write_script_tags sur l'application personnalisée si l'auto-installation échoue.

WooCommerce : L'API REST ne peut pas injecter de scripts de thème. Copiez l'extrait JavaScript ou PHP depuis la page d'intégration dans le pied de page du thème ou functions.php.

Pages → Base de connaissances

Lorsque Pages et articles est activé, les pages/articles/politiques Shopify et les pages/articles WooCommerce sont ajoutées à la base de connaissances OrderInChat (ou mises à jour) pour les réponses IA. Les titres de politique Shopify correspondants remplissent également les champs de retour/conditions de la vitrine. Ce n'est pas un clone complet de thème/CMS.

Limitations de l'API

L'intégration signale des données non prises en charge ou non disponibles au lieu d'inventer des valeurs. Les limitations courantes incluent :

• Shopify n'expose pas tous les paramètres de paiement via l'API Admin.
• Les prix d'expédition calculés par le transporteur restent calculés lors du paiement externe.
• WooCommerce REST n'inclut pas les pages WordPress sans un mot de passe d'application WordPress.
• Les avis et réservations nécessitent une API de plateforme ou d'application qui expose ces ressources.
• Les ajouts de produits ne sont reflétés que lorsque l'API source a un équivalent réel.