Cơ sở kiến thức GetMyBot

Bắt đầu nhanh API

Cho chương trình lấy danh sách bot và tạo phản ứng: token truy cập, yêu cầu đầu tiên và ví dụ curl.

Trên trang này

API cho phép chương trình của bạn làm việc với GetMyBot: lấy danh sách bot, tạo phản ứng hoặc đọc dữ liệu. Ví dụ này dành cho người viết tích hợp. Để thiết lập bot bằng giao diện, xem hướng dẫn bắt đầu.

Trước tiên, tạo token cá nhân để truy cập. Sau đó gửi yêu cầu HTTP tới địa chỉ của thao tác, gọi là điểm API. Các lệnh curl bên dưới chạy trong terminal. Hãy thay https://your-domain bằng địa chỉ cài đặt GetMyBot của bạn.

Bước 1. Tạo token cá nhân

Mở mục token cá nhân trong trang quản trị và tạo token mới (PAT). Sao chép ngay: giá trị chỉ hiện một lần và bắt đầu bằng mbp_. Khi tạo, chọn phạm vi truy cập (scopes) chỉ cho những thao tác cần dùng. Xem hướng dẫn xác thực.

Bước 2. Địa chỉ cơ sở và định dạng

Các điểm REST nằm dưới tiền tố /api; đường dẫn thông thường không có số phiên bản. Nội dung yêu cầu và câu trả lời là JSON. Với yêu cầu có nội dung, gửi header Content-Type: application/json. Gửi token qua Authorization: Bearer <TOKEN_CÁ_NHÂN>: thay cả phần trong dấu ngoặc góc bằng toàn bộ token, gồm tiền tố mbp_. Không thêm tiền tố lần nữa.

Bước 3. Yêu cầu đầu tiên — danh sách bot

Kiểm tra token bằng yêu cầu danh sách bot của bạn. Cần scope bots:read (hoặc *):

curl -H "Authorization: Bearer <TOKEN_CÁ_NHÂN>" https://your-domain/api/bots

Phản hồi sẽ là mảng JSON các bot. Nếu token sai hoặc hết hạn — sẽ trả về 401 với nội dung {"error":"..."} (xem lỗi).

Bước 4. Thay đổi đầu tiên: tạo phản ứng

Yêu cầu này thay đổi dữ liệu bằng cách tạo phản ứng cho bot đã chọn. Chỉ chạy trên dự án thực sự cần phản ứng đó. Bạn cần phạm vi reactions:write; thay BOT_ID bằng ID bot từ bước 3:

curl -X POST https://your-domain/api/bots/BOT_ID/reactions \
  -H "Authorization: Bearer <TOKEN_CÁ_NHÂN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Xin chào","trigger":{"type":"command","value":"/start"}}'

Phản hồi thành công sẽ trả về phản ứng đã tạo với id của nó. Xem các trường nội dung chính xác trong tài liệu tham khảo tương tác — nó tạo sẵn ví dụ trên curl, JavaScript và Python cho từng endpoint.

Bước 5. Tiếp tục — theo tài liệu tham khảo

Khi token hoạt động, phần còn lại thuận tiện hơn để khám phá trong tài liệu tham khảo tương tác: ở đó có danh sách đầy đủ endpoint, scopes cần thiết, schema nội dung và nút "Try it".

Yêu cầu Managed AI đầu tiên

Tạo PAT với phạm vi managed_ai:invoke. Idempotency-Key giúp phân biệt một thao tác với thao tác khác: khi thử lại cùng yêu cầu, giữ nguyên khóa và nội dung; với thao tác mới, dùng khóa mới.

curl -X POST https://your-domain/api/v1/ai/responses \
  -H "Authorization: Bearer <TOKEN_CÁ_NHÂN>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ai-demo-0001" \
  -d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Tóm tắt ngắn cuộc trò chuyện"}]}],"max_output_tokens":300}'

Nếu tích hợp của bạn hiển thị tính năng Managed AI hoặc Meta, hãy gọi /api/public/capabilities trước. Câu trả lời cho biết tính năng có được bật trên cài đặt này hay không. Nếu không được bật, hãy ẩn tính năng hoặc hiển thị trạng thái chưa khả dụng.

Tiếp theo