Magentoコネクタ
対応: Magento
Magento 2 または Adobe Commerce を FreeScout に接続し、会話に一致した顧客注文と購入コンテキストを表示します。小さな読み取り専用 Magento モジュールが Magento REST API 経由でサポートサマリーを公開し、FreeScout コネクタが会話サイドバーに表示します。ReplyRabbit は製品所有コンテキストを AI レイヤーにも渡すため、下書きが顧客が購入したものを参照できます。
概要をお探しですか?
概要
Magento コネクタは FreeScout 会話に注文サイドバーを追加します。会話に顧客のメールアドレスがある場合、コネクタは以下を呼び出します moo-support/summary Magentoストアのエンドポイントで注文を照合し、会話の横に表示します。
サイドバーには顧客パネル、完全な注文履歴、数量と価格を含む注文ごとの明細、財務合計、顧客生涯価値(CLV)、平均注文額(AOV)、およびReplyRabbit AIコンテキストに流れ込む製品所有権エンタイトルメントが表示され、より関連性の高い下書きが作成されます。
インストールするコンポーネントは2つあります:
- その ReplyRabbit Connectorモジュール Magento 2向け。2つの読み取り専用RESTエンドポイントを追加します(
/rest/V1/moo-support/summaryおよび/rest/V1/moo-support/purchased-products)を、以下という専用の管理者権限の背後で ReplyRabbit Connector API)。ストアフロントやチェックアウトは変更しません。 - その FreeScout Magentoコネクターモジュール)。Magento統合アクセストークンを使用してHTTPS経由でこれらのエンドポイントを呼び出し、注文サイドバーをレンダリングします。FreeScoutに独自のメールボックスごとの設定ページがあります。
注文サイドバーは単独で機能します。AI下書きに流れ込む製品所有権のエンタイトルメントがReplyRabbitを使用する部分です。
前提条件
始める前に、次を確認してください:
- 動作するFreeScoutインストール。
- HTTPS経由でアクセス可能なMagento 2.4以降のストア(Magento Open SourceまたはAdobe Commerce)。Magento CLIコマンドを実行するためのSSHアクセス付き。
- Integrationを作成するためのMagento管理者アクセス。
- AI下書きに製品所有権のコンテキストが必要な場合は、ReplyRabbitをインストールして有効化してください。
- Magento Connectorライセンス(1つのFreeScoutインストールにつき18 EURの買い切り)、またはそれを含む有効なReplyRabbit ProまたはTeamプラン。
ReplyRabbitがまだインストールされていない場合は、次から始めてください ReplyRabbitモジュールのインストール方法)、次に完了します ReplyRabbitのセットアップ方法.
Magentoモジュールをインストールする
Magentoモジュールをダウンロード
ログイン先 app.replyrabbit.app そしてMagentoコネクタカードからMagentoモジュールZIPをダウンロードします。app/codeに解凍します
ZIPをMagentoルートにアップロードして解凍します。次を作成しますapp/code/Moogento/SupportData.モジュールを有効化
Magentoルートから次を実行します:本番モードのストアでは、次も実行してくださいbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploy他のモジュールインストールと同様に。
Composerインストール
moogento/m2-supportdata Moogentoパッケージリポジトリから。上記のZIPインストールにはComposer認証情報は不要です。Magento 統合トークンを作成
connectorは、Magento Integrationのアクセストークンで認証します。モジュールの読み取り専用権限にスコープされたものを作成してください。
連携を開く
Magento管理画面で次に移動してください システム)、次に 拡張機能)、次に 統合)、およびクリックします 新しい統合を追加.名前を付けてAPIスコープを設定
「ReplyRabbit Connector」などの名前と管理者パスワードを入力します。 API タブで設定する リソースアクセス に カスタム そしてのみチェック ReplyRabbit Connector API (トップレベルの管理ツリーの下)。保存します。アクセストークンを有効化してコピー
クリック 有効化 新しい統合の横にある、次に 許可)。コピーします アクセストークン)。Magentoは統合の詳細にトークンを表示するため、後で戻ることができます。
読み取り専用アクセス
FreeScoutコネクタモジュールをインストールする
FreeScout Magento コネクタモジュールは Magento エンドポイントを呼び出し、会話に注文サイドバーを表示します。ReplyRabbit とは別の独自の設定を持つ独立したモジュールです。
コネクタモジュールをダウンロード
ログイン先 app.replyrabbit.app FreeScout コネクタモジュールの ZIP をダウンロードします。コネクタを購入したか、有効な ReplyRabbit Pro または Team プランを保有している場合、両方のダウンロードが表示されます。FreeScoutにアップロード
FreeScoutで次に移動してください モジュール)、アップロードボタンをクリックし、ZIPを選択してインストールします。モジュールを有効化
有効化する Magento統合 モジュール一覧からモジュール。
メールボックスごとに設定
モジュールがインストールされたら、コネクタ独自のメールボックスごとの設定ページでストアに接続します。
コネクタ設定を開く
FreeScoutでMagento注文データを表示するメールボックスを開き、メールボックス設定メニューを開いて次を選択してください ストアコネクター)。これはMagentoコネクタの設定ページであり、ReplyRabbit設定内のセクションではありません。MagentoベースURLを入力
MagentoストアのベースURLをHTTPSで貼り付けます。例:https://your-store.com)。末尾のスラッシュは不要です。アクセストークンを入力
次を貼り付けます アクセストークン Magento統合から。暗号化されて保存され、保存後はマスクされたプレビューのみが表示されます。ストアIDを設定(任意)
すべてのストアの注文をマッチングするには空白のままにします。サイドバーを1つのストアまたはストアビューに限定するには、MagentoストアIDを入力します。コネクタライセンスキーを追加
コネクタを購入した場合は、そのライセンスキーを入力してください。アクティブなReplyRabbit ProまたはTeamプランがインストールをカバーしている場合は、この手順をスキップしてください。保存してテスト
設定を保存します。顧客のメールがMagentoの注文と一致するFreeScoutの会話を開き、注文サイドバーが表示されることを確認します。
各FreeScoutメールボックスは独自のベースURL、アクセストークン、ストアIDを保存するため、異なるメールボックスを異なるMagentoストアやストアビューに接続できます。
コネクタが表示するもの
- 会話を担当する人向けの顧客パネル。
- 注文番号、日付、ステータス、合計を含む完全な注文履歴。
- 数量と価格を含む注文ごとの明細項目。
- 財務合計(小計、割引、送料、税、返金)。
- 顧客生涯価値(CLV)と平均注文額(AOV)。
- AI下書き用の製品所有権エンタイトルメント。
コネクタの入手方法
Magento Connector は有料モジュールです。2 つの方法で入手できます:
- Magento Connector を 1 つの FreeScout インストール用の買い切りライセンス 18 EUR で購入し、そのライセンスキーをコネクタ設定に貼り付けてください。
- コネクタが追加費用なしで含まれる、有効なReplyRabbit ProまたはTeamプランを使用してください。
ライセンスを購入するか、次からコネクタをダウンロードしてください ReplyRabbitダッシュボード)。アクセスします 料金ページ ReplyRabbitプランオプションについて。アクティブなReplyRabbit ProまたはTeamプランがインストールをカバーしている場合、コネクタは設定後すぐに動作し、別途ライセンスキーは不要です。
トラブルシューティング
| 症状 | 確認すべきこと |
|---|---|
| 注文サイドバーが表示されない | コネクター設定のベースURLとアクセストークンが正しく、メールボックスパネルが有効であることを確認してください。 |
| ストアからのHTTP 404 | ReplyRabbit Connector モジュールがインストールまたは有効化されていません。再実行してください bin/magento module:enable Moogento_SupportData および bin/magento setup:upgrade)、次にキャッシュをフラッシュします。 |
| ストアからのHTTP 401または403 | 連携が有効化されていないか、トークンが再生成されたか、連携に次が欠けています ReplyRabbit Connector API リソース。統合を再有効化し、現在のトークンを貼り付けてください。 |
| "Connection refused"またはタイムアウトエラー | FreeScoutサーバーがHTTPS経由でストアURLに到達できることを確認してください。ファイアウォール、IP許可リスト、メンテナンスモードがリクエストをブロックする可能性があります。 |
| ベース URL が拒否される | ストアはHTTPS経由で提供される必要があります。プレーンな http:// URLまたは到達不能なホストは拒否されます。 |
| 既知の顧客に対して注文が空である | FreeScoutの会話の顧客メールが、Magento注文のメールと一致し、ストアID(設定されている場合)が注文したストアと一致することを確認してください。 |
| 明細項目、財務、またはCLVが表示されない | コネクターのライセンスキーが保存されているか、アクティブなReplyRabbit ProまたはTeamプランがインストールをカバーしていることを確認してください。 |
| 製品所有権のコンテキストが下書きに表示されない | コネクターがライセンスされ、ReplyRabbitがインストールされ、コネクターが注文を返し、メールボックスでAIコンテキスト機能が有効であることを確認してください。 |
より広範な問題については、次を参照してください ReplyRabbitのトラブルシューティング.
プライバシーとデータの取り扱い
コネクタがMagentoにクエリを送ると、HTTPS経由で顧客のメールアドレスをお客様自身のMagentoストアに送信します。ストアから返された注文データがFreeScoutサイドバーに入力され、ReplyRabbitとともに下書き用のAIコンテキストを構築します。
連携トークンには読み取り専用の権限のみが必要です ReplyRabbit Connector API リソースです。そのためコネクタはストアへの書き込みを一切行いません。トークンは FreeScout 内で暗号化して保存され、送信リクエストは TLS を検証し、リダイレクトには従いません。
Magento注文データは、メールボックスに選択されたAIプロバイダーを通じてのみ、AIコンテキスト機能が使用する場合に限り第三者に送信されます。ポリシーで注文データを完全に独自のサーバーに保持する必要がある場合は、メールボックスにローカルAIプロバイダー(Ollamaなど)を使用してください。
次のステップ
- 完了 ReplyRabbitのセットアップ方法 メールボックスにまだプロバイダー、コンテキスト、またはスタイル設定が必要な場合。
- WooCommerce もお使いですか?こちらをご覧ください WooCommerceコネクタ ガイド。
FAQ
コネクタにMagentoモジュールは必要ですか?
はい。コネクタは、ReplyRabbit ConnectorモジュールがMagento 2 REST APIに追加するsupport-summaryエンドポイントを読み取ります。2つのダウンロード、MagentoモジュールとFreeScout Magentoコネクタモジュールは、どちらもReplyRabbitアカウントから入手できます。
どのMagentoバージョンがサポートされていますか?
Magento 2.4以降(Magento Open SourceおよびAdobe Commerceを含む)、PHP 8.0から8.4。Magento 1はサポートされていません。
Magentoコネクタの費用はいくらですか?
Magento Connector は、有効な ReplyRabbit Pro または Team プランに含まれています。それ以外の場合、1 つの FreeScout インストール用の一時ライセンスとして 18 EUR かかります。購入した場合は、そのライセンスキーをコネクタ設定に貼り付けてください。
アクセストークンにはどのような権限が必要ですか?
ReplyRabbit Connector API リソースのみで、読み取り専用です。コネクタはストアに書き込むことはないため、連携に他の管理者権限は必要ありません。
各FreeScoutメールボックスを異なるMagentoストアに接続できますか?
はい。各メールボックスはコネクタ設定に独自のベースURL、アクセストークン、およびオプションのストアIDを保存するため、異なるストアやストアビューを異なるメールボックスに接続できます。