إرسال الأحداث وتلقّيها لتحسين المحادثات

في المحادثات في ميزة "الرسائل التجارية"، تكون الأحداث مفيدة وغنية بصريًا. تجربة المستخدمين والوكلاء من خلال تقديم محتوى لا يتعلق بالرسائل. بالنسبة المستخدمين، يتم عرض الأحداث كإشعارات داخل محادثاتهم وتظهر بناءً على الإجراءات المختلفة التي قد يتخذها المستخدمون. يتلقّى الوكلاء الفعاليات في الردود التلقائية على الويب وإرسال الأحداث باستخدام طلبات البيانات من واجهة برمجة التطبيقات.

يجب أن يكون موظّفو الدعم على دراية بالأحداث التي يبدأها المستخدم وأن يتمكّنوا من الردّ. وفقًا لذلك. على سبيل المثال، إذا طلب أحد المستخدمين وكيلاً مباشرًا، ولكن لا يمكن للوكيل الاستجابة إيجابًا أو سلبًا للطلب، فإن هذا يؤدي إلى تجربة مستخدم سيئ المستخدم.

أنواع الأحداث

ينتمي كل حدث إلى نوع معين:

  • تشير أحداث طلب موظّف الدعم المباشر إلى أنّ المستخدم يريد التحدّث. مباشرةً إلى موظّف دعم يقدّم خدمة مباشرة

    إذا كان بإمكان موظّف الدعم تحويل المحادثة إلى أحد الممثّلين البشريين، أرسِل حدث الانضمام الممثل، ثم يرسل الرسائل اللاحقة من ممثل بشري.

    إذا لم يتمكّن موظّف الدعم من تحويل المحادثة إلى ممثِّل بشري، إرسال رسالة لإعلام المستخدم وإعلامه بموعد الانتقال إلى موظّف دعم يقدّم خدمة مباشرة المتوفرة.

  • تخبر الأحداث الممثلة التي انضمّت إلى/يسار المستخدمين عند انضمام موظّفي الدعم المباشرين أو مغادرة محادثة. تعرض هذه الأحداث الإشعارات في المحادثة. وتساعد في تحديد توقعات المستخدم حول الاستجابة وأنواع الأسئلة التي يمكنهم طرحها.

    انضمام الممثّل إلى يسار الصفحة

  • تشير أحداث الكتابة إلى أنّ المستخدم أو الوكيل يكتبان.

    بالنسبة إلى المستخدمين، تشير القيمة المنطقية isTyping إلى حالة الكتابة. كل حالة التغيير إلى تشغيل حدث جديد.

    يمكن لموظّفي الدعم إرسال أحداث "TYPING_STARTED" و"TYPING_STOPPED" لعرضها. مؤشرات الكتابة في المحادثة. تُعلم كتابة الأحداث من الوكلاء المستخدمين أن ممثل بشري ينشئ ردًا أو تلك الخلفية يعالج التشغيل الآلي سؤاله أو طلبه.

    مؤشر الكتابة

إرسال حدث

لإرسال حدث، شغِّل الأمر التالي. استبدال العناصر التالية:

  • CONVERSATION_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