Shopifyコネクター
対応: Shopify
Shopify を FreeScout に接続し、会話に一致した顧客注文と購入コンテキストを表示します。Shopify 管理画面で読み取り専用のカスタムアプリを作成し、そのアクセストークンを FreeScout に貼り付けるため、パートナーアカウントやアプリレビューは不要です。ReplyRabbit は製品所有コンテキストを AI レイヤーにも渡すため、下書きが顧客が購入したものを参照できます。
概要をお探しですか?
概要
Shopify コネクタは FreeScout 会話に注文サイドバーを追加します。会話に顧客のメールアドレスがある場合、コネクタはストアの Shopify GraphQL Admin API に一致する注文をクエリし、会話の横に表示します。
サイドバーには顧客パネル、完全な注文履歴、数量と価格を含む注文ごとの明細、財務合計、顧客生涯価値(CLV)、平均注文額(AOV)、およびReplyRabbit AIコンテキストに流れ込む製品所有権エンタイトルメントが表示され、より関連性の高い下書きが作成されます。
インストールするコンポーネントは1つです: FreeScout Shopifyコネクターモジュール)。カスタムアプリのAdmin APIアクセストークンを使用してHTTPS経由でShopify GraphQL Admin APIを読み取り、注文サイドバーをレンダリングします。FreeScoutに独自のメールボックスごとの設定ページがあります。
注文サイドバーは単独で機能します。AI下書きに流れ込む製品所有権のエンタイトルメントがReplyRabbitを使用する部分です。
前提条件
始める前に、次を確認してください:
- 動作するFreeScoutインストール。
- 次のプラットフォーム上のShopifyストア
your-store.myshopify.comドメイン(またはそれにマップするカスタムドメイン)で、アプリを開発するスタッフ権限を持ちます。 - AI下書きに製品所有権のコンテキストが必要な場合は、ReplyRabbitをインストールして有効化してください。
- Shopify Connectorライセンス(1つのFreeScoutインストールにつき18 EURの買い切り)、またはそれを含む有効なReplyRabbit ProまたはTeamプラン。
ReplyRabbitがまだインストールされていない場合は、次から始めてください ReplyRabbitモジュールのインストール方法)、次に完了します ReplyRabbitのセットアップ方法.
Shopify でカスタムアプリを作成
connectorは、独自のストア内にあるカスタムアプリのAdmin APIアクセストークンで認証します。
アプリを開発するを開く
Shopify管理画面で次に移動してください 設定)、次に アプリと販売チャネル)、次に アプリを開発)。プロンプトが表示されたら、カスタムアプリ開発を許可します。アプリを作成
クリック アプリを作成)、「ReplyRabbit Connector」という名前を付け、作成します。Admin APIスコープを設定
開く Admin APIスコープを設定 そしてチェックread_customers,read_orders)、およびread_products)。チェックを入れますread_all_orders60日より古い注文履歴が必要な場合も同様です。保存します。トークンをインストールしてコピー
クリック アプリをインストール)、次に トークンを一度だけ表示 そしてコピー 管理者APIアクセストークン (これは次で始まりますshpat_)。Shopifyはこれを一度しか表示しないため、安全な場所に保管してください。
読み取り専用アクセス
FreeScoutコネクタモジュールをインストールする
コネクタモジュールをダウンロード
FreeScoutコネクタモジュールのZIPを次からダウンロードしてください ReplyRabbitダッシュボード)。ダウンロードは、コネクタを購入したか、有効なReplyRabbit ProまたはTeamプランを保有している場合に表示されます。FreeScoutにアップロード
FreeScoutで次に移動してください モジュール)、アップロードボタンをクリックし、ZIPを選択してインストールします。モジュールを有効化
有効化する Shopify連携 モジュール一覧からモジュール。
メールボックスごとに設定
コネクタ設定を開く
FreeScoutでShopify注文データを表示するメールボックスを開き、メールボックス設定メニューを開いて次を選択してください ストアコネクター)。これはShopifyコネクタの設定ページであり、ReplyRabbit設定内のセクションではありません。ストアドメインとアクセストークンを入力
ストアドメインを入力します。例:your-store.myshopify.com)、Admin APIアクセストークンを貼り付けます。保存します。コネクタは保存前にトークンとスコープをストアに対して確認します。トークンは暗号化して保存され、二度と表示されません。コネクタライセンスキーを追加
コネクタを購入した場合は、次を設定してくださいSHOPIFYINTEGRATION_LICENSE_KEYFreeScoutで.envそのライセンスキーに。有効な ReplyRabbit Pro または Team プランがインストールをカバーしている場合は、このステップをスキップしてください。テスト
顧客のメールが Shopify 注文と一致する FreeScout の会話を開き、注文サイドバーが表示されることを確認します。
各FreeScoutメールボックスは独自のストアドメインとアクセストークンを保存するため、異なるメールボックスを異なるストアに接続できます。
コネクタが表示するもの
- 会話を担当する人向けの顧客パネル。
- 注文番号、日付、ステータス、合計を含む完全な注文履歴。
- 数量と価格を含む注文ごとの明細項目。
- 財務合計(小計、割引、送料、税、返金)。
- 顧客生涯価値(CLV)と平均注文額(AOV)。
- AI下書き用の製品所有権エンタイトルメント。
コネクタの入手方法
Shopify Connector は有料モジュールです。2 つの方法で入手できます:
- Shopify Connector を 1 つの FreeScout インストール用の買い切りライセンス 18 EUR で購入し、そのライセンスキーを次として設定してください
SHOPIFYINTEGRATION_LICENSE_KEYFreeScoutで.env. - コネクタが追加費用なしで含まれる、有効なReplyRabbit ProまたはTeamプランを使用してください。
ライセンスを購入するか、次からコネクタをダウンロードしてください ReplyRabbitダッシュボード)。アクセスします 料金ページ ReplyRabbitプランオプションについて。アクティブなReplyRabbit ProまたはTeamプランがインストールをカバーしている場合、コネクタは設定後すぐに動作し、別途ライセンスキーは不要です。
トラブルシューティング
| 症状 | 確認すべきこと |
|---|---|
| 保存時の"Shopify rejected the connection" | トークンの入力ミス、取り消し、または別のストアに属しています。カスタムアプリを再インストールして新しいトークンを表示し、再度貼り付けてください。 |
| 保存時の"Missing these Admin API scopes" | カスタムアプリを開き、次の中で不足しているスコープを追加します Admin APIスコープを設定)、保存し、アプリを再インストールします。再インストールすると新しいトークンが発行されます。 |
| ストアドメインが拒否されました | 使用する your-store.myshopify.com ドメイン、またはそれにマップするカスタムドメイン。プライベートホストとIPアドレスは拒否されます。 |
| 注文サイドバーが表示されない | メールボックスパネルが有効で、設定ページで接続が接続済みとして表示されていることを確認してください。 |
| 既知の顧客に対して注文が空である | FreeScoutの会話の顧客メールが、Shopify注文のメールと一致することを確認してください。 |
| 直近 60 日間の注文のみが表示されます | 追加する read_all_orders カスタムアプリにスコープを設定し、再インストールして、新しいトークンを貼り付けます。 |
| 明細項目、財務、またはCLVが表示されない | コネクターのライセンスキーが保存されているか、アクティブなReplyRabbit ProまたはTeamプランがインストールをカバーしていることを確認してください。 |
| 製品所有権のコンテキストが下書きに表示されない | コネクターがライセンスされ、ReplyRabbitがインストールされ、コネクターが注文を返し、メールボックスでAIコンテキスト機能が有効であることを確認してください。 |
より広範な問題については、次を参照してください ReplyRabbitのトラブルシューティング.
プライバシーとデータの取り扱い
コネクタがShopifyにクエリを送ると、カスタムアプリのトークンを使用してHTTPS経由で顧客のメールアドレスをShopify GraphQL Admin APIに送信します。ストアから返された注文データがFreeScoutサイドバーに入力され、ReplyRabbitとともに下書き用のAIコンテキストを構築します。
カスタムアプリには読み取りスコープのみがあるため、connectorがストアに書き込むことはありません。アクセストークンはFreeScoutに暗号化して保存され、送信リクエストはTLSを検証し、リダイレクトに従いません。
Shopify注文データは、メールボックスに選択されたAIプロバイダーを通じてのみ、AIコンテキスト機能が使用する場合に限り第三者に送信されます。ポリシーで注文データを完全に独自のサーバーに保持する必要がある場合は、メールボックスにローカルAIプロバイダー(Ollamaなど)を使用してください。
次のステップ
- 完了 ReplyRabbitのセットアップ方法 メールボックスにまだプロバイダー、コンテキスト、またはスタイル設定が必要な場合。
- WooCommerce または Magento もお使いですか?こちらをご覧ください WooCommerceコネクタ および Magentoコネクタ ガイド。
FAQ
Shopifyコネクタはどのようにストアに接続しますか?
Shopify管理画面で作成するカスタムアプリ(設定、アプリと販売チャネル、アプリを開発)を使用します。read_customers、read_orders、read_productsスコープを付与し、インストールして、Admin APIアクセストークンをストアドメインとともにFreeScoutコネクタ設定に貼り付けます。コネクタは保存前にストアに対してトークンを検証します。
ShopifyパートナーアカウントやApp Storeの掲載は必要ですか?
いいえ。カスタムアプリはご自身のストア管理画面内で作成され、パートナーアカウントもアプリレビューも公開リスティングも必要ありません。
Shopifyコネクタの費用はいくらですか?
Shopify Connector は、有効な ReplyRabbit Pro または Team プランに含まれています。それ以外の場合、1 つの FreeScout インストール用の一時ライセンスとして 18 EUR かかります。購入した場合は、そのライセンスキーを FreeScout .env の SHOPIFYINTEGRATION_LICENSE_KEY として設定してください。
過去60日間の注文しか表示されないのはなぜですか?
Shopifyは、アプリにread_all_ordersスコープがない限り、注文履歴を60日間に制限します。カスタムアプリの設定時にread_all_ordersをチェックすると、全履歴を表示できます。
各FreeScoutメールボックスを異なるShopifyストアに接続できますか?
はい。各メールボックスはコネクタ設定に独自のストアドメインとアクセストークンを保存するため、異なるストアを異なるメールボックスに接続できます。