Tài liệu này làm rõ cách nền tảng RCS cho doanh nghiệp xử lý việc gửi tin nhắn 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 của RBM API thường tuân theo một 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 gửi tin nhắn, đượ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 thông báo: Yêu cầu đồng bộ, gửi không đồng bộ
Yêu cầu API phones.agentMessages.create được xử lý đồng bộ theo quan điểm của API. Khi bạn gửi yêu cầu HTTP đến nền tảng RCS cho doanh nghiệp, máy chủ sẽ phản hồi gần như ngay lập tức bằng 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 yêu cầu đã được nhận và có hợp lệ hay không.
Tuy nhiên, việc gửi thông báo thực tế cho người dùng cuối sẽ đượ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, hết pin 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 trễ hoặc ngăn chặn việc gửi tin nhắn.
Nền tảng RCS cho doanh nghiệp cung cấp thông tin cập nhật về trạng thái gửi tin nhắn (chẳng hạn như thông báo xác nhận đã gửi và thông báo xác nhận đã đọc) không đồng bộ thông qua webhook.
Do đó, mặc dù yêu cầu API ban đầu là đồng bộ, nhưng bạn nên dựa vào các sự kiện webhook không đồng bộ để theo dõi việc gửi tin nhắn. Đừng mong đợi thông tin xác nhận ngay lập tức về trạng thái gửi từ phản hồi phones.agentMessages.create.
Các lượt tương tác khác với RBM API
Hầu hết các API RBM dựa trên HTTP khác 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 một 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ụ: một phản hồi thành công cho lệnh gọi API để cập nhật thông tin về nhân viên không có nghĩa là thông tin cập nhật sẽ xuất hiện ngay lập tức ở mọi nơi; có thể sẽ có một độ trễ lan truyền ngắn.
Điểm cuối webhook: Sự kiện không đồng bộ
Các sự kiện sau đây được gửi không đồng bộ đến điểm cuối webhook của bạn:
- Tin nhắn đến từ người dùng: Nền tảng RCS for Business sẽ gửi tin nhắn đến từ 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 của 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 hết hạn và thu hồi tin nhắn: Nền tảng RCS for Business gửi các sự kiện để xác nhận xem một tin nhắn đã hết hạn có được thu hồi thành công hay không.