Kết nối công cụ của bạn với quy trình đăng bài Influence
Dùng API và công cụ MCP của Influence để lưu bản nháp, xem lại bài và lên lịch đăng đã được phê duyệt. Truy xuất tài khoản đã kết nối và kiểm tra kết quả đăng được ghi nhận qua cùng công cụ.
Thông tin xác thực, phê duyệt và trạng thái gửi
Giới hạn truy cập bằng thông tin xác thực có phạm vi quyền
Phê duyệt chính xác thao tác đăng
Đọc trạng thái gửi
Đọc tài khoản đã kết nối bằng MCP
Ví dụ Node.js này kết nối với Influence và liệt kê tài khoản mạng xã hội trong không gian làm việc của bạn. Ví dụ đọc thông tin tài khoản mà không tạo bản nháp hay đăng bài.
1. Tạo khóa có quyền đọc
Trong Cài đặt, mở Ứng dụng và tự động hóa → Công cụ dành cho nhà phát triển. Chọn Đọc các kênh đã kết nối (integrations:read), bỏ chọn mọi quyền khác, rồi tạo khóa API. Lưu khóa trong kho bí mật cục bộ hoặc biến môi trường dưới tên INFLUENCE_API_TOKEN. Khóa chỉ hiển thị 1 lần; không đưa vào tệp nguồn hay cuộc trò chuyện.
Mở cài đặt khóa API2. Chạy ví dụ
Khi đã cài Node.js và npm, cài MCP SDK trong dự án. Lưu mã dưới đây thành accounts.mjs, rồi chạy node accounts.mjs trong môi trường đã đặt INFLUENCE_API_TOKEN. SDK xử lý việc kết nối và khởi tạo MCP.
npm install @modelcontextprotocol/client@2.3.1accounts.mjs
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");
const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
new URL("https://influence.so/api/mcp"),
{ requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);
try {
await client.connect(transport);
const result = await client.callTool({
name: "accountList",
arguments: { limit: 20 }
});
console.log(JSON.stringify(result.structuredContent, null, 2));
if (result.isError) process.exitCode = 1;
} finally {
await client.close();
}3. Đọc phản hồi
Phản hồi ví dụ có tên tài khoản và ID hư cấu. Phản hồi thực tế xác định không gian làm việc và các tài khoản mạng xã hội đã kết nối.
{
"ok": true,
"output": {
"cursor": null,
"done": true,
"items": [
{
"connectionId": "account_example_01",
"eligible": true,
"name": "Example studio",
"platform": "bluesky",
"supportsImage": true,
"supportsText": true,
"supportsVideo": true
}
],
"workspaceId": "workspace_example_01",
"workspaceName": "Example workspace"
},
"toolName": "accountList"
}Ý nghĩa của kết quả
Tài khoản được trả về
Dùng connectionId để xác định từng tài khoản. eligible và supportsText, supportsImage, supportsVideo mô tả khả năng đăng hiện tại; kiểm tra lại trước khi chuẩn bị bài.
Không có tài khoản được trả về
ok: true cùng items: [] và done: true là lần đọc thành công. Kết nối tài khoản mạng xã hội trong không gian làm việc được workspaceName nêu, rồi chạy lại ví dụ.
Kết quả có nhiều trang
Khi done là false, gọi lại accountList với cursor được trả về và cùng limit. Tiếp tục đến khi done là true; trang đầu có thể có ít hơn 20 tài khoản.
Quyền truy cập bị từ chối
Với phản hồi 401, kiểm tra khóa còn hiệu lực và có quyền integrations:read. Thiếu phạm vi quyền cũng có thể trả về 401 khi dùng khóa API. Kết nối OAuth có thể trả về 403 insufficient_scope; kết nối lại và phê duyệt quyền đọc tài khoản.
ChatGPT và Claude có thể kết nối qua cấp quyền trên trình duyệt thay vì khóa. Dùng hướng dẫn thiết lập của trợ lý, rồi yêu cầu liệt kê tài khoản đã kết nối. Ví dụ ở trên dùng điểm cuối MCP đầy đủ, https://influence.so/api/mcp; trình kết nối cốt lõi của Claude có cách thiết lập riêng.
Xem công cụ và quyền cần có
GET /api/v1/tools liệt kê công cụ có sẵn cho khóa của bạn. Yêu cầu này lọc ra thông tin về quyền và yêu cầu xác nhận của accountList. Tạo bản nháp cần thêm quyền ghi.
HTTP API
GET /api/v1/toolsỨng dụng đọc danh mục và gọi các công cụ có sẵn.
MCP
tools/listTrợ lý được hỗ trợ tìm các công cụ và làm theo cùng quy trình xem lại.
1. Chuẩn bị bản nháp
Gọi campaignDraftSave với tài khoản và nội dung đa phương tiện từ không gian làm việc. Giữ phiên bản và định danh yêu cầu để khôi phục phản hồi bị gián đoạn. Thao tác ghi bản nháp phải được máy chủ xác nhận.
2. Chuẩn bị bản xem lại
Gọi campaignReview cho phiên bản và thao tác đã lưu. Hiển thị tài khoản, nội dung, ảnh hoặc video, thiết lập, thời gian và hạn hết hiệu lực trước khi yêu cầu phê duyệt.
3. Thực hiện thao tác đã phê duyệt
campaignReviewExecute yêu cầu phê duyệt đúng bản xem lại đó. Bài văn bản cần phản hồi phê duyệt mới sau khi xem đầy đủ bản xem lại; nội dung đa phương tiện cần được phê duyệt sau khi xem trực quan. Máy chủ chuyển thao tác sang bộ lập lịch có lưu trạng thái bền vững thay vì gọi trực tiếp nhà cung cấp.
4. Đọc kết quả trước khi thử lại
Đọc trạng thái từng tài khoản và liên kết bài đã đăng khi có. Lần gửi chưa rõ kết quả vẫn ở trạng thái Cần xem lại cho đến khi xác định được kết quả. Khôi phục yêu cầu hiện có trước khi tạo bài khác, nếu không có thể gửi trùng.
Chọn cách kết nối cho công cụ
| Kết nối | Dùng cho | Quyền truy cập |
|---|---|---|
| HTTP API | Ứng dụng đọc danh mục và gọi các công cụ có sẵn. | Dùng thông tin xác thực Bearer giới hạn phạm vi quyền từ biến môi trường. |
| MCP | Trợ lý được hỗ trợ tìm các công cụ và làm theo cùng quy trình xem lại. | Làm theo hướng dẫn thiết lập trợ lý trong Cài đặt của Influence. Kết nối có sẵn hay không tùy môi trường chạy trợ lý và quyền đã cấp. |
Yêu cầu danh mục
curl --fail-with-body 'https://influence.so/api/v1/tools' \
--header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
| jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'Các trường danh mục ví dụ
{
"tools": [
{
"confirmation": "none",
"mutability": "read",
"name": "accountList",
"scopes": [
"integrations:read"
]
}
]
}Các trường ví dụ này lấy từ định nghĩa công cụ. Danh mục hiện tại, phạm vi quyền của thông tin xác thực và tài khoản đã kết nối quyết định thao tác nào có sẵn.

Quy trình đăng bài bạn có thể xây dựng
Bài đăng từ quy trình nội dung riêng
Chuẩn bị bản nháp từ bài viết, nhật ký thay đổi hoặc thông báo cộng đồng trong công cụ riêng. Hiển thị chính xác tài khoản, nội dung và thời gian để xem lại trước khi yêu cầu Influence lên lịch đăng.
Khôi phục yêu cầu sau khi mất phản hồi
Giữ yêu cầu ban đầu và khóa idempotency rồi tra cứu kết quả của yêu cầu đó. Lần gửi có kết quả chưa rõ vẫn ở trạng thái Cần xem lại cho đến khi xác nhận được điều đã xảy ra. Tạo yêu cầu thay thế có thể đăng cùng bài 2 lần.
Tạo bản nháp đầu tiên với Influence IQ
Cung cấp bài viết, ghi chú dự án hoặc thông báo cộng đồng và Hướng dẫn thương hiệu đã lưu cho Influence IQ để nhận bản nháp có thể chỉnh sửa. Các công cụ AI được cấp quyền có thể dùng sẽ sử dụng tín dụng IQ và vẫn giữ yêu cầu xác nhận.
Cung cấp ghi chú và Hướng dẫn thương hiệu đã lưu cho Influence IQ để nhận bài đăng có thể chỉnh sửa và ngày đăng gợi ý. Việc soạn bản nháp và tạo ảnh sử dụng tín dụng IQ. Xem báo giá tạo ảnh trước khi bắt đầu và xem lại nội dung hoàn chỉnh trước khi đăng.
Khám phá Influence IQBắt đầu với trợ lý AI
Với kết nối Influence được hỗ trợ, bạn có thể lên kế hoạch chiến dịch và chỉnh sửa bản nháp trong ChatGPT hoặc Claude. Yêu cầu trợ lý tải lên ảnh và video mà trợ lý truy cập được hoặc dùng lại tệp đã sẵn sàng từ Influence. Nếu trợ lý không truy cập được tệp, hãy tải tệp lên Influence trước. Xem lại chính xác tài khoản, phần chữ, tệp đa phương tiện, cài đặt và thời gian. Sau khi xem toàn bộ nội dung cần xem lại, hãy phê duyệt qua thẻ được hỗ trợ trong cuộc trò chuyện hoặc gửi câu trả lời mới “đã phê duyệt”. Với TikTok Direct, cung cấp lựa chọn đăng và sự đồng ý trong cuộc trò chuyện, rồi phê duyệt nội dung xem lại đã cập nhật. Thẻ xem lại là tùy chọn. Mở Cài đặt để xem hướng dẫn thiết lập và trạng thái kết nối.
Đăng lên các tài khoản đã kết nối
Chọn tài khoản có thể dùng cho không gian làm việc. Chỉnh phần chữ và tệp đa phương tiện được hỗ trợ cho từng nơi đăng rồi xem lại bài trước khi đăng.
Chuẩn bị các bài tiếp theo
Thêm tài khoản, chuẩn bị bài và chọn ngày. Xem lại nội dung trước khi lên lịch.
Bắt đầuCâu hỏi thường gặp
- Quy trình API và MCP có thể làm gì?
- Tùy công cụ được bật và quyền của bạn, ứng dụng khách API hoặc MCP có thể làm việc với tài khoản đã kết nối, bản nháp đã lưu, tệp đa phương tiện được hỗ trợ, nội dung xem lại, lịch đăng và trạng thái gửi.
- Lệnh gọi API hoặc MCP có bỏ qua phê duyệt không?
- Không. Máy chủ thực thi yêu cầu xác nhận của từng công cụ. Việc đăng yêu cầu phê duyệt nội dung xem lại hiện tại. Khi thực thi, hệ thống kiểm tra không gian làm việc, quyền, tài khoản và nội dung trước khi lên lịch gửi.
- Quy trình trợ lý chấp nhận tệp đa phương tiện nào?
- Yêu cầu trợ lý tải lên ảnh và video mà trợ lý truy cập được hoặc dùng lại tệp đã sẵn sàng từ Influence. Nếu trợ lý không truy cập được tệp, hãy tải tệp lên Influence trước. Xem lại chính xác tài khoản, phần chữ, tệp đa phương tiện, cài đặt và thời gian. Sau khi xem toàn bộ nội dung cần xem lại, hãy phê duyệt qua thẻ được hỗ trợ trong cuộc trò chuyện hoặc gửi câu trả lời mới “đã phê duyệt”. Với TikTok Direct, cung cấp lựa chọn đăng và sự đồng ý trong cuộc trò chuyện, rồi phê duyệt nội dung xem lại đã cập nhật. Thẻ xem lại là tùy chọn.
- Nên xử lý mất phản hồi hoặc lần gửi chưa rõ kết quả thế nào?
- Khôi phục kết quả của yêu cầu ban đầu và kiểm tra trạng thái được ghi nhận. Không lặp lại lần gửi chưa rõ kết quả. Trạng thái Cần xem lại vẫn chưa được giải quyết cho đến khi việc đối soát chứng minh được kết quả.
- Hỗ trợ MCP có bảo đảm mọi ứng dụng trợ lý đều hoạt động không?
- Không. Đăng nhập và mở Cài đặt → Ứng dụng và tự động hóa → Kết nối trợ lý để xem hướng dẫn thiết lập và trạng thái kết nối hiện tại.
- Tích hợp có thể chỉnh sửa bài đã lên lịch hoặc đã đăng không?
- Bài đã lên lịch có thể trở về bản nháp để chỉnh sửa và xem lại lần nữa nếu quá trình gửi chưa bắt đầu và không có lần gửi nào chưa rõ kết quả. Trợ lý không thể chỉnh sửa hoặc xóa nội dung đã đăng trên mạng xã hội.