メインコンテンツまでスキップ

Web チャットウィジェット

Web Chat チャネルは、Web サイトにチャットウィンドウを設置します。訪問者はページの隅にあるチャットボタンをクリックしてメッセージを送ります。会話は他のチャネルと同じように MonoChat の受信トレイに届き、チーム、フロー、AI エージェントが返信します。

チャネルを接続する​

  1. 設定 › チャット › チャネル を開き、接続 をクリックします。
  2. Web Chat を選択します。
  3. 以下の設定を入力して保存します。各フィールドには用途が説明されており、フォームの右側には、編集に合わせて変わるウィンドウのプレビューが表示されます。プレビューは、閉じたチャットボタン、開いたウィンドウ、会話のサンプルの間で切り替えられます。
  4. チャネルに表示されるスニペットをコピーし、Web サイトに追加します(スニペットを設置するを参照)。

Web Chat チャネルは複数接続できます。たとえば Web サイトごとに 1 つずつ接続できます。

設定​

設定内容
チャネル名MonoChat でのチャネルの名前です。ウィジェットのタイトル が空欄のとき、ウィンドウの見出しとして表示されます。
ウィジェットのタイトルチャットウィンドウの見出しです。
サブタイトルタイトルの下に表示される 1 行です(例:普段どのくらいで返信するか)。空欄にすると、この行は表示されません。
ロゴタイトルの横に表示される画像です(PNG、JPEG、GIF、SVG、WebP ファイル)。
カラーチャットボタン、ヘッダー、訪問者のメッセージの色です。その上の文字は、読みやすいように黒か白で表示されます。
位置ページの右下または左下です。
添付ファイル訪問者が 10 MB までの画像、動画、音声、ドキュメントを送れるようにします。
絵文字ボタンメッセージ欄の横に、よく使う絵文字を選べるボタンを表示します。初期設定でオンです。
ランチャーを非表示チャットボタンを非表示にします。JavaScript API を使って独自のボタンからウィンドウを開きます。
モバイル表示スマートフォンでのウィンドウの開き方です。全画面、またはページ下部の 4 分の 3 を覆うシート状の コンパクト です。
許可するドメインウィンドウを表示できるサイトです。正確なホスト(www.example.com)またはすべてのサブドメイン(*.example.com)を、任意のポート付き(localhost:3000)で指定します。空欄の場合はどのサイトでも表示できます。

言語​

ウィンドウのボタンやラベルは訪問者のブラウザの言語に従い、MonoChat がその言語に対応していない場合は英語で表示されます。

ウィジェットのタイトル、サブタイトル、フォームの説明、同意文 には、ワークスペースの言語ごとにバージョンがあります。言語は 設定 › CRM › 言語 で設定します(言語設定を参照)。フィールドをクリックして各バージョンを入力します。ウィンドウには訪問者のブラウザの言語のバージョンが表示され、その言語のバージョンがない場合はデフォルト言語のバージョンが表示されます。

ブラウザに関係なくウィンドウを 1 つの言語で表示するには、JavaScript API で MonoChat('setLocale', 'tr-TR') を呼び出します。

チャット前フォーム​

フォームがオフのとき、訪問者はすぐにメッセージを書き始められます。メールアドレスや電話番号を尋ねるにはフローを使います(フローとウィジェットを参照)。

フォームがオンのとき、ウィンドウは最初のメッセージの前に次の項目を尋ねます。

項目オプション
名前オフ、任意、必須
メールオフ、任意、必須
電話番号オフ、任意、必須

項目の上に表示するテキストを書いたり、独自のテキストとプライバシーポリシーへのリンクを付けた同意チェックボックスを追加したりすることもできます。チェックボックスをオンにすると、訪問者はチェックを入れないとチャットを始められません。名前、メールアドレス、電話番号は顧客のプロフィールに保存されます。

スニペットを設置する​

チャネルを接続した直後と、チャネルを編集するときのプレビューの下に、ウィジェットのアドレスとチャネルキーが入力済みのスニペットが表示されます。チャットを表示したいすべてのページで、閉じタグ </body> の前に貼り付けてください。

<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>

ウィンドウはページの後に読み込まれるため、ページの表示を遅くしません。

旧 WebChat からの移行

サイトに古い WebChat チャネルのスニペットが残っている場合は削除し、その場所に新しい Web Chat チャネルのスニペットを貼り付けてください。

全ページモード​

サポートページなど、チャット専用のページを作るには、スニペットの 2 つ目のタグに &mode=fullpage を追加します。

<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>

ウィンドウはページ全体に広がって常に開いたままになり、ヘッダーとチャットボタンは表示されず、close と toggle は何もしません。ページの後ではなくページと同時に読み込まれ、モバイル表示 の設定は適用されません。

Google Tag Manager​

  1. コンテナに Custom HTML タグを追加し、スニペットをそのまま貼り付けます。
  2. All Pages トリガー、またはチャットを表示するページでだけ発火するトリガーを選びます。
  3. Submit、続いて Publish をクリックします。

ページ独自のスクリプトが MonoChat を呼び出す場合、タグより先に実行されることがあります。スニペットの最初の <script> もページに残しておくと、その呼び出しはウィンドウの準備ができるまで待ちます。

ウェブサイトビルダーとオンラインストア​

サイトのコードを編集できない場合は、プラットフォームが全ページ用のコードとして用意している欄(ページ末尾またはフッター)に、スニペットをそのまま貼り付けてください。

プラットフォームスニペットの貼り付け先
WordPressWPCode プラグインをインストールし、その Footer 欄にスニペットを貼り付けます。WordPress.com でコードを追加できるかどうかはプランによります。
ShopifyOnline Store › Edit code:theme.liquid を開き、</body> の直前にスニペットを貼り付けます。
WixSettings › Custom Code › Add Custom Code:すべてのページと Body – end を選びます。サイトが公開済みで、ドメインが接続されている必要があります。
SquarespaceCode Injection の Footer 欄。Core、Plus、Advanced プランで利用できます。
WebflowSite settings › Custom code › Footer code に貼り付け、サイトを公開します。
ikasSales Channel › Extensions › Scripts › Add Script:スニペットをスクリプトの内容として貼り付けて保存し、スクリプトがオンになっていることを確認します。

JavaScript API​

スニペットはページに MonoChat 関数を定義します。独自のスクリプト、リンク、ボタンからこの関数を呼び出して、ウィンドウを操作します。ウィンドウの読み込み前に行った呼び出しは準備ができるまで待機するため、スニペットの直後に呼び出せます。

コマンド​

呼び出し内容
MonoChat('open')ウィンドウを開きます。
MonoChat('close')ウィンドウを閉じます。
MonoChat('toggle')閉じていれば開き、開いていれば閉じます。
MonoChat('hideLauncher')チャットボタンを非表示にします。ウィンドウは引き続き open と toggle で開けます。
MonoChat('showLauncher')チャットボタンを再び表示します。
MonoChat('setUser', { name, email, phone })訪問者について既にわかっている情報を渡します。ログイン中の訪問者を参照してください。
MonoChat('setLocale', 'tr-TR')ブラウザの言語にかかわらず、ウィンドウをこの言語で表示します。言語を参照してください。
MonoChat('on', event, callback)event が発生するたびに callback を呼び出します。イベントを参照してください。

イベント​

イベントタイミングcallback が受け取る値
readyウィンドウの読み込みが完了したとき。なし
openチャットボタンまたは呼び出しによってウィンドウが開いたとき。なし
closeウィンドウが閉じたとき。なし
unread未読の返信数が変わったとき。ウィンドウが閉じている間に返信が届いた場合や、訪問者がウィンドウを開いた場合です。未読の返信数

ready を見逃さないよう、コールバックはスニペットの直後に登録してください。

ログイン中の訪問者​

訪問者がサイトにログインしている場合は、setUser でその情報を渡します。どの項目も省略可能で、ウィンドウが読み取るのは name、email、phone だけです。

  • チャット前フォームにこの情報が入力されます。フォームが尋ねる項目がすべてそろっていればスキップされますが、同意チェックボックスがオンの場合はスキップされません。チェックは必ず訪問者自身が入れます。
  • 情報は MonoChat の顧客プロフィールに保存されるため、チームは誰がメッセージを送っているかを確認できます。
  • メールアドレスまたは電話番号が有効でない場合、どの情報も保存されません。

例​

独自のボタンからウィンドウを開き、チャットボタンを非表示にします。

<button onclick="MonoChat('open')">チャットで相談</button>
<script>
MonoChat('hideLauncher')
</script>

ログイン中のユーザーの情報を渡し、ページの言語でウィンドウを表示します。

<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>

未読の返信数を独自のボタンに表示します。

<button onclick="MonoChat('open')">サポート <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>

訪問者がウィンドウを開いたときに、アナリティクスにイベントを送信します。

<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>

会話​

訪問者はそれぞれ MonoChat の顧客になり、会話は訪問者のブラウザに保持されます。同じブラウザで再訪した訪問者には、最後のメッセージから 90 日間、直近 200 件のメッセージが表示されます。別のブラウザや端末からは新しい会話が始まります。チームの返信や入力中の表示は、ウィンドウにすぐに反映されます。

メッセージ欄の横にある絵文字ボタンから、よく使う絵文字を選べます。訪問者はキーボードから任意の絵文字を入力することもできます。

訪問者が送ったメッセージには、WhatsApp と同じようにチェックマークが付きます。送信されると灰色のチェックが 1 つ、MonoChat に届くと灰色のチェックが 2 つ、チームの誰かが会話を開くと青いチェックが 2 つになります。MonoChat では、返信は訪問者のウィンドウが受け取ると配信済み、訪問者がウィンドウを開くと既読と表示されます。

ウィンドウが閉じているときに新しい返信が届くと、チャットボタンに未読メッセージ数が表示され、短い通知音が鳴ります。ブラウザが音を鳴らすのは、訪問者がページ上のどこかをクリックするか入力した後だけです。

メッセージタイプ​

ウィンドウは MonoChat のチャット画面と同じようにメッセージを表示します。返信の上には担当者の名前、日付が変わるところには日付の行、各吹き出しの中には時刻が表示され、訪問者のメッセージにはチェックマークが付きます。

テキスト、絵文字、ファイルのほかに、返信には次のタイプを使えます。メッセージを送信 フローノード、ショートメッセージ、アプリ、関数から送信します(メッセージタイプを参照)。

タイプウィンドウでの表示
画像、動画、音声、スタンプ吹き出しの中に表示されます。
ドキュメントファイルの種類と名前を示すカードで、クリックするとファイルをダウンロードします。
クイック返信最後のメッセージの下に並ぶボタンです。クリックすると、ボタンのタイトルが訪問者の返信として送信されます。
ボタン任意のヘッダー(テキスト、画像、動画、ドキュメント)、フッター、ボタンを持つメッセージです。ボタンは、返信の送信、Web アドレスを開く、電話番号への発信のいずれかを行います。
CTA URLWeb アドレスを開くボタンが 1 つ付いたメッセージです。
リストセクションごとにまとめた行が吹き出しの中に表示されます。行をクリックすると、その行が訪問者の返信として送信されます。
カルーセル訪問者が横にスクロールするカードです。各カードには、画像または動画、タイトル、サブタイトル、ボタンがあります。
位置情報場所の名前と住所を示すピンで、クリックすると Google Maps でその場所が開きます。
位置情報リクエスト位置情報を送信 ボタンです。ブラウザが訪問者に許可を求めた後、訪問者の位置情報が位置情報メッセージとして MonoChat に届きます。
連絡先各連絡先の名前と会社名です。電話番号に発信するリンクと、メールアドレスにメールを書くリンクが付きます。

クイック返信、返信ボタン、リストの行、位置情報リクエストは最後のメッセージでのみ使えるため、訪問者が古い質問に答えることはできません。

ボタンのアイコン​

Web アドレスを開くボタンにはアイコンを表示できます。CTA URL メッセージまたは Web URL ボタンの アイコン フィールドで選択します。このフィールドは Web Chat 向けにメッセージを作成するときにのみ表示され、他のチャネルではアイコンは表示されません。アイコンはリンク、ウェブサイト、WhatsApp、Instagram、Messenger、Facebook、Telegram、TikTok、電話、メール、位置情報で、アイコンのないボタンにはリンクのアイコンが表示されます。

フローとウィジェット​

ウェルカムメッセージ、営業時間、営業時間外の返信、メールアドレスや電話番号の確認、プロアクティブなメッセージは、チャネル設定ではなくフローで設定します。

お客様のアクションを受信しました イベントは、ウィンドウからフローを開始します。

  • チャットウィジェットが初めて開かれました: 開いている会話がない訪問者がウィンドウを開いた場合です。MonoChat が会話を開始するか、終了した会話を再開するため、訪問者より先にフローから訪問者にメッセージを送れます。会話が開いている間にウィンドウを再び開いても、再度発生することはありません。
  • チャットウィジェットが開かれました: 訪問者がウィンドウを開くたびに発生します(初回を含みます)。開いている会話がない訪問者には、上記と同じように会話が開始されます。
  • チャットウィジェットが閉じられました: 会話が開いている間に訪問者がウィンドウを閉じた場合です。

チャット前フォームがオンの場合、ウィンドウは訪問者がフォームに入力した時点で開かれたとみなされます。

ウィジェットのあるページを表示しただけでは、いずれのイベントも発生しません。まだメッセージを書いていない訪問者は、このアクションを待ち受けるフローがある場合にのみ MonoChat のお客様になります。

全ページモードではページと同時にウィンドウが開くため、ページを読み込むとウィンドウを開いたとみなされます。 各チャネルで数えるウィンドウの表示は1分あたり最大60回までで、それを超えた分ではフローは開始されません。

訪問者にあいさつするには、お客様のアクションを受信しました を チャットウィジェットが初めて開かれました に設定したフローを作成し、ウェルカムメッセージを入れた メッセージを送信 ノードを追加します。メッセージはメッセージビルダーで作成し、返信ボタン、リスト、アイコン付きのリンクを使えます。

Powered by MonoChat​

ウィンドウには MonoChat のロゴとともに小さく Powered by と表示されます。これはチャネルの設定ではなく、MonoChat のインストール全体に対してのみ非表示にできます。