將您的工具連結至 Influence 發布流程

透過 Influence 的 API 與 MCP 工具儲存草稿、檢視貼文,並排程已核准的發布作業。也可使用相同工具取得已連結的社群帳號與已記錄的發布結果。

憑證、核准與交付狀態

以限定權限的憑證控管存取

僅選擇用戶端需要的權限。Influence 會在每次操作時檢查工作區所有權與存取權。各工具會指定是否需要確認,並由伺服器強制執行。

核准確切的發布操作

執行前,先檢視社群帳號、內容、媒體與時間。若有重大變更,必須重新審核並取得新的核准;已核准的作業才會進入 Influence 排程器。

查看交付狀態

使用傳回的識別碼查詢各則貼文。「已排程」表示等待交付;「已發布」才確認已送出。「待檢視」表示結果不確定,必須先釐清,才能再次傳送。

透過 MCP 讀取已連結的社群帳號

這段 Node.js 範例會連線至 Influence,列出工作區中的社群帳號。它只會讀取社群帳號資料,不會建立草稿或發布貼文。

1. 建立具讀取權限的金鑰

在「設定」中開啟 應用程式與自動化 → 開發工具。選取 讀取已連結的社群帳號(integrations:read),取消其他所有權限,再建立 API 金鑰。以 INFLUENCE_API_TOKEN 的名稱存入本機機密儲存區或環境變數。金鑰只會顯示 1 次,不要放入原始碼檔案或聊天內容。

開啟 API 金鑰設定

2. 執行範例

安裝 Node.js 與 npm 後,在專案中安裝 MCP SDK。將下方程式碼儲存為 accounts.mjs,接著在已設定 INFLUENCE_API_TOKEN 的環境中執行 node accounts.mjs。SDK 會處理 MCP 連線與初始化。

npm install @modelcontextprotocol/client@2.3.1

accounts.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. 讀取回應

這是使用虛構社群帳號名稱與 ID 的回應範例。實際回應會識別您的工作區及其已連結的社群帳號。

{
  "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"
}

結果代表什麼

已傳回社群帳號

使用 connectionId 識別各社群帳號。eligible、supportsText、supportsImage 與 supportsVideo 說明目前的貼文發布能力;準備貼文前,請重新檢查這些值。

未傳回任何社群帳號

ok: true、items: [] 與 done: true 代表讀取成功。請在 workspaceName 顯示的工作區中連結社群帳號,再重新執行範例。

結果分成多頁

done 為 false 時,請用傳回的 cursor,搭配相同的 limit,再次呼叫 accountList。持續讀取,直到 done 為 true;第 1 頁可能不到 20 個社群帳號。

存取遭拒

若收到 401 回應,請檢查金鑰是否仍有效,且具備 integrations:read 權限。API 金鑰缺少權限範圍時,也可能傳回 401。OAuth 連線則可能傳回 403 insufficient_scope;請重新連線並核准讀取社群帳號的權限。

ChatGPT 與 Claude 可透過瀏覽器授權連線,不必使用金鑰。依照助理的設定指南完成設定後,再請它列出已連結的社群帳號。上方範例使用完整 MCP 端點 https://influence.so/api/mcp;Claude 核心連接器則有自己的設定方式。

查看工具及其必要權限

GET /api/v1/tools 會列出此金鑰可用的工具。這項請求會擷取 accountList 的權限與確認要求。建立草稿則需要額外的寫入權限。

HTTP API

GET /api/v1/tools

您的應用程式會讀取工具目錄,並呼叫可用的工具。

MCP

tools/list

支援的助理可探索工具,並遵循相同的審核流程。

Influence
  1. 1. 準備草稿

    使用工作區中的社群帳號與媒體呼叫 campaignDraftSave。保留版本與請求識別資訊,以便在回應中斷時復原。草稿寫入需要伺服器確認。

  2. 2. 準備審核內容

    針對已儲存的版本與動作呼叫 campaignReview。要求核准前,先顯示社群帳號、內容、媒體、設定、時間與到期時間。

  3. 3. 執行已核准的動作

    必須先核准該份審核內容,才能呼叫 campaignReviewExecute。純文字貼文需要針對完整審核內容給予新的回覆;含媒體的貼文則須在看過媒體後核准。伺服器會把動作交給持久化排程器,而非直接呼叫服務供應商。

  4. 4. 重試前先讀取結果

    讀取各社群帳號的狀態,並在有發布連結時查看連結。結果未明的傳送會維持「待檢視」,直到結果釐清。建立另一則貼文前,先復原原有請求,否則可能重複傳送。

為工具選擇連線方式

Influence: 為工具選擇連線方式
連線方式適用情境存取方式
HTTP API您的應用程式會讀取工具目錄,並呼叫可用的工具。使用存於環境變數且已限定權限範圍的 Bearer 憑證。
MCP支援的助理可探索工具,並遵循相同的審核流程。依照 Influence「設定」中對應助理的步驟完成設定。能否使用取決於執行平台與已授予的權限。

工具目錄查詢

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}]}'

工具目錄欄位範例

{
  "tools": [
    {
      "confirmation": "none",
      "mutability": "read",
      "name": "accountList",
      "scopes": [
        "integrations:read"
      ]
    }
  ]
}

這些範例欄位來自工具定義。實際可用的操作取決於目前的工具目錄、憑證權限範圍和已連結的社群帳號。

藍色線材連接著相片卡片托盤、方塊、印章、行事曆和封好的信封。

可以建立的發布工作流程

從自有內容流程產生貼文

在自有工具中,依文章、更新紀錄或社群公告準備草稿。先呈現確切的社群帳號、內容與時間供檢視,再請 Influence 排程發布。

找回未收到回應的請求結果

保留原始請求與冪等鍵,再查詢結果。傳送結果不確定時,狀態會維持「待檢視」,直到能確認發生了什麼事。另建替代請求可能讓同一貼文發布 2 次。

用 Influence IQ 擬出初稿

提供文章、專案筆記或社群近況,以及已儲存的品牌指南,讓 Influence IQ 擬出可編輯的草稿。可用且已獲授權的 AI 工具會使用 IQ 點數,原有的確認要求仍然適用。

提供筆記與已儲存的品牌指南,讓 Influence IQ 擬出可編輯的貼文並建議日期。擬稿與圖片生成都會使用 IQ 點數。開始生成圖片前,先確認點數報價;發布前,再檢查完成的內容。

瞭解 Influence IQ

從 AI 助理開始

透過支援的 Influence 連線,您可以在 ChatGPT 或 Claude 中規劃行銷活動並修改草稿。請助理上傳它能存取的圖片與影片,或重用 Influence 中已就緒的媒體。若助理無法存取檔案,請先在 Influence 上傳。檢視確切的社群帳號、文字、媒體、設定與時間。看過完整審核內容後,再透過支援的對話內卡片核准,或以新訊息回覆「核准」。使用 TikTok Direct 時,先在對話中告知發布選擇並表示同意,再核准更新後的審核內容。審核卡片並非必要。前往「設定」查看設定方式與連線狀態。

發布至已連結的社群帳號

選擇工作區可用的社群帳號,為每個發布目的地編輯文字與支援的媒體,並在發布前檢查貼文。

準備下一批貼文

加入社群帳號、準備貼文,並選擇日期。排程前,先檢查內容。

開始使用

常見問題

API 與 MCP 工作流程能做什麼?
依已啟用的工具與您的權限,API 或 MCP 用戶端可處理已連結社群帳號、已儲存草稿、支援的媒體、貼文審核、排程與交付狀態。
API 或 MCP 呼叫會略過核准嗎?
不會。伺服器會強制執行各工具的確認要求。發布必須取得目前審核內容的核准;安排交付前,執行流程會檢查工作區、權限、社群帳號與內容。
助理工作流程接受哪些媒體?
請助理上傳它能存取的圖片與影片,或重用 Influence 中已就緒的媒體。若助理無法存取檔案,請先在 Influence 上傳。檢視確切的社群帳號、文字、媒體、設定與時間。看過完整審核內容後,再透過支援的對話內卡片核准,或以新訊息回覆「核准」。使用 TikTok Direct 時,先在對話中告知發布選擇並表示同意,再核准更新後的審核內容。審核卡片並非必要。
未收到回應或傳送結果不確定時,該怎麼處理?
找回原始請求的結果,並查看已記錄的狀態。不要重送結果不明的作業。在核對並證實結果之前,「待檢視」狀態都仍未解決。
支援 MCP 就代表每個助理平台都能使用嗎?
不代表。登入後,前往「設定」→「應用程式與自動化」→「連結助理」,查看設定說明與目前的連線狀態。
整合工具可以編輯已排程或已發布的貼文嗎?
若尚未開始交付,且沒有結果未釐清的傳送作業,已排程貼文可退回草稿,供編輯並重新審核。助理無法編輯或刪除已在社群平台發布的內容。