IOSOR Kiến thức

Xử lý sự kiện Webhook Just-in-Time Provisioning

Làm chủ vòng đời thời gian thực của các kênh đến bằng webhook JIT của IOSOR. Tự động hóa việc gán số và cập nhật sổ cái cho CPaaS white-label của bạn.

Xử lý sự kiện Webhook Just-in-Time Provisioning.

Hiểu về vòng đời JIT Provisioning

Cấp phát Just-in-Time (JIT) cho phép nền tảng của bạn gán các kênh đến một cách linh hoạt khi nhu cầu phát sinh. Khi người dùng kích hoạt yêu cầu mua, IOSOR phát ra một sự kiện webhook chứa chi tiết số E.164. Sự kiện này báo hiệu rằng kênh đã sẵn sàng để gắn ngay vào logic ứng dụng của bạn, chẳng hạn như gửi OTP hoặc định tuyến SMS. Bằng cách xử lý các sự kiện này trong thời gian thực, bạn loại bỏ nhu cầu quản lý kho thủ công, đảm bảo cơ sở hạ tầng của bạn mở rộng cùng với cơ sở người dùng.

Cấu hình Webhook Endpoint để mở rộng

Để nhận các sự kiện JIT, bạn phải đăng ký một endpoint HTTPS bảo mật trong bảng điều khiển IOSOR. Đảm bảo máy chủ của bạn đã sẵn sàng xác nhận việc nhận bằng mã trạng thái 200 OK trong cửa sổ thời gian chờ nghiêm ngặt. Nếu hệ thống của bạn không phản hồi, nền tảng sẽ thử lại dựa trên chính sách back-off lũy thừa. Điều này đảm bảo rằng sổ cái của bạn vẫn đồng bộ với trạng thái thực tế của các tài sản đã cấp phát, ngăn ngừa sự khác biệt trong thanh toán hoặc tính khả dụng của kênh.

Quản lý số dư trả trước và trạng thái sổ cái

IOSOR hoạt động trên mô hình trả trước, yêu cầu số dư tối thiểu là USD 20 để duy trì các dịch vụ đang hoạt động. Khi một sự kiện JIT kích hoạt, hệ thống sẽ xác minh số dư khả dụng của bạn trước khi hoàn tất việc gán. Nếu chi tiêu hàng tháng của bạn đạt gần USD 1.000/tháng, tài khoản của bạn có thể trải qua quá trình đánh giá nhẹ để đảm bảo tính liên tục của dịch vụ. Luôn theo dõi trạng thái sổ cái để xác nhận rằng MRC cho các số mới được cấp phát được khấu trừ chính xác từ số dư trả trước của bạn.

Xử lý định dạng E.164 và logic DLR

Mỗi payload webhook JIT bao gồm số ở định dạng E.164. Ứng dụng của bạn phải phân tích chuỗi này để ánh xạ kênh tới đúng tài khoản người dùng hoặc dịch vụ. Sau khi số được gán, bạn có thể bắt đầu xử lý lưu lượng, bao gồm thông báo SMS và DLR. Nếu người dùng gửi lệnh STOP, hệ thống của bạn nên lắng nghe sự kiện tương ứng để cập nhật trạng thái kênh, đảm bảo tuân thủ các quy định về nhắn tin và ngăn chặn các khoản phí không cần thiết.

Các giao thức tích hợp thiết yếu

Để duy trì sự tích hợp mạnh mẽ, bạn phải triển khai các thực tiễn quản lý trạng thái và bảo mật cụ thể. Tham khảo tài liệu sau để đảm bảo việc triển khai của bạn tuân thủ các tiêu chuẩn của chúng tôi:

Bắt đầu với IOSOR

Điều hướng đến phần Webhook của bảng điều khiển IOSOR để định cấu hình trình nghe HTTPS cho các sự kiện gán JIT. Đảm bảo máy chủ của bạn xác thực chữ ký webhook và phản hồi bằng HTTP 200 OK trong thời gian chờ. Sau khi định cấu hình, hãy ánh xạ tải trọng E.164 trực tiếp vào logic định tuyến người dùng của bạn để đính kèm các kênh đến một cách linh hoạt.

Điểm chính IOSOR

Việc tự động hóa cấp phát số JIT qua webhook cho phép kích hoạt kênh tức thì mà không bị chậm trễ do thăm dò. Việc xác nhận việc gửi sự kiện ngay lập tức giúp tích hợp của bạn hoạt động bền bỉ dưới lượng tiếp nhận cao, đồng thời vẫn đảm bảo tính minh bạch hoàn toàn đối với kho hàng đã chỉ định.

Nên tách biệt các phản hồi HTTP webhook khỏi quá trình xử lý ứng dụng nội bộ để đảm bảo phản hồi 200 OK nhanh chóng. Không xử lý các tác vụ kéo dài đồng bộ trong cửa sổ thực thi webhook hoặc bỏ qua việc xác minh chữ ký tải trọng.

Hướng dẫn này có hữu ích không?

Hướng dẫn liên quan