Method: phones.agentEvents.create

ส่งเหตุการณ์จากตัวแทนไปยังผู้ใช้

เหตุการณ์ของตัวแทนสามารถใช้เพื่อระบุว่าตัวแทนได้อ่านข้อความจากผู้ใช้แล้ว หรือตัวแทนกำลังพิมพ์ (ซึ่งจะเพิ่มองค์ประกอบของมนุษย์ลงในประสบการณ์การใช้งาน RCS สำหรับธุรกิจ) หากผู้ใช้ไม่ได้เปิดใช้ RCS แพลตฟอร์ม RCS สำหรับธุรกิจจะแสดงข้อผิดพลาด NOT_FOUND (HTTP 404) หากผู้ใช้เปิดใช้ RCS แต่ไม่สามารถติดต่อได้ในขณะนั้น แพลตฟอร์มจะแสดงการตอบกลับ 200 OK และจัดการการนำส่งตามประเภทเหตุการณ์ ระบบจะจัดคิวเหตุการณ์ของเอเจนต์ในคิวจัดเก็บและส่งต่อเป็นเวลาสูงสุด 30 วัน และจะส่งเมื่อผู้ใช้กลับมาออนไลน์ เฉพาะเหตุการณ์ IS_TYPING เท่านั้นที่จะเป็นแบบชั่วคราวและไม่มีการจัดคิว

เหตุการณ์ของ Agent จะเพิกถอนไม่ได้หลังจากส่งแล้ว ซึ่งแตกต่างจากข้อความของ Agent

คำขอ HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

"phones/{E.164}" โดยที่ {E.164} คือหมายเลขโทรศัพท์ของผู้ใช้ในรูปแบบ E.164 เช่น สำหรับผู้ใช้ที่มีหมายเลขโทรศัพท์ในสหรัฐอเมริกา +1-222-333-4444 ค่าจะเป็น phones/+12223334444 และปลายทางที่ได้จะเป็น https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents

พารามิเตอร์การค้นหา

พารามิเตอร์
eventId

string

รหัสของเหตุการณ์ที่กำหนดโดยเอเจนต์ ต้องเป็น UUID ตามที่กำหนดไว้ใน https://tools.ietf.org/html/rfc4122 แพลตฟอร์ม RCS สำหรับธุรกิจจะไม่สนใจข้อความของตัวแทนที่ส่งพร้อมรหัสที่ใช้โดยข้อความหรือเหตุการณ์ก่อนหน้านี้ซึ่งส่งจากตัวแทนเดียวกัน
agentId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของตัวแทน

เนื้อความของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ AgentEvent

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ AgentEvent ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/rcsbusinessmessaging

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview