Làm việc với AI agent qua API
AI agent là một người dùng bình thường được đánh dấu agent. Nó gọi API bằng token, soạn bài và gửi đi. Một người thật vẫn duyệt bài, và nhật ký cho biết thao tác nào do agent thực hiện.
Xem qua video ngắn
Trước khi bắt đầu
- Một người dùng agent trong doanh nghiệp, đã được thêm vào workspace với vai trò Editor. Đội ngũ của chúng tôi tạo người dùng agent, vì vậy hãy gửi email tới [email protected] rồi đăng nhập bằng agent đó.
- Cách gọi API qua HTTPS: curl, một đoạn mã, hoặc công cụ agent như Claude Code hay n8n.
Các bước
-
Bước 1: Mở API tokens
Mở API tokens từ menu chính. Token cho phép agent hoặc ứng dụng di động gọi API với tư cách người sở hữu token, nên hãy đăng nhập bằng người dùng agent trước. Token tạo khi bạn đang đăng nhập bằng tài khoản của mình sẽ đăng bài dưới tên bạn. Nếu không dùng ứng dụng web, gọi POST /api/v1/auth/tokens với email và mật khẩu của agent để nhận token.
-
Bước 2: Tạo token và sao chép
Nhập một tên như "Claude Code agent" rồi nhấn Create token. Token chỉ hiện một lần. Hãy sao chép vào công cụ agent và giữ như mật khẩu. Hình minh họa đã làm mờ token.
-
Bước 3: Kiểm tra người dùng agent và vai trò
Hãy làm bước này trước khi tạo token. Đội ngũ của chúng tôi tạo người dùng agent. Ở trang Team, người dùng này có nhãn agent. Cấp cho agent vai trò Editor ở mỗi workspace cần dùng: agent tạo, sửa bản nháp và gửi duyệt được, nhưng không duyệt hay đăng được.
-
Bước 4: Agent gửi một bài đăng
Agent gọi API bằng token của nó. Với
submit: true, bài vào trạng thái In review và được ghi là do agent tạo. Ví dụ bên dưới là yêu cầu gửi bài.
-
Bước 5: Người thật duyệt bài
Mở bài, kiểm tra caption và bản xem trước rồi nhấn Approve. Sau đó manager lên lịch. Nhật ký Activity ghi agent là người tạo và bạn là người duyệt.
-
Bước 6: Kiểm tra nhật ký hoạt động
Cuộn xuống Activity. Mọi thao tác của agent đều có nhãn agent, nên bạn luôn biết agent đã làm gì và người thật đã làm gì.
Ví dụ: agent gửi một bài đăng
curl -X POST https://app.pulseflowai.com/api/v1/workspaces/2/posts \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Roast day: agent draft",
"caption": "Roast day is Thursday. Pre-order today and we will hold your bag.",
"channelIds": [4, 5],
"scheduledAt": "2026-10-23T09:00",
"submit": true
}'scheduledAt không kèm múi giờ sẽ được hiểu theo múi giờ workspace. submit: true chuyển bài sang In review. 2 là id workspace, 4 và 5 là id kênh; GET /api/v1/workspaces/2/channels liệt kê id của bạn.
Mẹo
- Dùng một token cho mỗi công cụ. Nếu một công cụ bị lộ, chỉ cần thu hồi token của nó trong danh sách.
- Giữ agent ở vai trò Editor để agent soạn và gửi duyệt được nhưng không duyệt hay lên lịch được.
- Phần tổng quan API ở trang tính năng liệt kê những gì agent đọc và ghi được.
Câu hỏi thường gặp
Agent có đăng bài mà không cần người duyệt được không?
Không, với vai trò Editor. Editor tạo, sửa và gửi duyệt. Duyệt cần reviewer hoặc manager, còn lên lịch cần manager.
Đóng trang rồi thì token ở đâu?
Token chỉ hiện một lần và không xem lại được. Hãy tạo token mới và thu hồi token cũ.