RM Platform API
Tài liệu hướng dẫn đưa khung chat AI của RM Platform vào sản phẩm của bạn — bằng cách nhúng vào website hoặc cho người dùng đăng nhập sẵn (SSO).
1. Môi trường
RM Platform cung cấp môi trường riêng cho phát triển/thử nghiệm và production. URL nền tảng (gọi là PLATFORM_URL trong toàn bộ tài liệu) là địa chỉ gốc cho mọi đường dẫn nhúng và xác thực.
| Môi trường | URL nền tảng (PLATFORM_URL) | Mục đích |
|---|---|---|
| Development | https://app.simplize.dev | Phát triển và thử nghiệm tích hợp. |
| Production | Sẽ cung cấp sau | Sử dụng trong ứng dụng thực tế. |
URL production sẽ được Simplize cung cấp sau. Trước đó, vui lòng sử dụng môi trường Development.
Thông tin Simplize cung cấp
Trên môi trường Development, Simplize sẽ cung cấp sẵn cho bạn các thông tin sau:
| Thông tin | Mô tả | Bí mật? | Dùng cho |
|---|---|---|---|
| PLATFORM_URL | URL nền tảng (ví dụ https://app.simplize.dev) | Không | Mọi đường dẫn nhúng và xác thực |
| Access token | Định danh công khai của ứng dụng chat | Không | Nhúng khung chat, trang chat |
| client_id | Định danh connection dùng cho SSO | Không | Đăng nhập SSO |
| client_secret | Khóa ký assertion, chỉ giữ ở server | Có | Đăng nhập SSO |
Chỉ client_secret là thông tin bí mật — tuyệt đối không đưa xuống FE hay commit vào mã nguồn. Các thông tin còn lại là định danh công khai, có thể để ở phía client.
2. Khái niệm cơ bản
| Khái niệm | Ý nghĩa |
|---|---|
| Ứng dụng chat | Trợ lý AI bạn tạo trên Portal. |
| Access token | Chuỗi công khai định danh ứng dụng, giúp nền tảng biết hiển thị đúng ứng dụng nào. Lấy tại trang ứng dụng trong Portal. |
3. Đưa khung chat vào sản phẩm
Bạn không cần tự dựng giao diện. Có hai cách phổ biến:
- Bong bóng chat — nút nổi ở góc màn hình, bấm để mở khung chat.
- Trang chat toàn màn hình — mở qua đường dẫn hoặc nhúng bằng iframe.
Xem hướng dẫn từng bước ở Nhúng vào trang web.
4. Tự động đăng nhập người dùng
Cho người dùng đã đăng nhập ở hệ thống của bạn vào thẳng khung chat mà không phải đăng nhập lại. Xem Tích hợp đăng nhập (SSO).