Selfomy cung cấp GraphQL API để bạn có thể tích hợp vào các hệ thống của bên thứ ba để thực hiện đọc và cập nhật dữ liệu trên Selfomy One. Chẳng hạn: đồng bộ thông tin học viên mới từ phần mềm quản lý khách hàng (CRM) sang Selfomy One để tạo học viên và ghi danh học viên vào lớp. Ngoài ra, bạn có thể gửi hướng dẫn cho các mô hình AI như ChatGPT, Claude, Gemini,... và yêu cầu AI thực hiện các tác vụ bạn mong muốn.
Bạn nên gửi hướng dẫn này cho đội ngũ kỹ thuật/lập trình của công ty. Nếu công ty bạn không có đội ngũ kỹ thuật, chúng tôi cung cấp dịch vụ tích hợp hệ thống với chi phí hợp lý. Vui lòng liên hệ chúng tôi để được tư vấn.
Lấy Personal Access Token
Bạn cần lấy Personal Access Token (PAT) để có thể thực hiện bất kỳ thao tác nào trên GraphQL API. Xin hãy lưu ý, PAT được tạo sẽ gắn liền với tài khoản đang đăng nhập, đồng nghĩa với việc nếu tài khoản của bạn có quyền gì thì khi truy cập thông qua GraphQL API cũng sẽ có quyền đó.
Hiện tại PAT có thời hạn sử dụng vĩnh viễn, vì vậy vui lòng cẩn trọng và không tiết lộ PAT với bất kỳ ai. Chúng tôi sẽ bổ sung phương thức để xóa PAT trong thời gian tới.
Để lấy PAT, truy cập trên trình duyệt vào địa chỉ: https://one.selfomy.com/api/user/create-token
Bạn sẽ thấy phản hồi có định dạng như sau (tích Pretty-print nếu có để dễ đọc hơn):
{"access_token":"9852|gnlqweuiPIgqyop0PiXkRz2xz7tgqwr5","token_type":"Bearer","user":{"id":98915,"uuid":"203a0dd1-b7ga-414f-bb7b-agdd1c96238e","selfomy_id":null,"name":"Test User","email":"[email protected]","phone":null,"address":null,"locale":"vi","email_verified_at":"2025-03-24T16:42:09.000000Z","two_factor_confirmed_at":null,"profile_photo_path":null,"is_view_all_branch":0,"deleted_at":null,"created_at":"2023-02-12T16:58:56.000000Z","updated_at":"2025-05-26T08:25:11.000000Z","current_branch_id":62,"current_company_id":98712,"external_profile_photo_url":null,"company_id":null,"username":null,"profile_photo_url":"https:\/\/ui-avatars.com\/api\/?name=T+U&color=7F9CF5&background=EBF4FF"}}
Hãy lấy giá trị của trường “access_token” và lưu lại (không lấy hai dấu ngoặc kép).
Tương tác với hệ thống bằng mô hình AI
Tính năng này cho phép bạn sử dụng các mô hình AI như OpenClaw, Codex, Claude Code, Gemini Antigravity,... để tương tác với hệ thống bằng những câu lệnh như: "Hãy cho tôi 5 lượt nộp bài gần nhất của học sinh". Không hỗ trợ giao diện chat thông thường của ChatGPT, Claude, Gemini,...
LƯU Ý: Các mô hình AI mà bạn sử dụng có thể phạm sai lầm và gây mất mát hoặc thay đổi dữ liệu theo hướng không mong muốn, vui lòng yêu cầu AI lên kế hoạch từng bước và kiểm tra từng bước trước khi thực hiện.
Để bắt đầu, trước tiên hãy ra lệnh cho AI như sau:
Bạn là một trợ lý giúp tương tác ứng dụng LMS quản lý học tập cho trung tâm dạy học thông qua GraphQL API.
Đây là GraphQL endpoint: https://one.selfomy.com/graphql, hãy đọc docs rồi nhận các truy vấn của tôi và thực hiện các truy vấn với API để đạt được yêu cầu của tôi.
Trong một số trường hợp, bạn sẽ cần thực hiện nhiều truy vấn khác nhau để thu thập đủ các dữ liệu đầu vào cần thiết, hãy suy luận từng bước một.
Đối với các thao tác yêu cầu có thay đổi dữ liệu hoặc xoá dữ liệu, vui lòng lên kế hoạch và hỏi tôi để để tôi kiểm duyệt từng bước một, chỉ thực hiện khi đã được tôi đồng ý.
Nếu câu lệnh của tôi không thể thực hiện, vui lòng cho tôi biết.
Từ đó, bạn có thể ra lệnh cho AI thực hiện các thao tác mong muốn.
Sử dụng GraphQL API
GraphQL Client
Bạn có thể sử dụng bất kỳ GraphQL client nào để khai thác GraphQL API.
Selfomy có cung cấp sẵn một GraphQL Client để bạn sử dụng tại đây. Ngoài ra, Altair GraphQL Client là một trong số các client miễn phí có phiên bản web, MacOS lẫn Windows.
Hướng dẫn dưới đây sẽ dựa trên phiên bản web có trên Selfomy này, tuy nhiên các GraphQL Client khác cũng có giao diện tương tự.
Đăng nhập
Nếu bạn dùng client trên Selfomy:
Tại tab Headers ở bên dưới khung nhập truy vấn, nhập nội dung như sau:
{
"Authorization": "Bearer <Nhập mã Personal Access Token của bạn>"
}
Sau đó bạn đã có thể bắt đầu truy vấn, thử với truy vấn đơn giản như sau giúp lấy thông tin người dùng hiện tại:
query {
me {
uuid
name
email
profilePhotoUrl
}
}
Nếu bạn thấy thông tin người dùng được trả về nghĩa là bạn đã đăng nhập thành công
Nếu bạn dùng client của bên thứ ba:
Đầu tiên nhập endpoint là: https://one.selfomy.com/graphql
Trong trường hợp bạn không thấy tab
Sau đó chọn tab Auth và điền:
-
Auth type: Bearer Token
-
Bearer token: Chính là PAT (Personal Access Token) bạn đã tạo trước đó
Sau đó bạn đã có thể bắt đầu truy vấn, thử với truy vấn đơn giản như sau giúp lấy thông tin người dùng hiện tại:
query {
me {
uuid
name
email
profilePhotoUrl
}
}
Nếu bạn thấy thông tin người dùng được trả về nghĩa là bạn đã đăng nhập thành công
Xem tài liệu
Để xem các Query, Mutation, Type có sẵn trên hệ thống, hãy tìm tabs Docs hay Documentation có trên Client của bạn.
