イベントを送受信して会話を充実

ビジネス メッセージの会話では、イベントによって情報が伝達され、会話が強化される メッセージ以外のコンテンツを伝えることで、ユーザーとエージェントの両方のエクスペリエンスを向上させます。対象 場合、イベントは会話内に通知として表示され、 ユーザーのアクションに基づいて 自動スケールできますエージェントは、 API 呼び出しを使用してイベントを送信します。

エージェントは、ユーザーが開始したイベントを認識し、対応できる必要があります。 必要があります。たとえば、ユーザーがライブ対応のエージェントをリクエストしても、エージェントが 肯定的か否定的かにかかわらず、適切な 体験できます

イベントタイプ

各イベントは特定のタイプに属します。

  • Live agent requested イベントは、ユーザーが話したいことを望んでいることを示します。 直接ライブ対応のエージェントに転送できます

    エージェントが会話を人間の担当者に移行できる場合は、 代表参加イベントに割り当てられ、その後、グループ メンバーから モデルです。

    エージェントが会話を人間の担当者に移行できない場合は、 ライブ対応のエージェントがいつ到着するかを知らせるメッセージをユーザーに通知 できます。

  • 代表参加/退出イベント 会話から退出します。これらの予定は会話で通知を表示します 応答性やユーザーの期待に応えられるよう 質問を投げかける。

    代理人が入社/退会しました

  • Typing イベントは、ユーザーまたはエージェントが入力中であることを示します。

    ユーザーの場合、ブール値 isTyping は入力ステータスを示します。各ステータス 新しいイベントがトリガーされます。

    エージェントは、表示する TYPING_STARTED イベントと TYPING_STOPPED イベントを送信できます。 入力時のインジケーターが変わります。エージェントからイベントを入力すると 作成中またはバックエンドのときに 自動化で質問やリクエストを処理しています

    入力インジケーター

イベントを送信する

イベントを送信するには、次のコマンドを実行します。次の項目を置き換えます。

  • CONVERSATION_ID は、目的の会話の ID に置き換えます。 アンケートを送信する
  • EVENT_ID は、イベントの一意の識別子に置き換えます
  • PATH_TO_SERVICE_ACCOUNT_KEY は、サービス アカウントのパスに置き換えます。 鍵を作成します。
  • 次の値を持つ EVENT_TYPE EventType
  • REPRESENTATIVE_NAME は、ライブ対応のエージェントの名前で置き換えます。 イベントを自動的に生成して
  • 次の値を持つ REPRESENTATIVE_TYPE RepresentativeType
curl -X POST "https://businessmessages.googleapis.com/v1/conversations/CONVERSATION_ID/events?eventId=EVENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-messages" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businessmessages`" \
-d "{
  'eventType': 'EVENT_TYPE',
  'representative': {
    'avatarImage': 'REPRESENTATIVE_AVATAR_URL',
    'displayName': 'REPRESENTATIVE_NAME',
    'representativeType': 'REPRESENTATIVE_TYPE',
  },
}"

書式設定と値のオプションについては、以下をご覧ください。 conversations.events。

例: 代表的な参加イベントを送信する

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at

#     https://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# This code sends a REPRESENTATIVE_JOINED event to the user.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/message/events#send

# Replace the __CONVERSATION_ID__ with a conversation id that you can send messages to
# Make sure a service account key file exists at ./service_account_key.json

curl -X POST "https://businessmessages.googleapis.com/v1/conversations/__CONVERSATION_ID__/events?eventId=6a0af2c6-787d-4097-870d-93fe20351747" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-messages" \
-H "$(oauth2l header --json ./service_account_key.json businessmessages)" \
-d "{
  'eventType': 'REPRESENTATIVE_JOINED',
  'representative': {
    'avatarImage': 'https://developers.google.com/identity/images/g-logo.png',
    'displayName': 'Chatbot',
    'representativeType': 'HUMAN'
  }
}"
send-event-representative-joined.sh

イベントを受信する

ユーザーがデバイスでイベントをトリガーすると、エージェントは次の場所でイベントを受け取ります。 あります。イベントの受信と処理は、 メッセージ。

ユーザーが開始するイベントの形式は次のとおりです。

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "requestId": "REQUEST_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "sendTime": "SEND_TIME",
  "userStatus": {
    "isTyping": "BOOLEAN",
    "requestedLiveAgent": "BOOLEAN",
    "createTime": "CREATION_TIME",
  }
}

書式設定と値のオプションについては、以下をご覧ください。 UserMessage。