Method: phones.agentEvents.create

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

เหตุการณ์ของ Agent สามารถใช้เพื่อระบุว่า Agent ได้อ่านข้อความจากผู้ใช้แล้ว หรือ Agent อยู่ระหว่างการพิมพ์ (ซึ่งจะเพิ่มองค์ประกอบของมนุษย์ลงในประสบการณ์ RBM) หาก RBM เข้าถึงผู้ใช้ไม่ได้ แพลตฟอร์ม RBM จะส่งคืน 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 แพลตฟอร์ม RBM จะไม่สนใจข้อความของตัวแทนที่ส่งด้วยรหัส ที่ข้อความหรือเหตุการณ์ก่อนหน้าส่งมาจากตัวแทนเดียวกัน
agentId

string

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

เนื้อหาของคำขอ

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

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

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0