รับข้อความ

ตัวแทน RBM จะได้รับข้อความและเหตุการณ์ผ่านWebhook เมื่อผู้ใช้ส่งข้อความไปยังตัวแทนของคุณ บริการ RBM ของ Google จะส่งข้อความไปยังเว็บฮุกที่คุณกำหนดค่าไว้ จากนั้นเอเจนต์จะถอดรหัสข้อความ ประมวลผล และออกการตอบกลับให้ผู้ใช้

ผู้ใช้สามารถส่งข้อความ สถานที่ หรือไฟล์ใดก็ได้ที่ไคลเอ็นต์ RCS อนุญาต เอเจนต์ของคุณต้องจัดการข้อความ สถานที่ หรือไฟล์ใดๆ ที่ผู้ใช้อาจส่ง รวมถึงสถานะข้อผิดพลาดใดๆ ที่ข้อความเหล่านั้นอาจทริกเกอร์

จัดการข้อความขาเข้า

วิธีที่เอเจนต์จัดการและตอบกลับข้อความจากผู้ใช้จะขึ้นอยู่กับตรรกะทางธุรกิจของคุณ อย่างไรก็ตาม โดยทั่วไปแล้ว ขั้นตอนการตอบกลับข้อความของผู้ใช้จะเหมือนกัน

ขั้นตอนที่ 1: ระบุประเภทข้อความที่ผู้ใช้ส่ง

ผู้ใช้สามารถส่งข้อความได้ 4 ประเภท ได้แก่

• ข้อความข้อความคือการตอบกลับแบบอิสระ
• ข้อความคำแนะนำประกอบด้วยข้อมูลการรายงานผล Conversion และข้อความของ การดำเนินการที่แนะนำหรือการตอบกลับที่แนะนำซึ่งผู้ใช้แตะ

• ข้อความตำแหน่งจะมีค่าละติจูดและลองจิจูด

  ข้อควรระวัง: ค่าตำแหน่งอาจเป็นตำแหน่งใดก็ได้ที่ผู้ใช้ระบุ ไม่ใช่แค่ ตำแหน่งปัจจุบันของผู้ใช้

• ข้อความไฟล์มี URI สำหรับไฟล์และข้อมูลที่เกี่ยวข้อง

ขั้นตอนที่ 2: ประมวลผลเนื้อหาข้อความ

เนื้อหาของข้อความผู้ใช้ควรเป็นแนวทางสำหรับตรรกะและการตอบกลับครั้งถัดไปของเอเจนต์ ในการสนทนา

วิธีที่ง่ายที่สุดในการระบุความตั้งใจของผู้ใช้คือการใช้ข้อมูลการรายงานผล Conversion จาก การตอบกลับที่แนะนำหรือการดำเนินการที่แนะนำ ไม่ว่าข้อความที่เชื่อมโยงกับคำแนะนำจะเป็นอย่างไร ข้อมูลการรายงานผล Conversion จะอ่านได้ด้วยเครื่อง

หากผู้ใช้ส่งข้อความ ตัวแทนอาจแยกวิเคราะห์การตอบกลับเพื่อหา คีย์เวิร์ดที่รองรับ หรือใช้ NLU (เช่น Dialogflow) เพื่อประมวลผลข้อความของผู้ใช้และระบุเส้นทางต่อไป

ข้อความตำแหน่งและไฟล์ไม่มีข้อมูลข้อความหรือ Postback ดังนั้นตัวแทนควรพิจารณาบริบทของการสนทนาและข้อความล่าสุดก่อนตอบกลับ

หากตัวแทนไม่ทราบวิธีตอบกลับข้อความของผู้ใช้ ตัวแทนควร ตอบกลับด้วยสถานะข้อผิดพลาดและพยายามสนทนาต่อโดย แจ้งให้ผู้ใช้ระบุข้อมูลเพิ่มเติม ขอข้อมูลใน วิธีอื่น หรือแสดงคำตอบที่แนะนำและการดำเนินการที่แนะนำซึ่ง ตัวแทนทราบวิธีตอบกลับ

ขั้นตอนที่ 3: ดำเนินการตามตรรกะทางธุรกิจสำหรับการโต้ตอบ

เมื่อ Agent ระบุคำตอบที่ถูกต้องสำหรับข้อความของผู้ใช้แล้ว Agent จะรวบรวมข้อมูลที่จำเป็นจากโครงสร้างพื้นฐานของคุณและโต้ตอบกับระบบอื่นๆ ตามความจำเป็นเพื่อดำเนินการตามตรรกะทางธุรกิจสำหรับการโต้ตอบ

ขั้นตอนที่ 4: ตอบกลับผู้ใช้

หลังจากตัวแทนดำเนินการตามตรรกะทางธุรกิจสำหรับการโต้ตอบแล้ว ตัวแทนจะส่ง ข้อความอื่นและสนทนากับผู้ใช้ต่อไป

ตัวอย่าง

โค้ดต่อไปนี้แสดงวิธีที่ตัวแทนรับข้อความ ดูข้อมูลการจัดรูปแบบและค่าได้ที่ UserMessage

หมายเหตุ: สำหรับการเข้าชมในสหรัฐอเมริกา ข้อความผู้ใช้และการแตะการดำเนินการที่แนะนำจะ ขึ้นอยู่กับการจัดประเภทโมเดลการเรียกเก็บเงินของสหรัฐอเมริกา เมื่อเอเจนต์ได้รับเหตุการณ์เหล่านี้ เอเจนต์จะรวมฟิลด์ richMessageClassification ซึ่ง กำหนดประเภทเหตุการณ์ที่เรียกเก็บเงินได้ ดูรายละเอียดการแยกประเภทได้ที่คำแนะนำเกี่ยวกับรูปแบบการเรียกเก็บเงินในสหรัฐอเมริกา

ตัวแทนได้รับข้อความ

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

ตัวแทนได้รับข้อความจากคำแนะนำ

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

ตัวแทนได้รับตำแหน่ง

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

ตัวแทนได้รับไฟล์

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

จัดการเหตุการณ์ขาเข้า

ตัวแทนจะได้รับการแจ้งเตือนเมื่อข้อความที่ส่งถึงผู้ใช้ นำส่งและอ่านแล้ว

โค้ดต่อไปนี้แสดงวิธีที่ตัวแทนรับข้อความ ดูข้อมูลการจัดรูปแบบและค่าได้ที่ UserEvent

ส่งข้อความถึงผู้ใช้แล้ว

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

ผู้ใช้อ่านข้อความแล้ว

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

ผู้ใช้กำลังพิมพ์

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