IOSOR Kiến thức

Nhúng API so với cổng thông tin đối tác nhãn trắng

Các sản phẩm SaaS nhúng tin nhắn sẽ ở lại trên bề mặt ISV. Cổng thông tin đối tác nhãn trắng nằm dưới Partner — không trộn lẫn thương hiệu, khóa và quyền sở hữu vận hành.

Khi một sản phẩm SaaS nhúng dịch vụ tin nhắn, người dùng cuối không bao giờ mở bảng điều khiển IOSOR. Họ nhấp vào Gửi bên trong UI của ISV; ISV sở hữu các khóa, webhook và sổ cái trả trước. Con đường đó là nhúng (embed). Cổng thông tin đối tác nhãn trắng thì khác: quản trị viên đối tác hoạt động dưới các bề mặt Partner — UI an toàn thương hiệu, cách ly đa người dùng và cổng bề mặt không bao giờ rò rỉ tên hạ tầng.

Các đội ngũ thường làm lẫn lộn hai khái niệm này: ảnh chụp màn hình đối tác trong tài liệu ISV, hoặc các lỗi có giao diện giống IOSOR bên trong sản phẩm SaaS. Nhúng có nghĩa là sản phẩm của bạn là giao diện duy nhất hướng tới khách hàng. Đối tác có nghĩa là một cổng thông tin mang thương hiệu cho đại lý — vẫn là nhãn trắng và được kiểm soát, nhưng có bản đồ quyền sở hữu khác. Hãy chọn một giao diện cho tuần đầu tiên.

Việc nhúng giữ tin nhắn bên trong sản phẩm SaaS

Cấu hình nhúng đặt các khóa API, khóa trùng lặp (idempotency keys) và bộ thu webhook dưới tổ chức kỹ thuật của ISV. Các hành động của người dùng cuối ánh xạ tới việc gửi từ phía máy chủ với ví trả trước của ISV.

Cổng thông tin đối tác vẫn là một bề mặt nhãn trắng riêng biệt

Cổng thông tin đối tác phục vụ các quản trị viên đại lý, những người quản lý người dùng phụ, tỷ lệ chia sẻ và xuất dữ liệu an toàn thương hiệu. Các màn hình tuân theo các cổng bề mặt Partner: không có thương hiệu hạ tầng trong thông báo, lỗi API, webhook hoặc cột CSV. Danh mục trực tiếp vẫn khớp với kho lưu trữ. Quản trị viên đối tác không phải là người dùng cuối của ISV.

Phân chia quyền sở hữu: giao diện sản phẩm và giao diện đối tác

Quyết định Nhúng Cổng thông tin đối tác
Ai nhìn thấy UI Người dùng cuối ISV Quản trị viên đối tác
Khóa lưu tại Bảo mật ISV Kho vận hành theo thiết kế
Ngôn ngữ thương hiệu Văn bản sản phẩm SaaS Văn bản đối tác nhãn trắng
Chủ sở hữu sổ cái Tài khoản trả trước ISV Cùng tài kho.

Từ chối các bản demo kết hợp trộn lẫn đường hướng thương hiệu

Nút gửi trên SaaS cùng với ảnh chụp màn hình cổng đối tác trên một trang trình chiếu sẽ huấn luyện người mua kỳ vọng sai giao diện. Nếu người mua nhúng OTP vào ứng dụng của họ, hãy demo phần nhúng và chỉ giữ các bài viết về Đối tác dưới dạng thông tin bổ sung.

Các đường hướng vận hành liên quan

Bắt đầu với IOSOR

Cấu hình bộ thu webhook của sản phẩm trong bảng điều khiển dưới kho bí mật ISV, giữ các khóa API tuyệt đối trên máy chủ backend của bạn. Kiểm soát cổng giao diện đối tác trước khi cấp quyền quản trị cho đại lý để đảm bảo không rò rỉ thương hiệu thượng nguồn vào tải trọng DLR hoặc tệp xuất CSV. Giữ giao diện sản phẩm và giao diện đối tác tách biệt ở cả môi trường thử nghiệm và sản xuất.

Điểm chính IOSOR

Việc tích hợp nhắn tin qua API giúp lưu lượng truy cập của người dùng cuối và trạng thái hoạt động nằm hoàn toàn bên trong giao diện sản phẩm SaaS của bạn, vận hành bằng khóa phía máy chủ từ đội ngũ kỹ thuật. Đồng thời, cổng thông tin đối tác nhãn trắng chỉ dành cho quản trị viên đại lý quản lý cấu trúc công ty con, phân phối cước phí và xuất dữ liệu cách ly thương hiệu mà không làm lộ chi tiết hạ tầng thượng nguồn.

Nên cô lập các khóa API, bộ thu webhook và việc hiển thị trạng thái bên trong mã nguồn sản phẩm chính. Không trình bày bản demo bán hàng kết hợp hoặc trộn lẫn giao diện quản trị đối tác với luồng nhắn tin gốc của sản phẩm, vì việc xóa nhòa các ranh giới này sẽ tạo ra rò rỉ thương hiệu và làm sai lệch quản trị khách thuê.

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

Hướng dẫn liên quan