เอกสารนี้อธิบายวิธีที่แพลตฟอร์ม RCS สำหรับธุรกิจจัดการการส่งข้อความ และการโต้ตอบ API อื่นๆ โดยแยกความแตกต่างระหว่างการดำเนินการแบบซิงโครนัสและ แบบอะซิงโครนัส
โดยทั่วไปแล้ว การโต้ตอบของ RBM API จะเป็นไปตามรูปแบบคำขอ-การตอบกลับแบบซิงโครนัสที่ระดับ HTTP อย่างไรก็ตาม ผลลัพธ์ของการเรียก API หลายรายการ โดยเฉพาะการนำส่งข้อความ จะได้รับการจัดการแบบไม่พร้อมกันผ่านเว็บฮุก ดูรายละเอียดได้ที่ส่วนต่อไปนี้
การส่งข้อความ: คำขอแบบซิงโครนัส การนำส่งแบบอะซิงโครนัส
ระบบจะประมวลผลคำขอ API ของ phones.agentMessages.create
แบบซิงโครนัสจากมุมมองของ API
เมื่อคุณส่งคำขอ HTTP ไปยังแพลตฟอร์ม RCS สำหรับธุรกิจ เซิร์ฟเวอร์จะตอบกลับแทบจะทันทีด้วยรหัสสถานะ HTTP มาตรฐาน (เช่น 200 OK หรือข้อผิดพลาด) เพื่อระบุว่าได้รับคำขอและคำขอนั้นถูกต้องหรือไม่
อย่างไรก็ตาม การนำส่งข้อความจริงไปยังผู้ใช้ปลายทางจะประมวลผลแบบอะซิงโครนัส ปัจจัยต่อไปนี้อาจส่งผลต่อกระบวนการนี้
- สถานะผู้รับ: ผู้ใช้อาจออฟไลน์ แบตเตอรี่หมด หรือไม่ได้เปิดใช้ RCS
- สภาพเครือข่าย: ปัญหาเครือข่ายของผู้ให้บริการอาจทำให้การนำส่งข้อความล่าช้าหรือไม่สำเร็จ
แพลตฟอร์ม RCS สำหรับธุรกิจจะอัปเดตสถานะการนำส่งข้อความ (เช่น ใบตอบรับการนำส่งและใบตอบรับการอ่าน) แบบไม่พร้อมกันผ่านWebhook
ดังนั้น แม้ว่าคำขอ API เริ่มต้นจะเป็นแบบซิงโครนัส แต่คุณควรใช้
เหตุการณ์
Webhook แบบอะซิงโครนัสเพื่อติดตามการนำส่งข้อความ โปรดอย่าคาดหวังว่าจะได้รับการยืนยันสถานะการนำส่งจากคำตอบของ phones.agentMessages.create ทันที
การโต้ตอบอื่นๆ ของ RBM API
API ของ RBM อื่นๆ ที่อิงตาม HTTP ส่วนใหญ่ยังทำงานด้วยรูปแบบคำขอ-การตอบกลับแบบซิงโครนัส API เหล่านี้จะให้การตอบกลับ HTTP ทันทีซึ่งระบุสถานะ ของคำขอ (สำเร็จหรือข้อผิดพลาด) อย่างไรก็ตาม แม้ว่าคำขอจะเป็นแบบซิงโครนัส แต่การดำเนินการที่เกิดจากคำขออาจเกี่ยวข้องกับกระบวนการแบบอะซิงโครนัส ตัวอย่างเช่น การตอบกลับที่สำเร็จต่อการเรียก API เพื่ออัปเดตข้อมูลตัวแทน ไม่ได้หมายความว่าการอัปเดตจะแสดงให้เห็นทุกที่ในทันที แต่อาจมี การหน่วงเวลาในการเผยแพร่สั้นๆ
ปลายทางของเว็บฮุค: เหตุการณ์แบบอะซิงโครนัส
เหตุการณ์ต่อไปนี้จะส่งไปยังปลายทางWebhook ของคุณแบบไม่พร้อมกัน
- ข้อความที่ผู้ใช้ส่งเข้ามา: แพลตฟอร์ม RCS สำหรับธุรกิจจะพุชข้อความที่ผู้ใช้ส่งเข้ามาไปยังปลายทางเว็บฮุคของคุณ โปรดยืนยันข้อความขาเข้า
- ใบตอบรับการนำส่งและใบตอบรับการอ่าน: ระบบจะส่งการแจ้งเตือนการนำส่งข้อความและสถานะการอ่าน ผ่านเว็บฮุก
- เหตุการณ์การสนทนา: ระบบจะส่งเหตุการณ์บางอย่างที่เกี่ยวข้องกับการสนทนา เช่น ตัวบ่งชี้การพิมพ์ ผ่านเว็บฮุก
- เหตุการณ์การหมดอายุและการเพิกถอนข้อความ: แพลตฟอร์ม RCS สำหรับธุรกิจ จะส่งเหตุการณ์เพื่อยืนยันว่ามีการเพิกถอนข้อความที่หมดอายุแล้วสำเร็จหรือไม่