İleti alma

RBM temsilcileri, iletileri ve etkinlikleri webhook değerine ayarlayın. Bir kullanıcı temsilcinize mesaj gönderdiğinde Google'ın RBM hizmeti mesajı yapılandırabilirsiniz. Böylece temsilciniz mesajın kodunu çözebilir. işleme koymalı ve kullanıcıya bir yanıt vermelidir.

Kullanıcılar, RCS istemcilerinin izin verdiği metinleri, konumları veya dosyaları gönderebilir. Temsilcinizin, kullanıcının gönderebileceği tüm metin, konum veya dosyaları yanı sıra bu mesajların tetikleyebileceği hata durumlarını görebilirsiniz.

Gelen mesajları işleme

Temsilcinizin kullanıcılardan gelen mesajları işleme ve yanıtlama biçimi büyük ölçüde bağlıdır mantığınıza göre değişir. Ancak genel olarak, bir kullanıcıya yanıt vermek için atılması gereken adımlar tutarlı olduğundan emin olun.

1. adım: Kullanıcının gönderdiği mesajın türünü belirleyin

Kullanıcılar dört tür mesaj gönderebilir:

• Kısa mesajlar serbest biçimli yanıtlardır.
• Öneri mesajları, geri gönderme verilerini ve kullanıcının dokunduğu önerilen işlem veya önerilen yanıt.

• Konum mesajları enlem ve boylam değerlerini içerir.

• Dosya mesajları, dosyanın URI'sini ve ilişkili verileri içerir.

2. Adım: İleti içeriğini işleyin

Kullanıcı mesajının içeriği, aracınızın mantığına ve sonraki yanıtına yön vermelidir tercih edebilirsiniz.

Kullanıcının amacını belirlemenin en kolay yolu, önerilen yanıt veya önerilen işlem. İlgili metinden bağımsız olarak, geri gönderme verileri makine tarafından okunabilir.

Bir kullanıcı kısa mesaj gönderirse temsilciniz yanıtı veya NLU (örneğin, Dialogflow) kullanma bir yol çizmeniz gerekir.

Konum ve dosya iletileri metin veya geri gönderme verileri içermez. Bu nedenle, görüşmenin bağlamını ve gelen son mesajları dikkate almalıdır. inceleyin.

Temsilciniz kullanıcının mesajına nasıl yanıt vereceğini bilmiyorsa bir hata durumuyla yanıt verip konuşmaya bir giriş isteyerek kullanıcıdan ek bilgi istemesini ya da işlem önerisi ve işlem önerilerinde bulunarak yanıt vermesi gerektiğini bilir.

3. adım: Etkileşimin iş mantığını yerine getirin

Temsilciniz kullanıcının mesajı için doğru yanıtı belirlediğinde, sizin altyapınızdan gerekli bilgileri toplar ve iş mantığını yerine getirmek için gerektiğinde diğer sistemlerle bahsedeceğim.

4. adım: Kullanıcıya yanıt verin

Temsilci, etkileşimin iş mantığını yerine getirdikten sonra, başka bir mesaj gönderebilir ve kullanıcıyla görüşmeye devam eder.

Örnekler

Aşağıdaki kod, temsilcinizin mesajları nasıl aldığını gösterir. Biçimlendirme ve değer bilgisi için UserMessage olarak değiştirin.

Aracı metni alır

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "text": "Hello, world!"
}

Temsilci, öneriden mesaj alır

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "suggestionResponse": {
    "postbackData": "suggestion_1",
    "text": "Suggestion #1"
  }
}

Temsilci bir konum alır

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "location": {
    "latitude": 37.422000,
    "longitude": -122.084056
  }
}

Temsilci bir dosya alır

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "userFile": {
    "thumbnail": {
      "mimeType": "image/jpeg",
      "fileSizeBytes": 1280,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c8",
      "fileName": "4_animated.jpeg"
    },
    "payload": {
      "mimeType": "image/gif",
      "fileSizeBytes": 127806,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c9",
      "fileName": "4_animated.gif"
    }
  }
}

Gelen etkinlikleri yönetme

Temsilciniz, kullanıcılara gönderdiği mesajlar aşağıdaki gibi olduğunda bildirim alır: ve okundu.

Aşağıdaki kod, temsilcinizin mesajları nasıl aldığını gösterir. Biçimlendirme ve değer bilgisi için UserEvent.

Mesaj kullanıcıya teslim edildi

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "eventType": "DELIVERED"
}

Mesaj kullanıcı tarafından okundu

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "eventType": "READ"
}

Kullanıcı yazıyor

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "IS_TYPING",
  "eventId": "EVENT_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "agentId": "AGENT_ID"
}