Görüşmeleri zenginleştirmek için etkinlik gönderip alın

Business Messages görüşmelerindeki etkinlikler, konuşmaları bilgilendirir ve zenginleştirir mesaj olmayan içeriği ileterek hem kullanıcıların hem de temsilcilerin deneyimini Örneğin, sırasında etkinlikler, ileti dizilerinde bildirim olarak kullanıcıların gerçekleştirebileceği çeşitli işlemlere göre belirlenir. Temsilciler etkinlikleri ve API çağrılarıyla etkinlik gönderme olanağı sunar.

Temsilciler kullanıcı tarafından başlatılan olaylardan haberdar olmalı ve yanıt verebilmelidir buna göre hazırlar. Örneğin, bir kullanıcı canlı temsilci isteğinde bulunur ancak temsilci bu istekte bulunamazsa talebe olumlu ya da olumsuz yanıt vermek, kötü bir kullanıcıya yol açar sahip olacaksınız.

Etkinlik türleri

Her etkinlik belirli bir türe aittir:

  • Canlı temsilci istendi etkinlikleri, kullanıcının konuşmak istediğini gösterir canlı müşteri temsilcisine aktarın.

    Temsilci görüşmeyi insan temsilciye geçirebiliyorsa bir Temsilci katıldı etkinliği gerçekleştirdi, ardından gerçek bir temsilcidir.

    Temsilci görüşmeyi insan temsilciye geçiremiyorsa kullanıcıya bildirmek için bir mesaj gönderin ve canlı temsilcinin ne zaman kullanılabilir.

  • Temsili katıldı/sola etkinlikleri, canlı aracıların katıldığı veya bir sohbetten ayrılabilirsiniz. Bu etkinlikler, görüşmede bildirimleri gösterir ve yanıt verme hızı ile yanıt verme konusunda kullanıcıların beklentilerini sorular soruyor.

    Temsilci katıldı/sola

  • Yazma etkinlikleri, kullanıcının veya aracının yazmakta olduğunu gösterir.

    Kullanıcılar için isTyping boole değeri, kullanıcıların yazma durumunu belirtir. Her bir durum değişiklik yeni bir etkinliği tetikler.

    Temsilciler, görüntülenmeleri için TYPING_STARTED ve TYPING_STOPPED etkinlikleri gönderebilir göstergeleri görebilirsiniz. Aracıların etkinliklerini yazmak kullanıcılara bir yanıt oluşturduğunu veya arka ucun soru veya taleplerini işliyor.

    Yazma göstergesi

Etkinlik gönder

Etkinlik göndermek için aşağıdaki komutu çalıştırın. Aşağıdaki öğeleri değiştirin:

  • İstediğiniz görüşmenin tanımlayıcısıyla CONVERSATION_ID anketi göndermek için
  • Etkinlik için benzersiz bir tanımlayıcıya sahip EVENT_ID
  • Hizmet hesabınızın yolunu gösteren PATH_TO_SERVICE_ACCOUNT_KEY üzerindeki anahtar
  • Şuna benzer bir değere sahip EVENT_TYPE: EventType
  • REPRESENTATIVE_NAME (canlı temsilcinin kullanıcıya yönelik adı) etkinliği oluşturan otomasyonlar da bulunuyor
  • Şuna benzer bir değere sahip 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',
  },
}"

Biçimlendirme ve değer seçenekleri için bkz. conversations.events.

Örnek: Bir temsilciye katılan etkinliği gönderme

# 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

Etkinlik alma

Bir kullanıcı cihazında bir etkinliği tetiklediğinde temsilciniz etkinliği şu adresten alır: web kancası. Etkinlikleri aldığınız şekilde alın ve işleyin. mesajlar bölümüne gidin.

Kullanıcı tarafından başlatılan etkinlikler aşağıdaki biçimdedir.

{
  "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",
  }
}

Biçimlendirme ve değer seçenekleri için bkz. UserMessage.