Skip to main content

​
概要

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 ストアの開発者ポータルでカスタムアプリを作成・インストールする権限
ヒントセットアップを進める準備はできましたか。手順ガイドへ進んでください。

​
仕組み

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 は、付与されたデータスコープに基づく範囲でのみストアに関する質問に回答できます。
  • チャットボットが質問に回答できない場合、セットアップ時に関連するスコープが選択されていない可能性があります。
  • 銀行口座情報、パスワード、請求情報などの機微なデータは、要求されることも、アクセスされることもありません。

​
手順ガイド

Shopify コネクターの利用には4つの工程があります。
  1. Shopify でカスタムのコネクターアプリを作成する。
  2. カスタムのコネクターアプリをストアにインストールする。
  3. Clever AI にカスタムのコネクターアプリを追加する。
  4. Clever AI でストアデータへの問い合わせを始める。
各工程を以下で詳しく説明します。

​
工程 1 - Shopify でカスタムのコネクターアプリを作成する。

  1. https://admin.shopify.com から Shopify の管理ダッシュボードにログインします。
Shopify の管理ダッシュボード
  1. ダッシュボードの右上で、Clever AI に接続するストアの名前を選択します。アカウントで複数のストアを管理している場合、これは重要な手順です。
ストアの選択
  1. 左側のナビゲーションの下部で Settings をクリックし、Apps を選択します。Apps の一覧が開きます。Develop apps のボタンを選択すると、App development のパネルが開きます。
Develop apps の選択肢を開く
  1. Build apps in Dev Dashboard のボタンを選択します。Dev dashboard が開きます。
Create an app の選択肢を開く
  1. Create app を選択します。Create an app のパネルが開きます。アプリに分かりやすい名前を付けてください（例：「Clever AI Connector」）。
アプリに名前を付ける
  1. アプリが作成されると、Create version のパネルが開きます。ここでアプリに関する追加情報を入力できます。このガイドではスコープのみに焦点を当てます。
バージョンの作成
  1. Access > Scopes のセクションまでスクロールし、Select scopes を選択します。
スコープの選択
  1. 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 のリンクを選択してください。shopify-connector-request-access.png
  1. Release を選択します。ポップアップのウィンドウで、再度 Release を選択します。 これで Clever AI のコネクターアプリの準備が整いました。
  2. Settings のパネルへ移動し、Credentials のセクションでアプリの Client ID と Secret をコピーして保存します。この設定の工程 3 で使用します。
アプリの認証情報

​
工程 2 - カスタムのコネクターアプリをストアにインストールする。

  1. Dev dashboard から、新しいカスタムのコネクターアプリを選択します。
インストールするアプリの選択
  1. Installs のセクションまでスクロールし、Install app を選択します。コネクターをインストールするストアを選択するウィンドウが開きます。
shopify-connector-install-button.png
  1. ストアを選択します。
ストアの選択
  1. Install app のパネルで Install を選択します。
アプリのインストール
  1. インストールが完了すると、コネクターアプリが Shopify ダッシュボードの左側のナビゲーションメニューの Apps の下に表示されます。
選択したストアにインストールされたアプリ これで、カスタムのコネクターアプリを Clever AI に追加して利用できます。

​
工程 3 - Clever AI にカスタムのコネクターアプリを追加する。

Shopify でカスタムのコネクターアプリを設定したら、次の操作を行います。
  1. Hello Clever の加盟店アカウントにログインし、Clever AI のハブへ移動します。
  2. プロンプトの入力欄で + Data connectors を選択します。表示される選択肢から、Add new data connector の下の Shopify を選択します。
Shopify コネクターの追加
  1. セットアップのフォームに次の情報を入力します。
shopify-connector-connector-details.png
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 になります。
  1. Connect を選択します。これで新しいカスタムのコネクターアプリが Clever AI に接続されます。
Shopify ストアのコネクターが接続されたポップアップ通知 Clever AI がストアデータの同期を開始します。この処理には最大 24 時間かかります。

​
工程 4 - Clever AI でストアデータへの問い合わせを始める。

Shopify ストアが Clever AI に接続されると、ストアの情報について（許可されたスコープの範囲内で）具体的な質問ができるようになります。
  1. プロンプトの入力欄で + Data connectors を選択します。
  2. 表示されるメニューで、ストアの名前をオンに切り替えます。
Shopify が接続されオンになった状態
  1. 質問を始めてください。Clever AI が回答時にストアのデータを参照します。

​
用語集

​
トラブルシューティング

​
ストアドメインの重複エラー

Clever AI のシステムでは、各ストアドメインが一意の識別子として扱われます。ストアドメインの重複に関するエラーが表示された場合、そのストアはすでに登録されています。 解決方法：
  • 他のチームメンバーがすでにコネクターを設定していないか確認してください。
  • 再接続が必要な場合は、新しく追加する前に既存のコネクターの登録を削除してください。
  • Store Name ではなく Store Domain を入力していることを確認してください。この2つは別の項目です。

​
Store Domain と Store Name の違い

​
チャットボットが質問に回答できない

Clever AI が十分な情報がないと回答する場合、最も可能性が高い原因はデータスコープの不足です。
  • Shopify のアプリ設定に戻り、有効になっているスコープを確認してください。
  • 必要な読み取りスコープを追加し、アプリを再インストールして認証情報を更新してください。
  • 新たにスコープを付与したデータが利用できるようになるまで、最大 24 時間かかる場合があります。

​
24 時間経ってもデータが同期されない

24 時間経ってもストアデータが Clever AI に表示されない場合：
  • すべての認証情報が正しく入力されていることを確認してください（余分な空白や文字の欠落がないこと）。
  • Shopify でアプリが完全にインストールされているかを確認してください（工程 1 の手順 9）。
  • Hello Clever のサポートへお問い合わせください。

​
セキュリティとデータプライバシー

Hello Clever はデータセキュリティを重視しています。Clever AI が Shopify のデータを取り扱う際は、次の原則に従います。
  • Clever AI は読み取りアクセスのみを要求します。Shopify ストア内のデータに書き込み、変更、削除を行うことはありません。
  • アクセスは選択したスコープに厳密に限定されます。明示的に承認した範囲を超えて追加のデータが取得されることはありません。
  • API の認証情報は Hello Clever のプラットフォーム内に安全に保管され、第三者と共有されることはありません。
  • 銀行口座番号、パスワード、個人の本人確認情報などの機微な財務情報は対応スコープの対象外であり、アクセスされることはありません。
ストアと Hello Clever の間のデータ共有に関する取り決めについてのご質問は、加盟店契約をご確認いただくか、Hello Clever のビジネスチームへお問い合わせください。

​
サポートが必要な場合

このガイドで扱っていない問題が発生した場合は、Hello Clever のサポートチームへお問い合わせください。
  • 加盟店ダッシュボードから Hello Clever のサポートへ連絡してください。
  • お問い合わせの際は、Store Domain と接続名をお手元にご用意ください。
  • 緊急の問題については、表示されたエラーメッセージの内容を添えてください。

関連トピック

WooCommerce コネクターHello Clever を始めるShopify に Hello Clever を追加する