Method: phones.agentEvents.create

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

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

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

คำขอ 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