Dialogflow Messenger の JavaScript イベント

Dialogflow Messenger は、イベント リスナーを作成できるさまざまなイベントをトリガーします。 一部のイベントには、イベントに関する詳細情報を提供する detail オブジェクト フィールドがあります。

df-messenger-loaded

エージェント ダイアログが最初に読み込まれます。

詳細プロパティ:

  • なし

次に例を示します。

window.addEventListener('df-messenger-loaded', () => {
  // Messenger is now ready.
});

df-chat-open-changed

チャットが開始または終了しました。

詳細プロパティ:

  • isOpenboolean): チャットの新しい状態

次に例を示します。

window.addEventListener('df-chat-open-changed', (event) => {
  console.log(`Chat is ${event.detail.isOpen ? 'open' : 'closed'}`);
});

df-user-input-entered

ユーザーがテキストを入力しました。

詳細プロパティ:

  • inputstring): ユーザーが入力した値

次に例を示します。

window.addEventListener('df-user-input-entered', (event) => {
  console.log(event.detail.input);
});

df-request-sent

Dialogflow バックエンドに送信されたリクエスト。

詳細プロパティ:

  • dataobject): データ コンテナ
  • data.requestBodyobject): 送信されたリクエスト

次に例を示します。

window.addEventListener('df-request-sent', (event) => {
  console.log('Request', event.detail.data.requestBody);
});
window.addEventListener('df-request-sent', (event) => {
  event.preventDefault(); // Dialogflow Messenger won't send the request.

  // Send request yourself.
});

df-response-received

エージェント ダイアログにレスポンスが届きました。

詳細プロパティ:

次に例を示します。

window.addEventListener('df-response-received', (event) => {
  // Remove all non-text messages.
  event.detail.data.messages = event.detail.data.messages.filter(message => {
    return message.type === 'text';
  });
});
window.addEventListener('df-response-received', (event) => {
  event.preventDefault(); // Dialogflow Messenger won't handle the response.

  const messenger = document.querySelector('df-messenger');
  event.detail.data.messages.forEach(message => {
    if (message.type === 'text') {
      messenger.renderCustomText(message.text);
    }
  });
});

df-messenger-error

バックエンドへのリクエストが失敗しています。

詳細プロパティ:

  • errorobject): 発生したエラー

次に例を示します。

window.addEventListener('df-messenger-error', (event) => {
  console.log(event.detail.error);
});

df-session-expired

エージェントとのセッションが期限切れになりました。

詳細プロパティ:

  • なし

次に例を示します。

window.addEventListener('df-session-expired', () => {
  const messenger = document.querySelector('df-messenger');
  messenger.renderCustomText(`*Session expired*`, /* isBot= */ true);
  messenger.startNewSession({ retainHistory: true });
});

df-session-ended

セッションが終了しました。

詳細プロパティ:

  • なし

次に例を示します。

window.addEventListener('df-session-ended', () => {
  const messenger = document.querySelector('df-messenger');
  messenger.renderCustomText(`*Session ended*`, /* isBot= */ true);
  messenger.startNewSession({ retainHistory: true });
});

df-url-suggested

推奨リソースの URL。

詳細プロパティ:

  • suggestedUrlsstring[]): 推奨 URL リスト

次に例を示します。

window.addEventListener('df-url-suggested', (event) => {
  if (event.detail.suggestedUrls.length === 1) {
    window.location.href = event.detail.suggestedUrls[0];
  }
});

df-accordion-clicked

ユーザーがアコーディオンをクリックしました。

詳細プロパティ:

  • なし

df-button-clicked

ユーザーがボタンをクリックしました。

詳細プロパティ:

  • actionLinkstring): クリックされたボタンのアンカー href(指定されている場合)
  • eventstring): クリックされたボタンのイベント(指定されている場合)
  • languageCodestring): イベントの言語コード(指定されている場合)、それ以外の場合はメイン言語コード
  • textstring): クリックされたボタンのテキスト
window.addEventListener('df-button-clicked', (event) => {
  event.preventDefault(); // Dialogflow Messenger won't send the "event" request.

  // Handle "event" yourself.
});

df-chip-clicked

ユーザーがチップをクリックしました。

詳細プロパティ:

  • actionLinkstring): クリックされたチップのアンカー href(指定されている場合)
  • textstring): クリックされたチップのテキスト

df-citation-clicked

ユーザーが引用をクリックしました。

詳細プロパティ:

  • actionLinkstring): 引用のアンカー href
  • titlestring): 引用のタイトル

df-info-card-clicked

ユーザーが情報カードをクリックしました。

詳細プロパティ:

  • actionLinkstring): 情報カードのアンカー href。
  • titlestring): 情報カードのタイトル

df-list-element-clicked

ユーザーがリスト要素をクリックしました。

詳細プロパティ:

  • actionLinkstring): リスト要素のアンカー href(指定されている場合)
  • eventstring): クリックされたリスト要素のイベント(指定されている場合)
  • languageCodestring): イベントの言語コード(指定されている場合)、それ以外の場合はメイン言語コード
  • titlestring): リスト要素のタイトル
window.addEventListener('df-list-element-clicked', (event) => {
  event.preventDefault(); // Dialogflow Messenger won't send the "event" request.

  // Handle "event" yourself.
});

df-image-clicked

ユーザーが画像をクリックしました。

詳細プロパティ:

  • actionLinkstring): 画像のアンカー href(指定されている場合)