AI接客トリガー（ホストサイト連携）

ホストサイトから任意のタイミングでAI接客チャットにメッセージを送信できるトリガー機能です。

AI接客トリガーとは

AI接客トリガーとは、ホストサイト側のJavaScriptからAI接客チャットの表示やメッセージ送信を行える機能です。ブラウザのCustomEventを使って、任意のボタンやリンクのクリックなど、ホストサイト側の操作をきっかけにAI接客の会話を開始できます。

たとえば「料金について聞く」ボタンをWebサイト上に配置し、クリック時にAI接客へメッセージを自動送信することで、リードが手入力せずにスムーズに会話を始められます。

AI接客トリガーでできること

機能

説明

メッセージの自動送信

ホストサイトからAI接客チャットへ任意のメッセージを送信できます

チャットの表示・展開

イベント発火時にチャットウィジェットが最小化・非表示だった場合、自動的に開いた状態になります。メッセージなしで発火すると、表示のみを行えます

イベント仕様

イベント名

immedio-trigger:send-ai-sdr-message

イベントの種類

ブラウザ標準の CustomEvent を使用します。window.dispatchEvent() でイベントを発火します。

detail（イベントデータ）

項目

型

説明

message

string（任意）

AI接客チャットに送信するメッセージ。省略した場合、チャットウィジェットの表示のみ行われ、メッセージは送信されません

動作の流れ

ホストサイト側でCustomEventを発火します
AI接客チャットが最小化・非表示の場合、自動的に開いた状態になります
detail.message にメッセージを指定した場合、その内容がリードの発言としてAIに送信されます
AIが応答を返します

使い方（サンプルコード）

以下のコードを、immedioタグが読み込まれているページに配置すると、任意のタイミングでAI接客にメッセージを送信できます。

基本的な使い方

window.dispatchEvent(new CustomEvent('immedio-trigger:send-ai-sdr-message', {
  detail: { message: '料金を教えて' },
}));

チャットウィジェットの表示のみ行う（メッセージなし）

detail.message を省略すると、メッセージは送信されず、チャットウィジェットの表示のみ行われます。最小化・非表示状態のウィジェットを開いた状態にしたい場合に使用します。

window.dispatchEvent(new CustomEvent('immedio-trigger:send-ai-sdr-message'));

AI接客の基本設定で「デフォルトの表示状態」を「非表示」にしている場合、ウィジェットはこのイベントを発火するまで表示されません。「サイト側の任意のタイミングでのみAI接客を出したい」場合は、「非表示」設定とこのイベントを組み合わせてください。

ボタンクリック時に発火する例

<button onclick="window.dispatchEvent(new CustomEvent('immedio-trigger:send-ai-sdr-message', { detail: { message: '料金プランについて教えてください' } }))">
  料金について聞く
</button>

複数のボタンを配置する例

<button onclick="window.dispatchEvent(new CustomEvent('immedio-trigger:send-ai-sdr-message', { detail: { message: 'デモを予約したい' } }))">
  デモを予約する
</button>

<button onclick="window.dispatchEvent(new CustomEvent('immedio-trigger:send-ai-sdr-message', { detail: { message: '導入事例を教えてください' } }))">
  導入事例を見る
</button>

検索バーの入力内容をAI接客に送信する例

検索バーに入力された任意の文字列を、AI接客へそのまま送信する例です。リードが検索バーに質問を入力して送信ボタンを押すと、その内容がAI接客チャットに転送されます。

<form onsubmit="event.preventDefault(); var input = this.querySelector('input'); var message = input.value.trim(); if (message) { window.dispatchEvent(new CustomEvent('immedio-trigger:send-ai-sdr-message', { detail: { message: message } })); input.value = ''; }">
  <input type="text" placeholder="AIに質問する..." />
  <button type="submit">送信</button>
</form>

注意事項

イベントを発火するには、immedioのタグが読み込まれており、AI接客が有効になっている必要があります
detail.message が空文字または空白のみの場合、メッセージは送信されず、ウィジェットの表示のみ行われます
AI接客のチャット履歴の読み込みが完了する前にイベントが発火された場合、メッセージは送信されません