Bot'tan canlı temsilciye aktarım

Kullanıcılar temsilcilerle iletişim kurduğunda beklentileri, temsilcinin ve aldığı mesajları kimin yazdığını gösterir. Temsilci her seferinde otomatik (BOT) yoksa canlı temsilci mi olduğunu belirleyebilir. (HUMAN) temsilci kullanıcı olabilir. Kullanıcılar görüşmede bu bilgileri görür ve kullanıcıların belirli bir anda ne tür etkileşimler bekleyebileceklerini anlamalarına bir nokta olabilir.

Bir temsilci hem BOT hem de HUMAN temsilcileri destekliyorsa ve ikisi arasında geçiş yaparken bağlam sunmak. BOT cihazından bir cihaza geçerken HUMAN temsilcisi, bir REPRESENTATIVE_JOINED gönderin etkinlik önce HUMAN temsilcisinden ileti gönderme ve tüm iletileri uygun şekilde etiketleme HUMAN temsilcilerinin gönderdiği canlı temsilcilerden gelen aşağıdaki mesajlar. canlı müşteri temsilcisi sohbetten ayrılır, REPRESENTATIVE_LEFT etkinliği gönderir. Bu etkinlikleri çerçeveleme, kullanıcılara daha karmaşık sorular sorabileceklerini ve daha fazla serbest biçimli yanıt beklemeniz gerekir.

Bu sohbet akışında kullanıcının ilk etkileşimleri, BOT temsilcisi olarak mesaj gönderen ancak canlı temsilci katılan katılımcı HUMAN temsilcisi olarak mesaj gönderir. Canlı temsilcinin mesajları REPRESENTATIVE_JOINED ve REPRESENTATIVE_LEFT tarafından çerçeveleniyor etkinlikler.

1. Kullanıcı, temsilciyle görüşmeye başlar.

2. Kullanıcı bir yanıt yazmaya başladığında yardımcı olur.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "live-agent-handoff",
     "requestId": "1234567890",
     "userStatus": {
       "isTyping": "true",
       "createTime": "2020-10-02T15:01:23.045123456Z",
     },
     "sendTime": "2020-10-02T15:01:24.045123456Z",
   }
   

3. Kullanıcı "Merhaba, bir sorunum var" mesajını gönderir bunu yapabilirsiniz.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "live-agent-handoff",
     "requestId": "123123123",
     "message": {
       "messageId": "4444",
       "name": "conversations/12345/messages/67890",
       "text": "Hi, I have a problem",
       "createTime": "2020-10-02T15:05:23.045123456Z",
     },
     "context": {
       "entryPoint": "PLACESHEET",
       "userInfo": {
         "displayName": "Michael",
         "userDeviceLocale": "en",
       },
       "resolvedLocale": "en",
     }
     "sendTime": "2020-10-02T15:05:24.045123456Z",
   }
   

4. Temsilci, "Bizimle iletişime geçtiğiniz için teşekkür ederiz. Canlı yayındayken bunu sizinle sohbet etmeye hazır." BOT adlı kişiden mesaj olarak temsil eder.

   curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
   -H "Content-Type: application/json" \
   -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
   -d "{
     'messageId': '5555',
     'text': 'Thanks for contacting us. I'll pass this along when a live agent is available to chat with you.',
     'representative': {
       'avatarImage': 'https://live.agent/bot-avatar.jpg',
       'displayName': 'Hello World Agent',
       'representativeType': 'BOT'
     }
   }"
   

5. Canlı müşteri temsilcisi müsait olur.

6. Temsilci, ilk etkinliği göndermeden önce REPRESENTATIVE_JOINED etkinliği gönderir mesajı var.

   curl -X POST "https://businessmessages.googleapis.com/v1/conversations/12345/events?eventId=6666" \
   -H "Content-Type: application/json" \
   -H "`oauth2l header --json /path/to/service/account/key.json businessmessages`" \
   -d "{
     'eventType': 'REPRESENTATIVE_JOINED',
     'representative': {
       'avatarImage': 'https://live.agent/human-avatar.jpg',
       'displayName': 'Jane Doe',
       'representativeType': 'HUMAN',
     },
   }"
   

7. Temsilci, "Bir sorun yaşadığınızı görüyorum. Nasıl yardımcı olabilirim?" mesaj olarak bir HUMAN temsilcisinden geliyor.

   curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
   -H "Content-Type: application/json" \
   -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
   -d "{
     'messageId': '7777',
     'text': 'I see you have a problem. How can I help?',
     'representative': {
       'avatarImage': 'https://live.agent/human-avatar.jpg',
       'displayName': 'Jane Doe',
       'representativeType': 'HUMAN'
     }
   }"
   

8. Canlı temsilci ve kullanıcı, kullanıcının isteği gerçekleşene kadar karşılandı. Canlı temsilci tarafından oluşturulan tüm mesajlar, HUMAN temsilcisi.

9. Temsilci, canlı temsilci evden ayrıldığında bir REPRESENTATIVE_LEFT etkinliği gönderir yardımcı olur.

   curl -X POST "https://businessmessages.googleapis.com/v1/conversations/12345/events?eventId=6666" \
   -H "Content-Type: application/json" \
   -H "`oauth2l header --json /path/to/service/account/key.json businessmessages`" \
   -d "{
     'eventType': 'REPRESENTATIVE_LEFT',
     'representative': {
       'avatarImage': 'https://live.agent/human-avatar.jpg',
       'displayName': 'Jane Doe',
       'representativeType': 'HUMAN',
     },
   }"
   

10. Temsilci, şu durum haricinde sonraki tüm mesajları BOT temsilciye gönderir: sohbete başka bir canlı temsilci katılır.