Tài liệu này làm rõ cách nền tảng RBM xử lý việc gửi thông báo và các hoạt động tương tác API khác, phân biệt giữa các thao tác đồng bộ và không đồng bộ.
Các hoạt động tương tác với API RBM thường tuân theo mẫu yêu cầu-phản hồi đồng bộ ở cấp độ HTTP. Tuy nhiên, kết quả của nhiều lệnh gọi API, đặc biệt là việc phân phối thông báo, được xử lý không đồng bộ thông qua webhook. Hãy tham khảo các phần sau đây để biết thông tin chi tiết.
Gửi tin nhắn: Yêu cầu đồng bộ, phân phối không đồng bộ
Yêu cầu API phones.agentMessages.create được xử lý đồng bộ theo quan điểm API. Khi bạn gửi yêu cầu HTTP đến nền tảng RBM, máy chủ sẽ phản hồi gần như ngay lập tức bằng một mã trạng thái HTTP tiêu chuẩn (chẳng hạn như 200 OK hoặc một lỗi) để cho biết liệu yêu cầu đó có được nhận và hợp lệ hay không.
Tuy nhiên, việc phân phối thực tế thông báo đến người dùng cuối được xử lý không đồng bộ. Các yếu tố sau có thể ảnh hưởng đến quá trình này:
- Trạng thái của người nhận: Người dùng có thể đang không có kết nối mạng, pin đã hết hoặc chưa bật RCS.
- Điều kiện mạng: Các vấn đề về mạng của nhà mạng có thể làm chậm hoặc ngăn việc phân phối tin nhắn.
Nền tảng RBM cung cấp thông tin cập nhật về trạng thái phân phối thư (chẳng hạn như biên nhận phân phối và biên nhận đã đọc) không đồng bộ thông qua webhooks.
Do đó, mặc dù yêu cầu API ban đầu là đồng bộ, nhưng bạn nên dựa vào sự kiện webhook không đồng bộ để theo dõi việc phân phối thông báo. Đừng mong đợi phản hồi phones.agentMessages.create sẽ xác nhận ngay trạng thái phân phối.
Các hoạt động tương tác khác với API RBM
Hầu hết các API RBM khác dựa trên HTTP cũng hoạt động theo mô hình yêu cầu-phản hồi đồng bộ. Các API này cung cấp phản hồi HTTP tức thì cho biết trạng thái của yêu cầu (thành công hoặc lỗi). Tuy nhiên, mặc dù yêu cầu là đồng bộ, nhưng các hành động phát sinh từ yêu cầu đó có thể liên quan đến các quy trình không đồng bộ. Ví dụ: phản hồi thành công cho lệnh gọi API để cập nhật thông tin về tác nhân không có nghĩa là nội dung cập nhật được phản ánh tức thì ở mọi nơi; có thể có độ trễ truyền tải ngắn.
Điểm cuối webhook: Sự kiện không đồng bộ
Các sự kiện sau đây được phân phối không đồng bộ đến điểm cuối webhook:
- Tin nhắn đến của người dùng: Nền tảng RBM đẩy tin nhắn đến của người dùng đến điểm cuối webhook của bạn. Hãy nhớ xác minh tin nhắn đến.
- Thông báo xác nhận đã gửi và đã đọc: Thông báo về trạng thái gửi và đọc tin nhắn được gửi qua webhook.
- Sự kiện trò chuyện: Một số sự kiện liên quan đến cuộc trò chuyện, chẳng hạn như chỉ báo nhập, được gửi thông qua webhook.
- Sự kiện thu hồi và hết hạn thông báo: Nền tảng RBM gửi sự kiện để xác nhận xem một thông báo đã hết hạn có được thu hồi thành công hay không.