アプリと連携

アプリマーケットプレイスは 設定 → アプリ にあります。アプリはワークスペース全体に対して一度だけインストールされます: 管理者がワークスペース自身の認証情報でサービスを接続すると、受信トレイにアクセスできるすべてのチームメンバーが会話パネルでカードを見られるようになります。担当者が自分で何かをインストールすることはありません — そして AIエージェントも決して何もインストールしません。

現在 6 つのアプリが利用できます:

自社のバックオフィスへの単純なリンクをお探しですか? それにはアカウントもトークンも不要なので、アプリカタログではなく 設定 → 一般 → 自社システムへのリンク にあります。

設定 → アプリ を開き、タイルを選んで、アプリが求める認証情報を入力します。各フィールドは、その値が作成または確認できるベンダーのダッシュボードの正確なページにリンクしています。

すべてのアプリタイルには、インストールの状況を示すステータスチップが付いています:

アプリの認証情報はワークスペースに属し、いくつかのルールがそれを守ります:

• 保存時に暗号化。 シークレットフィールド（API キー、トークン）はストレージ内でキーごとに暗号化され、保存後に再表示されることはありません。
• ベンダーが許す限り最小権限で。 Stripe は Customers、Subscriptions、Charges、Invoices を読める制限付きキー — さらに、担当者が会話から返金すべき場合のみ Refunds の書き込みアクセス — で接続すべきです。フルアクセスのキーを貼り付けても動作はしますが、設定ページが差し替えを勧めます。
• 接続先の変更はシークレットを再要求。 認証情報がひも付くフィールド — Shopify のストアドメイン、Jira のサイト URL — を編集するにはトークンの再入力が必要です。保存済みの認証情報が、意図しなかったホストへ向け直されることは決してありません。
• 失効はワークスペース全体に影響。 アプリごとワークスペースごとにインストールは 1 つです: ベンダー側でキーをローテーションまたは失効させると、管理者が設定 → アプリで更新するまで、全チームメンバーのカードが停止します。

インストールされると、各アプリは受信トレイの会話詳細パネルにウィジェットとして表示されます。会話を開くとベンダーからライブのカードを取得します: この顧客が Stripe で誰なのか、最近の Shopify 注文、ニュースレターの購読状況、スレッドにリンクされた Jira 課題、あるいは訪問者に対する Tracio の判定です。ほとんどのカードはベンダー自身のダッシュボード内の対応レコードへのリンクも持ちます — Tracio の判定は完全にパネル内で完結します。

カードは表示するものがないことについて正直です。顧客が見つからない — または会話に使えるアイデンティティがない — 場合、カードは空のボックスを描画する代わりに、そのことと理由を説明します。応答は短時間キャッシュされ、アプリごとにレートが管理されるため、開いたままの受信トレイがベンダーの API 上限を食い潰すことはありません。

カードは検証済みアイデンティティに従う#

Stripe、Shopify、Mailchimp、MailerLite はメールアドレスで顧客を検索します — それも、実際に 検証された アドレスだけです: ウィジェットの署名付きアイデンティティ（本人確認）でカバーされたもの、またはメールチャネルの会話の From アドレスです。訪問者がチャットに入力しただけのアドレスは検索に一切使われません — そうでなければ、誰でも実在の顧客のメールアドレスを入力して支払い履歴を見られてしまいます。その場合、カードはアドレスが検証済みアイデンティティに裏付けられていないことを説明します。

Jira と Tracio はメールをキーにしません — Jira のカードは会話にリンクされた課題に、Tracio はウィジェット訪問者に属します — そのため、検証済みアドレスが存在しなくても機能します。

Stripe#

顧客の請求情報への読み取り専用の窓: 名前、メールアドレス、アカウント残高、コピー可能な顧客 ID、さらにサブスクリプション — ステータスバッジ、プラン、月額、開始日 — と請求書番号付きの最近の支払い。返金だけが唯一の任意の書き込み操作です: 管理者がアプリ設定で 会話パネルからの返金を許可 をオンにし（デフォルトはオフ）、オペレーターには 返金とキャンセルの実行 権限が必要で、すべての返金は REFUND と入力して確認しなければなりません — Stripe は一度送信された返金を取り消せません。

Shopify#

読み取り専用の最近の注文 — 注文番号、日付、合計、支払いと配送のステータス — と、各注文および Shopify 管理画面の顧客レコードへのリンク。ストアドメインと、 read_customers と read_orders スコープを持つカスタムアプリの Admin API トークンで接続します。

Mailchimp#

Mailchimp から見た購読者: ステータスバッジ、オーディエンス、タグ、エンゲージメント、最近のキャンペーンアクティビティ（送信、開封、クリック）。利用できるアクションは 1 つ: 購読解除 — 会話を離れずに "メールを止めてほしい" という要望に応えるためのものです。API 経由では取り消せません — Mailchimp では本人がサインアップフォームから再登録するしかありません — そのため入力による確認が必要です。なお、Mailchimp の API キーにはスコープがありません: 接続したキーはアカウント内のすべてを読み書きできます。

MailerLite#

購読ステータス、グループ、登録日、エンゲージメント、最近のキャンペーンアクティビティ。アクションは 2 つ: 購読解除（取り消し可能 — MailerLite の API は再購読に対応しています）と、本人の希望でリストに戻すための 再購読 です。

Jira#

会話と Jira Cloud 課題の双方向リンク。カードはこの会話にリンクされた課題を現在のステータス付きで一覧し、 課題を作成（選んだプロジェクトに起票され、自動的にリンクされます）と、既存の課題のための 既存をリンク / リンク解除 を提供します。Jira 側でのステータス変更は Webhook を通じて反映されます: アプリの設定ページに Jira サイトへ貼り付けるシークレットな Webhook アドレスが表示され、以後カードは課題のライブステータスをミラーします。課題は接続した Atlassian アカウントとして作成され、カードにはそのアカウントに見えるものがそのまま見えます。

Tracio はチャットウィジェット訪問者について 1 つの問いに答えます: これは人間か、ボットか? アプリをインストールすると、Respondo チャットウィジェット内で Tracio の検出 SDK が有効になります — 新しいウィジェット会話には自動的に判定が付き、会話パネルの Tracio カードにチップとして表示されます。

接続するキーは 2 つです: ウィジェット内で SDK を有効化する公開キーと、判定のサーバーサイドチェックに使うシークレットな Data API キー。サーバーサイドチェックなしでは、ブラウザの "ボットではない" という主張をそれ単体で信頼することはできません — そしてブラウザの主張がサーバーの判定と食い違う場合、カードは両方を表示します。

• Stripe と Shopify のカードは 読み取り専用 です — Stripe アプリ全体で唯一の書き込みは、明示的に有効化する任意の返金アクションです。
• メールをキーにするアプリ（Stripe、Shopify、Mailchimp、MailerLite）には検証済みメールアドレスが必要です。匿名のウィジェット訪問者や、アドレスのないチャネルからの会話には、正直な "検索するものがない" カードが表示されます。
• Jira の対応は Jira Cloud のみです。
• Mailchimp には再購読がありません: 一度購読解除すると、本人がサインアップフォームから再登録するしかありません。そのフローが重要なら MailerLite の再購読を使ってください。
• Tracio の判定は SDK が読み込まれたウィジェット会話にのみ存在します — メールやメッセンジャーのチャネルには決してありません。