登入開始免費試用
easyCoexistence 官方 API

以單一 API 從 Node.js 發布至 Instagram、TikTok 與 Facebook

透過 easyCoexistence,Node.js 或 TypeScript 後端可經由各網絡的官方 API,發布到 Instagram、Facebook、TikTok、YouTube 與 LinkedIn。帳戶只需透過託管連結登入一次;之後每項工作僅需一次 fetch,即可取得 TikTok、YouTube 及 LinkedIn 的新存取權杖,而已簽署的事件會把留言與私訊送到您的路由。以 TypeScript MCP SDK 建構的代理,則會把同一批帳戶視為工具使用。

15 a day

TikTok 發布端點每個帳戶可接受的影片發布,每分鐘最多 6 則。

10 min to 30 days

使用 published false 與 scheduled_publish_time 時,Facebook 專頁貼文可提前多久排程。

x-restli-id

承載新 LinkedIn 貼文 URN 的回應標頭,隨 201 狀態碼送出。

5 minutes

留言建立、刪除或可見度變更後,TikTok 多快觸發 comment.update 事件。

1 hour

Partner API 的連接連結,在工作階段過期前可保持開啟多久。

Node.js 後端如何連接帳戶,並取得其存取權杖?

您的後端會開啟一個連接工作階段,由帳戶擁有人在瀏覽器中完成授權。以 ec_live_ 金鑰作為 bearer 權杖,向 /connect-sessions 發出 POST,並附上 tiktok 或 linkedin 等頻道、redirect_url,以及客戶的 external_ref,即會在 easycoexistence.com 回傳 url。帳戶擁有人在此登入網絡本身的同意畫面,然後以 status=connected 與 channel_id 返回您的 redirect_url;取消的嘗試可在同一連結重試,直至連結於建立後 1 小時過期。

之後每項工作都會以 GET /channels/{id}?credentials=1 開始。回應中包含目前有效的權杖(Instagram 與 Facebook 除外,其權杖從不發出),以及各網絡所需的欄位:Instagram 與 Facebook 為 graph_api_base 與 account_id_on_meta,TikTok 為 api_base 與 business_id,YouTube 為 channel_id,LinkedIn 為 author_urn 與 required_headers。已簽署的 channel.connected、channel.disconnected、channel.removed 與 channel.suspended 事件,會送到您在控制台設定的事件 URL,讓應用程式得知帳戶何時有變。

A connect link and per-job credentials with fetch
const EC = "https://easycoexistence.com/api/v1";
const KEY = { Authorization: `Bearer ${process.env.EC_API_KEY}` }; // ec_live_...

type Network = "instagram" | "facebook" | "tiktok" | "youtube" | "linkedin";

// A hosted sign-in link for one of your customers on one network
export async function connectLink(customerId: string, channel: Network): Promise<string> {
  const r = await fetch(`${EC}/connect-sessions`, {
    method: "POST",
    headers: { ...KEY, "Content-Type": "application/json" },
    body: JSON.stringify({
      channel,
      redirect_url: "https://app.example.com/connected",
      external_ref: customerId,
    }),
  });
  const session = (await r.json()) as { url: string; error?: { message: string } };
  if (!r.ok) throw new Error(session.error?.message);
  return session.url; // they come back with ?session=...&status=connected&channel_id=...
}

// At the start of every job: the API base and a token that is valid now
export async function credentials(channelId: string) {
  const r = await fetch(`${EC}/channels/${channelId}?credentials=1`, { headers: KEY });
  const body: any = await r.json(); // the credential fields differ by network
  if (!r.ok) throw new Error(body.error.message);
  if (!body.credentials.access_token) throw new Error(body.credentials.note);
  return body.credentials;
}

如何從 Node.js 發布到 Instagram 與 Facebook?

Instagram 透過容器發布。若要發布 Reel,請以 media_type REELS、video_url 與 caption 建立容器,輪詢其 status_code 直至顯示 FINISHED,再以容器 ID 作為 creation_id 呼叫 media_publish。Meta 建議約每分鐘輪詢 1 次,並於 5 分鐘後停止;ERROR 或 EXPIRED 表示容器不會發布,而未發布滿 24 小時的容器會自動過期。

Facebook 專頁只需一次呼叫 /{page-id}/photos,附上圖片 url 與說明文字即可發布相片,文字與連結則送到 /{page-id}/feed。兩者都接受 published false 與 scheduled_publish_time,由 Meta 於指定時間自行發布,可排程於 10 分鐘至 30 天後。權杖以 bearer 標頭傳送,Graph API 版本已包含在 graph_api_base 內,而媒體必須置於 Meta 可下載的公開 URL。

Publish a Reel and schedule a Page photo
type Meta = { graph_api_base: string; access_token: string };

async function graph(c: Meta, path: string, body?: object) {
  const r = await fetch(`${c.graph_api_base}/${path}`, {
    method: body ? "POST" : "GET",
    headers: { Authorization: `Bearer ${c.access_token}`, "Content-Type": "application/json" },
    body: body && JSON.stringify(body),
  });
  const data: any = await r.json();
  if (!r.ok) throw new Error(data.error?.message ?? `Graph API ${r.status}`);
  return data;
}

export async function postReel(channelId: string, videoUrl: string, caption: string) {
  const c = await credentials(channelId);
  const ig = c.account_id_on_meta;
  const { id } = await graph(c, `${ig}/media`, { media_type: "REELS", video_url: videoUrl, caption });
  for (let check = 0; check < 5; check++) {
    await new Promise((wake) => setTimeout(wake, 60_000)); // about once a minute, as Meta advises
    const { status_code } = await graph(c, `${id}?fields=status_code`);
    if (status_code === "FINISHED") return graph(c, `${ig}/media_publish`, { creation_id: id });
    if (status_code === "ERROR" || status_code === "EXPIRED") throw new Error(`Reel container ${status_code}`);
  }
  throw new Error("The Reel is still processing after five minutes");
}

export async function schedulePagePhoto(channelId: string, url: string, caption: string, at: Date) {
  const c = await credentials(channelId);
  return graph(c, `${c.account_id_on_meta}/photos`, {
    url,
    caption,
    published: false,
    scheduled_publish_time: Math.floor(at.getTime() / 1000), // 10 minutes to 30 days ahead
  });
}

如何從 Node.js 發布到 LinkedIn 並上傳至 YouTube?

除每次呼叫的 bearer 權杖外,LinkedIn 還需要兩個標頭:LinkedIn-Version,填入 easyCoexistence 於 required_headers 回傳的 YYYYMM 值;以及設為 2.0.0 的 X-Restli-Protocol-Version。發布貼文時,以 POST 送到 /rest/posts,內容包括作者 URN、commentary 文字、PUBLIC 可見度、以動態消息作為 distribution,以及 lifecycleState PUBLISHED。LinkedIn 以 201 回應,並把新貼文的 URN 放在 x-restli-id 標頭中;任何放進 URL 路徑的 URN 都必須進行 URL 編碼。

YouTube 需要兩個請求。以 POST 送至上傳端點,附上 uploadType=resumable 與 part=snippet,status,即可送出中繼資料,並在 Location 標頭取得工作階段位址;再以 PUT 把檔案位元組送到該位址,即會回傳帶有 id 的影片資源。若以私人狀態上傳並設定 publishAt 日期,發布便交由 YouTube 自己的排程器處理,您的系統無需在當天的時間運作。

Publish on LinkedIn and schedule a YouTube upload
import { readFile } from "node:fs/promises";

export async function postOnLinkedIn(channelId: string, text: string) {
  const c = await credentials(channelId);
  const r = await fetch(`${c.api_base}/posts`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${c.access_token}`,
      "LinkedIn-Version": c.required_headers["LinkedIn-Version"],
      "X-Restli-Protocol-Version": "2.0.0",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      author: c.author_urn, // urn:li:organization:... or urn:li:person:...
      commentary: text,
      visibility: "PUBLIC",
      distribution: { feedDistribution: "MAIN_FEED", targetEntities: [], thirdPartyDistributionChannels: [] },
      lifecycleState: "PUBLISHED",
      isReshareDisabledByAuthor: false,
    }),
  });
  if (r.status !== 201) throw new Error(`LinkedIn ${r.status}: ${await r.text()}`);
  return r.headers.get("x-restli-id"); // the new post's URN
}

export async function scheduleOnYouTube(channelId: string, file: string, title: string, publishAt: string) {
  const c = await credentials(channelId);
  const auth = { Authorization: `Bearer ${c.access_token}` };
  const start = await fetch(
    "https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status",
    {
      method: "POST",
      headers: { ...auth, "Content-Type": "application/json; charset=UTF-8", "X-Upload-Content-Type": "video/mp4" },
      body: JSON.stringify({
        snippet: { title },
        status: { privacyStatus: "private", publishAt, selfDeclaredMadeForKids: false },
      }),
    },
  );
  const session = start.headers.get("location");
  if (!start.ok || !session) throw new Error(`YouTube ${start.status}: ${await start.text()}`);
  const done = await fetch(session, {
    method: "PUT",
    headers: { ...auth, "Content-Type": "video/mp4" },
    body: await readFile(file),
  });
  const video = (await done.json()) as { id: string };
  return video.id;
}

如何在 Node.js 路由中接收留言與私訊?

每個頻道會把事件轉送到您透過 PUT /channels/{id}/webhook 提供的 URL,該呼叫只回傳一次頻道的 signing_secret。每次送遞均為 POST,包含 platform、account_id、external_id 與 entry,並附有 X-EC-Signature 標頭,格式為 t=<unix>,v1=<hex>,其中 v1 是 t、句點與原始內容的 HMAC-SHA256。解析前先把內容取為文字,拒絕早於 5 分鐘的 t,並以 timingSafeEqual 比較。

就 Instagram 與 Facebook 而言,entry 是 Meta 原樣發送的 Webhook entry:留言與提及放在 changes 中,私訊放在 messaging 中。TikTok 的 entry 則包含 comment.update 事件,TikTok 會在留言後 5 分鐘內觸發,並以字串形式提供 comment_id 與 video_id,以免 JavaScript 把這兩個 64 位元數字捨入。每個事件只嘗試一次,且不會儲存副本,因此請立即以 204 回應,再從佇列處理。

Turn on forwarding and verify X-EC-Signature in a route handler
import { createHmac, timingSafeEqual } from "node:crypto";

const secrets = new Map<string, string>(); // channel id -> signing_secret, kept in your database

export async function forwardEvents(channelId: string, url: string) {
  const r = await fetch(`${EC}/channels/${channelId}/webhook`, {
    method: "PUT",
    headers: { ...KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ url }),
  });
  const body = (await r.json()) as { signing_secret: string; error?: { message: string } };
  if (!r.ok) throw new Error(body.error?.message);
  secrets.set(channelId, body.signing_secret); // returned only this once
}

function verify(raw: string, header: string | null, secret: string): boolean {
  const parts = Object.fromEntries((header ?? "").split(",").map((kv) => kv.split("=", 2)));
  const t: string = parts.t ?? "";
  const v1: string = parts.v1 ?? "";
  if (!/^[0-9]+$/.test(t) || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const mac = createHmac("sha256", secret).update(`${t}.${raw}`).digest("hex");
  return mac.length === v1.length && timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}

// POST /hooks/social as a web-standard handler (Next.js, Hono, Bun and others)
export async function POST(req: Request) {
  const raw = await req.text(); // the signature covers these exact bytes
  const event = JSON.parse(raw); // { platform, account_id, external_id, entry }
  const secret = secrets.get(event.account_id);
  if (!secret || !verify(raw, req.headers.get("x-ec-signature"), secret)) {
    return new Response("invalid signature", { status: 401 });
  }
  await enqueue(event); // one attempt per event and no retries: acknowledge first
  return new Response(null, { status: 204 });
}

如何在 Node.js 中回覆留言與私訊?

以新的 credentials 呼叫,並使用事件中的 ID。在 Instagram 與 Facebook 上,私訊回覆送到 /{account-id}/messages,使用 account_id_on_meta,以對方的 ID 作為 recipient,且須在對方最後一則訊息後 24 小時內發送;專頁另須加上 messaging_type RESPONSE,而 Instagram 文字上限為 1,000 位元組。留言可獲公開回覆,Instagram 送至 /{comment-id}/replies,Facebook 送至 /{comment-id}/comments;亦可在 7 天內作一次私下回覆。

TikTok 的對話一律公開,因為 TikTok 沒有私訊。business/comment/reply/create/ 以 Access-Token 標頭、business_id、video_id 與 comment_id 發出,可回覆最多 1,200 個字元的留言。請讀取回應的 code 欄位,0 表示成功,而非 HTTP 狀態碼。只處理 comment_action 為 insert 且 comment_type 為 comment 的事件,因為您自己的回覆也會以事件形式送達。

Reply to a TikTok comment and a Messenger DM
export async function reply(event: any, text: string) {
  const c = await credentials(event.account_id);
  if (event.platform === "tiktok") {
    const e = event.entry.content; // the comment.update event, ids as strings
    if (e.comment_action !== "insert" || e.comment_type !== "comment") return; // your replies arrive as "reply"
    const r = await fetch(`${c.api_base}/business/comment/reply/create/`, {
      method: "POST",
      headers: { "Access-Token": c.access_token, "Content-Type": "application/json" },
      body: JSON.stringify({ business_id: c.business_id, video_id: e.video_id, comment_id: e.comment_id, text }),
    });
    const out = (await r.json()) as { code: number; message: string };
    if (out.code !== 0) throw new Error(out.message); // 0 is success, whatever the HTTP status
  } else if (event.platform === "facebook") {
    for (const m of event.entry.messaging ?? []) {
      if (!m.message || m.message.is_echo) continue; // only what people sent the Page
      await graph(c, `${c.account_id_on_meta}/messages`, {
        recipient: { id: m.sender.id },
        messaging_type: "RESPONSE", // within 24 hours of their last message
        message: { text },
      });
    }
  }
}

如何發布到 TikTok,並把這些工具提供給 TypeScript 代理?

兩者皆透過 easyCoexistence 的 MCP 伺服器進行,網址為 https://easycoexistence.com/api/mcp,該伺服器只接受 OAuth 2.1:動態用戶端註冊、附 PKCE 的授權碼、有效期為 1 小時的存取權杖,以及重新整理權杖。使用適用於 Node 20 及以上版本的官方 TypeScript SDK 時,請用 @modelcontextprotocol/client,而 OAuthClientProvider 會保存用戶端、權杖與 PKCE verifier;首次連接會引導用戶登入並拋出 UnauthorizedError,之後以回呼的查詢參數呼叫 finishAuth 即可完成。

TikTok 發布功能設於此,因為 TikTok 只會從已為該權杖所屬開發者應用程式驗證的 URL 前綴下載媒體。publish_tiktok_post 接受您的 HTTPS 連結,並向 TikTok 提供 easyCoexistence 已驗證媒體路由上的簽署位址;get_tiktok_publish_status 則追蹤該貼文的狀態。同一個用戶端會把帳戶所屬各網絡的所有工具交給代理;請先呼叫 list_social_accounts,其中的 account_id 即 Partner API 的頻道 ID。

Sign in over OAuth and publish to TikTok with the MCP client
import { createInterface } from "node:readline/promises";
import { Client, StreamableHTTPClientTransport, UnauthorizedError, type OAuthClientProvider } from "@modelcontextprotocol/client";

const MCP = new URL("https://easycoexistence.com/api/mcp");
const saved: Record<string, any> = {}; // persist this, so the browser sign-in happens once

const provider: OAuthClientProvider = {
  redirectUrl: "http://localhost:8090/callback",
  clientMetadata: { client_name: "My social agent", redirect_uris: ["http://localhost:8090/callback"] },
  state: () => (saved.state = crypto.randomUUID()),
  clientInformation: () => saved.client,
  saveClientInformation: (info) => { saved.client = info; },
  tokens: () => saved.tokens,
  saveTokens: (tokens) => { saved.tokens = tokens; },
  saveCodeVerifier: (verifier) => { saved.verifier = verifier; },
  codeVerifier: () => saved.verifier,
  redirectToAuthorization: (url) => console.log("Sign in to easyCoexistence:", url.href),
};

const client = new Client({ name: "my-social-agent", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(MCP, { authProvider: provider });
try {
  await client.connect(transport);
} catch (error) {
  if (!(error instanceof UnauthorizedError)) throw error;
  const rl = createInterface({ input: process.stdin, output: process.stdout });
  const back = new URL(await rl.question("Paste the address you were sent back to: ")).searchParams;
  rl.close();
  if (back.get("state") !== saved.state) throw new Error("state mismatch");
  await transport.finishAuth(back);
  await client.connect(new StreamableHTTPClientTransport(MCP, { authProvider: provider }));
}

const result = await client.callTool({
  name: "publish_tiktok_post",
  arguments: {
    account_id: process.env.TIKTOK_CHANNEL_ID, // the Partner API channel id
    video_url: "https://cdn.example.com/launch.mp4",
    caption: "New drop #behindthescenes",
  },
});
console.log(result.content); // a share_id to follow with get_tiktok_publish_status

常見錯誤

  • 在解析後再重新序列化的 JSON 上計算 HMAC。簽章會逐位元組涵蓋原始內容,因此應先呼叫 req.text() 再解析,否則每次送遞都會未能通過驗證。
  • 把 TikTok 的 ID 轉為數字。留言與影片 ID 為 64 位元,Number() 會捨入,因此回覆或查詢留言時,請保留事件所附的字串。
  • 只從重新導向保留 channel_id。Facebook 或 LinkedIn 登入可能一次新增多個專頁,因此請以 GET /channels?external_ref= 列出,並分別儲存每一個。
  • 在每晚批次中回覆 Messenger 或 Instagram 私訊。超過對方最後一則訊息後 24 小時,發送便會失敗,因此應在有效時段內,於事件處理程式中回覆。
使用 EasyCoexistence 完成這項設定

easyCoexistence 為 Node.js 後端與 AI 代理提供與客戶溝通的能力,涵蓋 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 等頻道,並會陸續加入更多頻道,各自透過官方 API 運作。以 Partner API 連接帳戶、取得新鮮權杖與已簽署事件,並讓 TypeScript 代理透過 MCP 伺服器執行操作,所有連接均全天候 24/7 監控。每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,首 3 天免費試用。

常見問題

從 Node 呼叫這些 API 需要 SDK 嗎?

不需要。Partner API 與各網絡的 API 都是純 HTTPS,Node 18 及以上版本內建的全域 fetch 即可應付。只有 MCP 工具(當中包括 TikTok 發布)才需要 @modelcontextprotocol/client。

為何 TikTok 發布要經過 MCP 伺服器?

TikTok 只會從已為開發者應用程式驗證的網域或 URL 前綴下載影片與相片,而該應用程式屬於 easyCoexistence。publish_tiktok_post 會從該已驗證位址提供您的 HTTPS 檔案,因此您自己的網域無需驗證。

一次登入可以連接多個 Facebook 或 LinkedIn 專頁嗎?

可以。每個專頁,以及 LinkedIn 上會員本人的個人檔案,各自成為一個頻道與一個連接。重新導向會附上第一個 channel_id,而 GET /channels?external_ref= 可列出全部。

easyCoexistence 用於 Node.js 的費用是多少?

每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,各網絡收費一致。Partner API 與 MCP 連接器包含在內,不按座位收費,首 3 天免費試用。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期