Method: phones.agentEvents.create

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

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

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

คำขอ 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://www.rfc-editor.org/info/rfc9562 แพลตฟอร์ม RCS for Business จะละเว้นข้อความของตัวแทนที่ส่งด้วยรหัสที่ใช้โดยข้อความหรือเหตุการณ์ก่อนหน้าที่ส่งจากตัวแทนเดียวกัน
agentId

string

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

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

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

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

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

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

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

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

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