> ## Documentation Index > Fetch the complete documentation index at: https://docs.rc.cleverhub.co/llms.txt > Use this file to discover all available pages before exploring further. # WooCommerce コネクター > このガイドでは、セットアップの全体的な流れを解説します。WooCommerce での REST API 認証情報の作成、Clever AI への入力、そしてデータの同期後のチャットボットの利用までを扱います。 ## 概要 WooCommerce コネクターは、WooCommerce ストアを Hello Clever のプラットフォームに接続する Clever AI のデータ連携機能です。接続すると、Clever AI がストアのデータを読み取り、AI を活用したチャットボットを通じて、インテリジェントなインサイト、分析、事業に関する質問への回答を提供します。 このガイドでは、セットアップの全体的な流れを解説します。WooCommerce での REST API 認証情報の作成、Clever AI への入力、そしてデータの同期後のチャットボットの利用までを扱います。 **まず WooCommerce を接続する必要がありますか** 取引がすでに Hello Clever の決済ゲートウェイを経由している場合は、WooCommerce を接続せずにすぐ Clever AI を利用できます。 WooCommerce コネクターは追加の機能であり、決済取引のインサイトを超えて、ストア固有のデータ（注文、顧客、商品）で Clever AI の回答を充実させたい場合に使用します。 ## 事前準備 始める前に、次のものを用意してください。 * 管理者アクセス権のある稼働中の WooCommerce ストア * Clever AI を利用できる Hello Clever の加盟店アカウント * WooCommerce ストアの設定で REST APIキーを作成する権限 **ヒント** セットアップを進める準備はできましたか。[**手順ガイド**](#step-by-step-guide)へ進んでください。 ## 仕組み WooCommerce コネクターは WooCommerce の安全な REST API を使い、ストアデータに対する**読み取り専用**のアクセスを Clever AI に付与します。流れは次のとおりです。 仕組み * WooCommerce ストアの設定で、読み取り専用の REST APIキーを作成します。 * WooCommerce から Consumer key と Consumer secret をコピーし、Clever AI のコネクター設定に貼り付けます。 * Clever AI が 24 時間以内にストアデータを同期します。 * 同期が完了すると、ストアの成果、顧客、注文について Clever AI と対話できます。 **読み取り専用のアクセス** Clever AI は WooCommerce のデータを読み取るだけです。ストア内に書き込んだり削除したりすることはありません。REST APIキーを作成する際に権限を **Read** に設定するため、アクセスはデータの閲覧のみに厳密に限定されます。 ### データスコープ Shopify とは異なり、WooCommerce では個々のデータスコープを選択する必要がありません。1つの読み取り専用の REST APIキーがストアデータへのアクセスを付与し、Clever AI は Hello Clever 側で定義された9つのカテゴリーを通じてそれを読み取ります。次の表で各カテゴリーを説明します。 | **カテゴリー** | **Clever AI がアクセスできる内容** | | ------------- | -------------------------- | | **Customers** | 顧客のプロフィール、連絡先情報、購入履歴 | | **Orders** | 注文の詳細、明細、合計、フルフィルメントのステータス | | **Products** | 商品の掲載情報、バリエーション、価格、在庫水準 | | **Coupons** | 割引とプロモーション価格の設定 | | **Refunds** | 返金のリクエストとその現在のステータス | | **Payments** | 注文に紐づく決済の記録 | | **Payouts** | Payout の記録と精算の詳細 | | **Disputes** | チャージバックと決済の異議申立ての記録 | | **Reports** | 売上と成果の集計概要 | **スコープの制約** * Clever AI は、これらのカテゴリーを通じて利用できるデータのみに基づいてストアに関する質問に回答します。 * これらのカテゴリーは Hello Clever のシステム内で定義されており、WooCommerce のセットアップ時に選択するものではありません。WooCommerce 側から追加や削除はできません。 * 銀行口座情報、パスワード、請求情報などの機微なデータは、要求されることも、アクセスされることもありません。 ## 手順ガイド WooCommerce コネクターの利用には3つの工程があります。 1. WooCommerce で読み取り専用の REST APIキーを作成する。 2. Clever AI に認証情報を追加する。 3. Clever AI でストアデータへの問い合わせを始める。 各工程を以下で詳しく説明します。 ### 工程 1 - WooCommerce で読み取り専用の REST APIキーを作成する。 1. WooCommerce ストアの管理ダッシュボードを開きます。ストアの URL の末尾に `/wp-admin` を追加します（例：`https://mystore.com/wp-admin`）。 WooCommerce ストアの管理ダッシュボード 2. 左側のナビゲーションで **WooCommerce** を選択し、続いて **Settings** を選択します。 WooCommerce の設定を開く 3. **Advanced** のタブを選択し、続いて **REST API** を選択します。 REST API の選択肢を開く 4. **Add key** を選択します。**Key details** のフォームが開きます。 キーの追加 5. **Key details** のフォームに入力します。 | **項目** | **入力する内容** | | --------------- | ----------------------------------------------- | | **Description** | このキーを識別するラベル（例：「Clever AI Connector」）。 | | **User** | キーが属する管理者ユーザーを選択します。 | | **Permissions** | **Read** を選択します。Write や Read/Write は選択しないでください。 | キーの詳細 **読み取り専用の権限** WooCommerce では、キー自体の **Permissions** の項目でアクセス範囲を設定します。Shopify のように個々のスコープを選択することはありません。Clever AI が変更を加えずにデータを閲覧できるよう、**Read** を選択してください。 6. **Generate API key** を選択します。WooCommerce が **Consumer key** と **Consumer secret** を表示します。 発行された認証情報 7. **Consumer key** と **Consumer secret** をコピーして保存します。工程 2 で使用します。 **認証情報は今すぐ保存してください** WooCommerce は Consumer key と Consumer secret を一度だけ表示します。このページを離れる前にコピーして保存してください。失った場合は、新しいキーを発行する必要があります。 ### 工程 2 - Clever AI に認証情報を追加する。 1. Hello Clever の加盟店アカウントにログインし、Clever AI のハブへ移動します。 2. プロンプトの入力欄で **+ Data connectors** を選択します。表示される選択肢から、**Add new data connector** の下の **WooCommerce** を選択します。 WooCommerce コネクターの追加 3. セットアップのフォームに次の情報を入力します。 | **項目** | **入力する内容** | | ------------------- | -------------------------------------------------------------------------------- | | **Store name** | この接続を識別するための分かりやすいラベル（例：「My WooCommerce Store」）。 | | **Store URL** | WooCommerce ストアの完全な URL（例：`https://mystore.com`）。これはストアごとに固有であり、正確に一致させる必要があります。 | | **Consumer key** | [工程 1 の手順 7](#credentials) で保存した Consumer key。 | | **Consumer secret** | [工程 1 の手順 7](#credentials) で保存した Consumer secret。 | コネクターの詳細 4. **Connect** を選択します。これでコネクターが Clever AI に接続されます。 WooCommerce ストアが接続された通知 Clever AI がストアデータの同期を開始します。この処理には最大 24 時間かかります。 ### 工程 3 - Clever AI でストアデータへの問い合わせを始める。 WooCommerce ストアが Clever AI に接続されると、ストアの情報について具体的な質問ができるようになります。 1. プロンプトの入力欄で **+ Data connectors** を選択します。 2. 表示されるメニューで、ストアの名前をオンに切り替えます。 WooCommerce が接続されオンになった状態 3. 質問を始めてください。Clever AI が回答時にストアのデータを参照します。 ## 用語集 | **用語** | **定義** | | -------------------- | --------------------------------------------------------------------------- | | **Consumer key** | WooCommerce が発行する安全な認証情報で、Clever AI が加盟店に代わってストアの REST API に対して認証できるようにします。 | | **Consumer secret** | 安全な API 通信に使う、Consumer key と対になる2つ目の認証情報です。 | | **Clever AI** | ストアデータを分析し、事業に関する問い合わせに回答する Hello Clever の AI 活用型チャットボットです。 | | **データコネクター** | WooCommerce などの外部プラットフォームをデータソースとして Clever AI に接続する連携機能です。 | | **Hello Clever Hub** | 加盟店が Clever AI やデータコネクターを含む Hello Clever の製品を管理する中心的なダッシュボードです。 | | **読み取り専用アクセス** | ストアに変更を加えることなく、Clever AI がデータを閲覧・分析できるアクセスです。 | | **REST API** | Clever AI がストアデータを安全に読み取るための WooCommerce のインターフェースです。 | | **REST APIキー** | アクセスを付与するために WooCommerce で発行する認証情報の組（Consumer key と Consumer secret）です。 | | **Store URL** | WooCommerce ストアの固有のウェブアドレスです（例：`https://mystore.com`）。 | | **Store name** | Clever AI 内での接続に対してユーザーが付けるラベルです。Store URL とは異なります。 | | **同期** | Clever AI がストアデータを取得してインデックス化し、チャットボットから問い合わせできるようにする処理です。 | ## トラブルシューティング ### **ストアドメインの重複エラー** Clever AI のシステムでは、各ストアドメインが一意の識別子として扱われます。ストアドメインの重複に関するエラーが表示された場合、そのストアはすでに登録されています。 **解決方法：** * 他のチームメンバーがすでにコネクターを設定していないか確認してください。 * 再接続が必要な場合は、新しく追加する前に既存のコネクターの登録を削除してください。 * Store Name ではなく Store URL を入力していることを確認してください。この2つは別の項目です。 ### **Store URL と Store Name の違い** | **Store URL** | **接続名 (Store Name)** | | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | WooCommerce ストアの実際の URL（例：`https://mystore.com`）。一意である必要があり、ストアと正確に一致しなければなりません。 | Clever AI 内での自身の参照用に選ぶ分かりやすいラベル（例：「AU Store」や「Main WooCommerce」）。Store URL と一致させる必要はありません。 | ### チャットボットが質問に回答できない Clever AI が十分な情報がないと回答する場合、最も可能性が高い原因は質問しているデータのカテゴリーです。 * Clever AI が回答できるのは、上記の[データスコープ](#scopes)の表に記載された9つのデータカテゴリーの範囲内のみです。 * 質問がこれらのカテゴリーの範囲外である場合、チャットボットは回答できません。 * 利用できるすべてのデータが同期されるよう、REST APIキーの権限が **Read** に設定されていることを確認してください。 ### 24 時間経ってもデータが同期されない **24 時間経ってもストアデータが Clever AI に表示されない場合：** * すべての認証情報が正しく入力されていることを確認してください（余分な空白や文字の欠落がないこと）。 * REST APIキーの権限が **Read** に設定されており、キーが WooCommerce で有効なままであることを確認してください。 * Store URL が表示どおり正確に入力されているかを確認してください。 * Hello Clever のサポートへお問い合わせください。 ## セキュリティとデータプライバシー Hello Clever はデータセキュリティを重視しています。Clever AI が WooCommerce のデータを取り扱う際は、次の原則に従います。 * Clever AI は読み取りアクセスのみを要求します。WooCommerce ストア内のデータに書き込み、変更、削除を行うことはありません。 * アクセスは Clever AI が対応するデータカテゴリーに限定されます。これを超えて追加のデータが取得されることはありません。 * API の認証情報は Hello Clever のプラットフォーム内に安全に保管され、第三者と共有されることはありません。 * 銀行口座番号、パスワード、個人の本人確認情報などの機微な財務情報は対応カテゴリーの対象外であり、アクセスされることはありません。 ストアと Hello Clever の間のデータ共有に関する取り決めについてのご質問は、加盟店契約をご確認いただくか、Hello Clever のビジネスチームへお問い合わせください。 ## サポートが必要な場合 このガイドで扱っていない問題が発生した場合は、Hello Clever のサポートチームへ[お問い合わせ](https://share.hsforms.com/1pdw9TJWWQseZKsjutCPu-g4obho)ください。 * 加盟店ダッシュボードから [Hello Clever のサポートへ連絡](https://share.hsforms.com/1pdw9TJWWQseZKsjutCPu-g4obho)してください。 * お問い合わせの際は、Store URL と接続名をお手元にご用意ください。 * 緊急の問題については、表示されたエラーメッセージの内容を添えてください。 ## Related topics - [Shopify コネクター](/ja/clever-ai/shopify-connector.md) - [Hello Clever を始める](/ja/getting-started/overview.md) - [WooCommerce に Hello Clever を追加する](/ja/integrations/woocommerce.md)