トップページへ

連携：開発者向け技術リファレンス

reactive.chatを組み込むための完全な技術リファレンス。ブラウザー側のscriptタグ、JavaScript API、イベント、本人情報、SPA、CSPと、サーバー側の署名、顧客データ、Webhook、REST API、MCP、チャネル、独自ドメイン。

このリファレンスは、reactive.chatをWebサイト、アプリ、バックエンドに組み込む開発者向けです。コードに実装されているインターフェースと処理の流れを、名前、型、既定値、エラー事例とともに説明します。

外観、テキスト、ホーム画面、ルール、ツアー、A/Bテスト、AIペルソナの設定は、カスタマイズで説明しています。アカウントやオペレーター画面の使い方は、マニュアルをご覧ください。

全体像

Your visitors' browser                      reactive.chat                         your server
----------------------                      -------------                         -----------
loader.js  --(trigger)-->   core.<hash>.js  cdn.reactive.chat
   window.ReactiveChat (API, events)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   HTTP fallback (SSE/Poll) <----------->   ws.reactive.chat/rc_wss/h/
                                            chat server  --- POST (signed) ---->  customer data endpoint
                                                         --- POST (signed) ---->  webhook receiver
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  identity secret

クライアント側では、scriptタグを埋め込み、任意でwindow.ReactiveChatからウィジェットを制御します。サーバー側では、ログイン済みユーザーの本人情報に署名し、必要に応じて顧客データのリクエストに応答し、Webhookを受信し、REST APIを使用します。

各章

基本

構成と処理の流れ – 構成要素、連携の仕組み、バージョン、配信
クイックスタート – 埋め込み、ドメイン登録、CSP、確認

ブラウザー内

scriptタグのリファレンス – すべてのdata-rc-*属性と設定元
JavaScript API – ReactiveChat(…)の全コマンド
イベント – on/offとDOMイベント
訪問者の本人確認と状況情報の受け渡し – identify、userHash、exp、track
シングルページアプリとページ変更
セキュリティとContent Security Policy

接続と配信

独自ドメインとファーストパーティープロキシ – nginx、Apache、Caddy
通信：WebSocket、HTTPフォールバック、再接続 – プロトコル、エラーコード、切断コード

運営側のサーバー

顧客データエンドポイント – 注文の取得とインポート
Webhook – イベント、署名、再試行、REST hooks
サーバーAPI（REST v1）とMCP
連携とチャネル – WhatsApp、Messenger、Instagram、Telegram、SMS、メール

その他の組み込み先

モバイルアプリ – WebView内のチャット
Smart Answer – サイト内検索のAI回答

運用

用語

サイトキー – プロジェクトの公開キー（24文字）。スニペットに含まれ、秘密情報ではありません。
プロジェクト – 独自の設定を持つWebサイトやアプリ。複数のプロジェクトがワークスペースを構成します。
オペレーター画面 – チームが返信する画面。
確認済みユーザー – 運営側のサーバーがuserHashで本人情報に署名した訪問者。
ローダー／コア – 小さな読み込み用のloader.jsと、その後に読み込む主要部分のcore.<hash>.js。

ドキュメント全体の一覧：ドキュメント。

最終更新: 2026-10-25

連携：開発者向け技術リファレンス

全体像

各章

関連ページ

用語