Market > Zalo Sandbox
Zalo Sandbox là plugin dành cho EzyPlatform, cung cấp môi trường mô phỏng các luồng phổ biến của Zalo Official Account (OA) ngay trên hệ thống phát triển. Plugin giúp lập trình viên xây dựng, kiểm thử và trình diễn tích hợp Zalo OA mà không cần kết nối đến tài khoản OA hoặc hạ tầng Zalo thật.
Tính năng nổi bật
- Mô phỏng luồng OAuth 2.0 và PKCE để cấp authorization code, access token và refresh token.
- Cung cấp API gửi tin nhắn chăm sóc khách hàng và tin nhắn template.
- Hỗ trợ lấy danh sách và thông tin chi tiết người dùng OA thử nghiệm.
- Upload hình ảnh và sử dụng attachment trong nội dung tin nhắn.
- Phát webhook thử nghiệm với chữ ký SHA-256 tương tự luồng tích hợp thực tế.
- Giả lập mã lỗi gửi tin nhắn để kiểm tra retry, cảnh báo và xử lý ngoại lệ.
- Tích hợp Swagger/OpenAPI để tra cứu và thử các API được hỗ trợ.
- Quản lý App ID, secret key, token, callback URL và webhook URL trực tiếp trong trang quản trị.
- Quản lý người dùng OA và theo dõi lịch sử tin nhắn.
- Cung cấp giao diện chat mô phỏng cả phía OA và phía người dùng.
- Hỗ trợ tin nhắn văn bản, emoji, hình ảnh, video và tệp đính kèm.
- Cho phép người dùng thử nghiệm đăng ký, đăng nhập và trò chuyện trực tiếp với nhau.
Lợi ích
Zalo Sandbox giúp đội phát triển kiểm tra toàn bộ luồng giao tiếp hai chiều:
- Ứng dụng gọi API OA để xác thực, đồng bộ người dùng, upload ảnh và gửi tin nhắn.
- Sandbox gửi webhook ngược về ứng dụng để kiểm tra tiếp nhận sự kiện và xác minh chữ ký.
- Kết quả tin nhắn có thể được quan sát ngay trên giao diện web hoặc trang quản trị.
- Các tình huống thành công và thất bại đều có thể tái hiện trong môi trường kiểm thử chủ động.
Plugin đặc biệt hữu ích cho phát triển cục bộ, kiểm thử tích hợp, trình diễn sản phẩm và đào tạo kỹ thuật khi chưa có tài khoản Zalo OA thật hoặc không muốn tạo dữ liệu thử nghiệm trên hệ thống production.
API được mô phỏng
Phiên bản hiện tại tập trung vào các nhóm chức năng thường dùng:
- Cấp quyền và lấy access token theo luồng OAuth/PKCE.
- Làm mới access token bằng refresh token.
- Gửi tin nhắn chăm sóc khách hàng.
- Gửi tin nhắn template theo số điện thoại.
- Lấy danh sách người dùng OA.
- Lấy thông tin chi tiết người dùng OA.
- Upload hình ảnh để sử dụng trong tin nhắn.
Quản trị và giao diện thử nghiệm
Khu vực quản trị cho phép:
- Thiết lập thông tin ứng dụng và khóa bảo mật.
- Quản lý token cùng thời gian hết hạn.
- Khai báo danh sách callback URL và webhook URL được phép.
- Thêm tài khoản EzyPlatform làm người dùng OA thử nghiệm.
- Xem thông tin và lịch sử trò chuyện của người dùng.
- Chủ động gửi webhook với nhiều loại sự kiện.
- Cấu hình mã lỗi giả lập riêng cho từng loại tin nhắn.
Plugin web đi kèm giao diện chat giúp lập trình viên đóng vai cả OA và người dùng Zalo, gửi tin qua lại, upload media và quan sát luồng webhook mà không cần tự xây dựng công cụ kiểm thử riêng.
Lưu ý
Zalo Sandbox mô phỏng có chọn lọc một số API và hành vi thường dùng của Zalo OA. Đây không phải sản phẩm chính thức của Zalo và không thay thế hoàn toàn môi trường Zalo OA thật.
Dữ liệu người dùng, tin nhắn, media và token được quản lý trong EzyPlatform. Plugin không kết nối đến máy chủ Zalo để xác minh dữ liệu, đồng thời không mô phỏng đầy đủ các quy tắc như giới hạn tần suất, cửa sổ nhắn tin hoặc toàn bộ vòng đời attachment.
Khuyến nghị sử dụng plugin trong môi trường phát triển, kiểm thử hoặc trình diễn; không nên coi đây là cổng Zalo OA production.