> ## 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.
# Shopify コネクター
> このガイドでは、セットアップの全体的な流れを解説します。コネクターアプリの作成、Shopify での必要な認証情報の発行、Clever AI への入力、そしてデータの同期後のチャットボットの利用までを扱います。
## 概要
Shopify コネクターは、Shopify ストアを Hello Clever のプラットフォームに接続する Clever AI のデータ連携機能です。接続すると、Clever AI がストアのデータを読み取り、AI を活用したチャットボットを通じて、インテリジェントなインサイト、分析、事業に関する質問への回答を提供します。
このガイドでは、セットアップの全体的な流れを解説します。コネクターアプリの作成、Shopify での必要な認証情報の発行、Clever AI への入力、そしてデータの同期後のチャットボットの利用までを扱います。
**まず Shopify を接続する必要がありますか**
取引がすでに Hello Clever の決済ゲートウェイを経由している場合は、Shopify を接続せずにすぐ Clever AI を利用できます。
Shopify コネクターは追加の機能であり、決済取引のインサイトを超えて、ストア固有のデータ（注文、顧客、在庫）で Clever AI の回答を充実させたい場合に使用します。
## 事前準備
始める前に、次のものを用意してください。
* 管理者アクセス権のある稼働中の Shopify ストア
* Clever AI を利用できる Hello Clever の加盟店アカウント
* Shopify ストアの開発者ポータルでカスタムアプリを作成・インストールする権限
**ヒント**
セットアップを進める準備はできましたか。[**手順ガイド**](#step-by-step-guide)へ進んでください。
## 仕組み
Shopify コネクターは Shopify の安全な API の仕組みを使い、ストアデータの特定の領域に対する**読み取り専用**のアクセスを Clever AI に付与します。流れは次のとおりです。
* Shopify でカスタムアプリを作成し、Clever AI が読み取れるデータスコープを選択します。
* Shopify から API の認証情報をコピーし、Clever AI のコネクター設定に貼り付けます。
* Clever AI が 24 時間以内にストアデータを同期します。
* 同期が完了すると、ストアの成果、顧客、注文について Clever AI と対話できます。
**読み取り専用のアクセス**
Clever AI は Shopify のデータを読み取るだけです。ストア内に書き込んだり削除したりすることはありません。アクセスは、セットアップ時に明示的に選択したスコープに厳密に限定されます。
### データスコープ
Shopify コネクターのアプリを設定する際、特定のデータスコープへのアクセスの付与を求められます。Clever AI は現在9つのスコープに対応しており、いずれもストアの財務および運用に関するものです。次の表で各スコープを説明します。
| **スコープ** | **Clever AI がアクセスできる内容** |
| ------------------------------------ | -------------------------- |
| **read\_customers** | 顧客のプロフィール、連絡先情報、購入履歴 |
| **read\_orders, read\_all\_orders** | 注文の詳細、明細、合計、フルフィルメントのステータス |
| **read\_products** | 商品の掲載情報、バリエーション、価格、在庫水準 |
| **read\_shopify\_payments\_payout** | 倉庫をまたいだ在庫数量と保管場所 |
| **read\_shopify\_payments\_dispute** | チャージバックと決済の異議申立ての記録 |
| **read\_price\_rules** | 割引とプロモーション価格の設定 |
| **read\_returns** | 返品のリクエストとその現在のステータス |
| **read\_payment\_terms** | 支払期日と B2B の請求条件 |
**スコープの制約**
* Clever AI は、付与されたデータスコープに基づく範囲でのみストアに関する質問に回答できます。
* チャットボットが質問に回答できない場合、セットアップ時に関連するスコープが選択されていない可能性があります。
* 銀行口座情報、パスワード、請求情報などの機微なデータは、要求されることも、アクセスされることもありません。
## 手順ガイド
Shopify コネクターの利用には4つの工程があります。
1. Shopify でカスタムのコネクターアプリを作成する。
2. カスタムのコネクターアプリをストアにインストールする。
3. Clever AI にカスタムのコネクターアプリを追加する。
4. Clever AI でストアデータへの問い合わせを始める。
各工程を以下で詳しく説明します。
### 工程 1 - Shopify でカスタムのコネクターアプリを作成する。
1. *[https://admin.shopify.com](https://admin.shopify.com)* から Shopify の管理ダッシュボードにログインします。
2. ダッシュボードの右上で、Clever AI に接続するストアの名前を選択します。**アカウントで複数のストアを管理している場合、これは重要な手順です。**
3. 左側のナビゲーションの下部で **Settings** をクリックし、**Apps** を選択します。**Apps** の一覧が開きます。**Develop apps** のボタンを選択すると、**App development** のパネルが開きます。
4. **Build apps in Dev Dashboard** のボタンを選択します。Dev dashboard が開きます。
5. **Create app** を選択します。Create an app のパネルが開きます。アプリに分かりやすい名前を付けてください（例：「Clever AI Connector」）。
6. アプリが作成されると、**Create version** のパネルが開きます。ここでアプリに関する追加情報を入力できます。このガイドではスコープのみに焦点を当てます。
7. **Access > Scopes** のセクションまでスクロールし、**Select scopes** を選択します。
8. API のアクセススコープの一覧をスクロールします。必要に応じた読み取り権限を選択してください。判断の参考には上記のデータスコープの表をご覧ください。`read_` のスコープのみを選択し、書き込み権限は付与しないでください。終わったら **Done** を選択します。
便宜のため、次のコードをコピーして **Scope** のテキスト欄に貼り付けられます。
`read_customers,read_orders,read_all_orders,read_products,read_shopify_payments_payouts,read_shopify_payments_disputes,read_price_rules,read_returns,read_payment_terms`
**スコープへのアクセスをリクエストする**
Shopify の定義済みスコープの一部は保護されており、アクセスをリクエストする必要があります。そのような場合は、**Access > Scopes** のセクションへ移動し、**Request access** のリンクを選択してください。
9. **Release** を選択します。ポップアップのウィンドウで、再度 **Release** を選択します。
これで Clever AI のコネクターアプリの準備が整いました。
10. **Settings** のパネルへ移動し、**Credentials** のセクションでアプリの **Client ID** と **Secret** をコピーして保存します。この設定の工程 3 で使用します。
### 工程 2 - カスタムのコネクターアプリをストアにインストールする。
1. **Dev dashboard** から、新しいカスタムのコネクターアプリを選択します。
2. **Installs** のセクションまでスクロールし、**Install app** を選択します。コネクターをインストールするストアを選択するウィンドウが開きます。
3. ストアを選択します。
4. **Install app** のパネルで **Install** を選択します。
5. インストールが完了すると、コネクターアプリが Shopify ダッシュボードの左側のナビゲーションメニューの **Apps** の下に表示されます。
これで、カスタムのコネクターアプリを Clever AI に追加して利用できます。
### 工程 3 - Clever AI にカスタムのコネクターアプリを追加する。
Shopify でカスタムのコネクターアプリを設定したら、次の操作を行います。
1. Hello Clever の加盟店アカウントにログインし、Clever AI のハブへ移動します。
2. プロンプトの入力欄で **+ Data connectors** を選択します。表示される選択肢から、**Add new data connector** の下の **Shopify** を選択します。
3. セットアップのフォームに次の情報を入力します。
| **項目** | **入力する内容** |
| ----------------- | ------------------------------------------------------------------------------------ |
| **Store name** | この接続を識別するための分かりやすいラベル（例：「My Shopify Store」）。 |
| **Store URL** | **Shopify** ストアの完全な URL（例：**mystore**.myshopify.com）。これはストアごとに固有であり、正確に一致させる必要があります。 |
| **Client ID** | [工程 1 の手順 10](#credentials) で保存した Client ID。 |
| **Client secret** | [工程 1 の手順 10](#credentials) で保存した Secret。 |
**Shopify ストアの URL の確認方法**
セットアップで使う正しい Shopify ストアの URL を確認する手順は次のとおりです。
1. ブラウザで Shopify の管理ダッシュボードの URL を確認します。`https://admin.shopify.com/store/YOUR-STORE` のような形式で、`YOUR-STORE` がストアの識別子です。
2. ストアの識別子に `.myshopify.com` を付けます（例：`YOUR-STORE.myshopify.com`）。これが Shopify ストアの URL になります。
4. **Connect** を選択します。これで新しいカスタムのコネクターアプリが Clever AI に接続されます。
Clever AI がストアデータの同期を開始します。この処理には最大 24 時間かかります。
### 工程 4 - Clever AI でストアデータへの問い合わせを始める。
Shopify ストアが Clever AI に接続されると、ストアの情報について（許可されたスコープの範囲内で）具体的な質問ができるようになります。
1. プロンプトの入力欄で **+ Data connectors** を選択します。
2. 表示されるメニューで、ストアの名前をオンに切り替えます。
3. 質問を始めてください。Clever AI が回答時にストアのデータを参照します。
## 用語集
| **用語** | **定義** |
| -------------------- | ------------------------------------------------------------------ |
| **Client ID** | Shopify が発行する安全な認証情報で、Clever AI が加盟店に代わってストアの API に対して認証できるようにします。 |
| **Secret** | 安全な API 通信に使うアクセストークンと対になる、2つ目の認証情報です。 |
| **Clever AI** | ストアデータを分析し、事業に関する問い合わせに回答する Hello Clever の AI 活用型チャットボットです。 |
| **データコネクター** | Shopify などの外部プラットフォームをデータソースとして Clever AI に接続する連携機能です。 |
| **データスコープ** | Clever AI が読み取りを許可されるデータの分類を正確に定める権限です。 |
| **Hello Clever Hub** | 加盟店が Clever AI やデータコネクターを含む Hello Clever の製品を管理する中心的なダッシュボードです。 |
| **読み取り専用アクセス** | ストアに変更を加えることなく、Clever AI がデータを閲覧・分析できるアクセスです。 |
| **Store URL** | Shopify ストアの固有のウェブアドレスで、通常は yourstore.myshopify.com の形式です。 |
| **Store Name** | Clever AI 内での接続に対してユーザーが付けるラベルです。Store URL とは異なります。 |
| **同期** | Clever AI がストアデータを取得してインデックス化し、チャットボットから問い合わせできるようにする処理です。 |
## トラブルシューティング
### **ストアドメインの重複エラー**
Clever AI のシステムでは、各ストアドメインが一意の識別子として扱われます。ストアドメインの重複に関するエラーが表示された場合、そのストアはすでに登録されています。
**解決方法：**
* 他のチームメンバーがすでにコネクターを設定していないか確認してください。
* 再接続が必要な場合は、新しく追加する前に既存のコネクターの登録を削除してください。
* Store Name ではなく Store Domain を入力していることを確認してください。この2つは別の項目です。
### **Store Domain と Store Name の違い**
| **Store Domain / URL** | **接続名 (Store Name)** |
| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Shopify ストアの実際の URL（例：mystore.myshopify.com）。一意である必要があり、Shopify が割り当てたものと正確に一致しなければなりません。 | Clever AI 内での自身の参照用に選ぶ分かりやすいラベル（例：「AU Store」や「Main Shopify」）。Shopify の URL と一致させる必要はありません。 |
### チャットボットが質問に回答できない
Clever AI が十分な情報がないと回答する場合、最も可能性が高い原因はデータスコープの不足です。
* Shopify のアプリ設定に戻り、有効になっているスコープを確認してください。
* 必要な読み取りスコープを追加し、アプリを再インストールして認証情報を更新してください。
* 新たにスコープを付与したデータが利用できるようになるまで、最大 24 時間かかる場合があります。
### 24 時間経ってもデータが同期されない
**24 時間経ってもストアデータが Clever AI に表示されない場合：**
* すべての認証情報が正しく入力されていることを確認してください（余分な空白や文字の欠落がないこと）。
* Shopify でアプリが完全にインストールされているかを確認してください（[工程 1 の手順 9](#fully-installed)）。
* Hello Clever のサポートへお問い合わせください。
## セキュリティとデータプライバシー
Hello Clever はデータセキュリティを重視しています。Clever AI が Shopify のデータを取り扱う際は、次の原則に従います。
* Clever AI は読み取りアクセスのみを要求します。Shopify ストア内のデータに書き込み、変更、削除を行うことはありません。
* アクセスは選択したスコープに厳密に限定されます。明示的に承認した範囲を超えて追加のデータが取得されることはありません。
* API の認証情報は Hello Clever のプラットフォーム内に安全に保管され、第三者と共有されることはありません。
* 銀行口座番号、パスワード、個人の本人確認情報などの機微な財務情報は対応スコープの対象外であり、アクセスされることはありません。
ストアと Hello Clever の間のデータ共有に関する取り決めについてのご質問は、加盟店契約をご確認いただくか、Hello Clever のビジネスチームへお問い合わせください。
## サポートが必要な場合
このガイドで扱っていない問題が発生した場合は、Hello Clever のサポートチームへ[お問い合わせ](https://share.hsforms.com/1pdw9TJWWQseZKsjutCPu-g4obho)ください。
* 加盟店ダッシュボードから [Hello Clever のサポートへ連絡](https://share.hsforms.com/1pdw9TJWWQseZKsjutCPu-g4obho)してください。
* お問い合わせの際は、Store Domain と接続名をお手元にご用意ください。
* 緊急の問題については、表示されたエラーメッセージの内容を添えてください。
## Related topics
- [WooCommerce コネクター](/ja/clever-ai/woocommerce-connector.md)
- [Hello Clever を始める](/ja/getting-started/overview.md)
- [Shopify に Hello Clever を追加する](/ja/integrations/shopify.md)