連携
外部コマースの同期
ShopifyまたはWooCommerceを接続し、ライブコマースデータをOrderInChatにミラーリングします。
概要
チャネルと連携 → 外部コマース (/ja/integrations/commerce) は、ShopifyまたはWooCommerceでのチェックアウトを維持しながら、サポートされているデータをOrderInChatにミラーリングします。ウィジェット、WhatsAppおよびInstagram AI、自動化、オプションの配送ラベルは、ミラーリングされたデータを使用します。
この統合は、ソーステーマをクローンせず、外部チェックアウトを置き換えません。
Shopify接続
OrderInChatはShopify OAuthを使用するため、トークンを手動でコピーする必要はありません。
- ShopifyパートナーダッシュボードでOrder in Chatというアプリを作成します。
- コールバックURL
https://app.orderinchat.com/api/store/commerce/shopify/oauth/callbackを許可されたリダイレクトURLに追加します。 - 次のAdmin APIスコープを付与します:
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。 - OrderInChatでチャネルと連携 → 外部コマースに移動し、Shopifyを選択し、HTTPSショップURL（例:
https://your-store.myshopify.com）を入力してShopifyと接続をクリックします。 - Shopifyで権限を承認します。自動的にOrderInChatに戻ります。その後、接続をテスト、Webhookを登録、および今すぐ同期をクリックします。
OAuthを使用できない場合は、手動トークン設定セクションを展開し、Admin APIアクセス・トークンとカスタムアプリAPIシークレットキーを貼り付けます。APIシークレットはShopify webhook HMAC署名を検証するために必要です。OrderInChatは資格情報を暗号化し、再表示することはありません。
公式ガイド: Shopifyカスタムアプリ および Admin APIアクセス・トークン。
WooCommerce接続
WordPressでWooCommerce → 設定 → 高度な設定 → REST APIを開き、ミラー専用の読み取り権限を持つキーを作成するか、バルクエディタの変更をWooCommerceに書き戻す必要がある場合は読み取り/書き込み権限を持つキーを作成し、HTTPSストアURL、消費者キー、および消費者シークレットを入力します。WordPressのページや投稿を同期するには、WordPressのユーザー名とユーザー → プロフィールからのアプリケーションパスワードも入力します。
公式ガイド: WooCommerce REST API。
一部のホストはHTTP基本認証を拒否します。コネクタはクエリ文字列認証を使用してWooCommerceリクエストを再試行できます; 資格情報はログから削除されます。
同期動作
- 接続を保存してテストします。
- Webhookを登録 — 外部ストアにサブスクリプションを作成し、商品、注文、および顧客の変更がOrderInChatにほぼリアルタイムで通知されます。Webhookが見逃された場合に備えて、OrderInChatは定期的に変更も確認します。
- ミラーリングするリソースを選択します。
- 初期同期を実行します。
安全のため、OrderInChatはすべてのWebhookを検証し、保存する前にShopifyまたはWooCommerceでデータを再確認します。定期的な確認は、コマースソースとして使用するが有効な間のみ、見逃されたWebhookを補います。Webhookのステータスにエラーが表示され、接続が非アクティブな場合は、ソースストアの変更後にWebhookを登録および今すぐ同期を使用します; 接続をテストするだけでは商品は更新されません。繰り返しの更新で重複レコードが作成されることはありません。
ShopifyのバリアントのShopify上の重量から配送重量がインポートされます; 商品エディタはそれをショップで設定された重量単位で表示します。length、width、またはheightという名前の寸法メタフィールドはセンチメートルに変換されます。Shopifyの商品説明は商品自体の説明から取得され、共有テーマセクションやバナーからは取得されません; テーマのコピーは商品固有の説明にはなりません。ドラフトおよびアーカイブされた商品は顧客に表示されません。
ストアが外部コマースを使用している場合、お客様はソース商品URLから購入します。そのストアでは、OrderInChatのカートチェックアウトとWhatsAppのチェックアウトフローはオフになります。
在庫ロケーション
Shopifyのロケーションとバリアントごとの在庫レベルは、OrderInChatの倉庫/ロケーションレコードにミラーリングされます。商品およびバリアントの在庫は、チャットおよびチェックアウト向けにすべてのロケーションの合計を表示します。WooCommerceコアは1つの合計在庫値を公開するため、それはデフォルトの仮想ロケーションにミラーリングされます; WooCommerceプラグインによる複数ロケーションの在庫には、サポートされているプラグインが必要です。
カタログ → 在庫の下に、独自のOrderInChatロケーションを追加できます。バルクエディタの在庫セルはロケーションごとに拡張されます。Shopifyに在庫をプッシュすると、選択したロケーションのみが更新され、write_inventoryスコープが必要です。ロックされた在庫フィールドは、後の在庫同期によって上書きされることはありません。
配送ラベル
OrderInChatの配送ラベルはデフォルトでオフになっています。OrderInChatをラベルを作成する唯一の場所にしたい場合にのみ有効にしてください。有効にされていても、外部注文にすでに履行または追跡情報がある場合、OrderInChatはラベルを購入しません。
ウィジェットスニペット
Shopify: Webhookを登録すると、チャットウィジェットをShopifyストアに自動的にインストールしようとします。必要に応じて、カスタムLiquidにスニペットを貼り付けることもできます。自動インストールが失敗した場合は、カスタムアプリでwrite_script_tagsを付与してください。
WooCommerce: REST APIはテーマスクリプトを注入できません。統合ページからJavaScriptまたはPHPスニペットをテーマのフッターまたはfunctions.phpにコピーします。
ページ → ナレッジベース
ページと投稿が有効になっている場合、Shopifyのページ/記事/ポリシーおよびWooCommerceのページ/投稿がOrderInChatナレッジベースに追加（または更新）され、AIの回答に使用されます。一致するShopifyポリシータイトルは、返品/条件のストアフロントフィールドも埋めます。これは完全なテーマ/CMSクローンではありません。
API制限
この統合は、値を創造するのではなく、サポートされていないまたは利用できないデータを報告します。一般的な制限には以下が含まれます:
- ShopifyはAdmin APIを通じてすべての支払い設定を公開していません。
- キャリア計算された配送価格は外部チェックアウトで計算され続けます。
- WooCommerce RESTは、WordPressアプリケーションパスワードなしではWordPressページを含みません。
- レビューや予約には、それらのリソースを公開するプラットフォームまたはアプリAPIが必要です。
- 商品のアドオンは、ソースAPIに実際の同等物がある場合にのみミラーリングされます。
