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

由 Ayrshare、Zernio 或 Unipile 切換至 easyCoexistence:代碼需要改動的地方

由 Ayrshare、Zernio 或 Unipile 切換至 easyCoexistence,代碼會有四個部分改變:連結、定址、發文與事件。連結方式改為每個帳戶一個託管的連接會話;定址改用 channel_id 或 connection_id,並配合您的 external_ref;發文則是每個帳戶各一次 POST /channels/:id/posts;事件則按帳戶簽名,或由 Meta 直接發送給您。每位客戶都需要再登入一次,並透過該網絡自己的同意畫面完成授權。

Profile-Key

將 Ayrshare 請求指向 User Profile 的標頭,與 Authorization 中的 Primary Profile API 金鑰並列。

5 minutes

generateJWT 生成的 Ayrshare 連結預設有效期;最長 2,880 分鐘需購買其 Max Pack。

8 statuses

Zernio 的貼文狀態:draft、pending_approval、scheduled、publishing、published、partial、failed 與 cancelled。

X-API-KEY

Unipile 的 API 接受的標頭,用於以您自己的 DSN 為基礎網址的呼叫,例如託管授權連結。

1 hour

easyCoexistence 連接連結的有效時間;每個連結只完成一個號碼或一次社交登入。

各項概念如何對應?

概念大致保留,但結構有所改變。客戶、連接帳戶的連結、定址用的 ID、發文呼叫與事件,都有對應的項目。以下每一行均依據各服務商的官方文件(於 2026 年 11 月 3 日閱讀)及 easyCoexistence 的 Partner API 參考文件:

Ayrshare, Zernio or UnipileeasyCoexistence
Your customerAn Ayrshare User Profile, a Zernio profile or the name on a Unipile linkexternal_ref on each connect session, connection and event
LinkinggenerateJWT, GET /v1/connect/{platform} or POST /api/v1/hosted/accounts/linkPOST /connect-sessions, one account per link
AddressingProfile-Key, profileId with accountId, or account_idchannel_id for a social account, connection_id for a number
AuthenticationA Bearer key, with Profile-Key on Ayrshare; X-API-KEY on UnipileAuthorization: Bearer ec_live_…
PostingOne request with a list of platforms, on Ayrshare and ZernioPOST /channels/:id/posts, one per account
Incoming eventsThe provider's webhooksSigned forwards per account; WhatsApp from Meta to your URL

離開 Ayrshare 時會有什麼改變?

Profile 層將不再存在。Ayrshare 透過 Profile-Key 標頭將貼文發送至 User Profile,並在 POST /api/post 上以 platforms 列表分發,scheduleDate 採 UTC,檔案則以 mediaUrls 傳送。在 easyCoexistence,您的流程會逐一遍歷客戶的頻道:每個頻道各一次 POST /channels/:id/posts,publish_at 可使用任何時區偏移,媒體則以 {url, type} 格式傳送。連結方式由 generateJWT 改為每個帳戶一個連接會話:前者的 URL 預設只有效 5 分鐘,後者則有效一小時。

Node.js: one post per channel instead of a platforms list
const EC = "https://easycoexistence.com/api/v1";
const auth = { Authorization: `Bearer ${process.env.EC_API_KEY}` };

// Before: POST https://api.ayrshare.com/api/post with Profile-Key,
// { post, platforms: ["instagram", "facebook"], mediaUrls, scheduleDate }
async function schedule(customerId, post) {
  const { data } = await fetch(`${EC}/channels?external_ref=${customerId}`, { headers: auth })
    .then((r) => r.json());
  for (const ch of data.filter((c) => post.networks.includes(c.channel) && c.status === "connected")) {
    await fetch(`${EC}/channels/${ch.id}/posts`, {
      method: "POST",
      headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": `${post.id}-${ch.id}` },
      body: JSON.stringify({
        text: post.text,
        media: post.mediaUrls.map((url) => ({ url, type: post.type })),
        publish_at: post.scheduleDate, // ISO 8601 with Z or an offset
      }),
    });
  }
}

離開 Zernio 時會有什麼改變?

發文方面的改動比其他兩者少。Zernio 的 POST /v1/posts 接受 content、由 platform 與 accountId 組成的 platforms 列表、mediaItems,以及附帶時區的 scheduledFor,並支援 Idempotency-Key,easyCoexistence 亦然。列表會變為每個 channel_id 各一次呼叫,scheduledFor 則改為帶偏移的 publish_at。Zernio 的 draft 與 pending_approval 狀態在 easyCoexistence 沒有對應項目,因此草稿與審批需由您的產品自行處理。連結方式由 GET /v1/connect/{platform}(傳入 profileId,返回 authUrl)改為 POST /connect-sessions(返回 url,之後在您的 redirect 上附帶 channel_id)。

離開 Unipile 時會有什麼改變?

主要影響訊息功能。Unipile 透過您 DSN 上的 POST /api/v1/hosted/accounts/link 連結帳戶,以 X-API-KEY 認證,使用 POST /api/v1/chats/{chat_id}/messages 發送訊息,並藉由 message_received Webhook 回報新訊息,其中包括帳戶自己發出的訊息。在 easyCoexistence,WhatsApp 號碼透過 Coexistence 加入 Meta 的 Cloud API,但需要 WhatsApp Business 應用程式;Meta 會將其訊息傳送至您的 webhook_url。回覆將使用客戶的存取權杖,發送至號碼的 send_endpoint;Instagram 私訊則透過 Meta 的 API 以該頻道的憑證發送。

客戶需要重新連接嗎?

需要,每個帳戶一次。每位客戶所授予的存取權限,屬於提出請求的服務商應用程式,因此無法轉移至另一個應用程式。每個帳戶均須透過託管的連接連結重新登入,可經該網絡自己的同意畫面完成,WhatsApp 號碼則透過 Meta 的彈出視窗完成。請在客戶在場時提出:每個連結有效一小時,每個帳戶最多可同時持有 50 個未完成的連結,每小時最多可建立 100 個。

如何在無停機的情況下切換?

逐一帳戶切換,在每位客戶遷移完成前,兩個服務商並行運作。您的代碼會將每個帳戶路由至持有它的服務商;收到 channel.connected 或 connection.connected 時,即可將該帳戶切換過來:

  • 將每位客戶的 ID 對應至 external_ref,並在 channel_id 與 connection_id 到達時一併儲存。
  • 按客戶逐一發送連接連結,優先處理發文或收訊最多的帳戶。
  • 收到 channel.connected 後,在 easyCoexistence 為該帳戶排程待發貼文,然後在舊服務商取消這些貼文。
  • 將該帳戶的事件指向您的新接收端,然後在舊服務商解除該帳戶的連結。

代碼中有哪些保持不變?

您的產品不變。編輯器、日曆、審批流程與收件箱都保持原樣,只有其底下的適配器會改變。媒體仍以公開 HTTPS 連結提供,冪等性仍透過標頭實現,事件仍以原始主體上的 HMAC 進行驗證;至於封裝呼叫以外所需的功能,則直接使用該網絡自己的 API,憑證取自 GET /channels/:id?credentials=1。

常見錯誤

  • 在帳戶尚未重新連接前,就在舊服務商取消貼文。在 channel.connected 到達之前,easyCoexistence 上無法發佈任何內容,因此應先重新排程,後取消。
  • 遷移的客戶,其 WhatsApp 仍在消費者應用程式上運作。Coexistence 只連接 WhatsApp Business 應用程式的號碼,因此客戶需先將號碼轉移至 WhatsApp Business 應用程式,才能開啟連結。
  • 為客戶所有網絡發送同一個連結。每個連結只完成一個號碼或一次登入,因此請為每個帳戶各建一個會話。
  • 沿用 cancelled 的拼寫作比對。easyCoexistence 回報的是 canceled(只有一個 l),請更新代碼中所有的狀態比對。
使用 EasyCoexistence 完成這項設定

easyCoexistence 為您的 SaaS 提供託管連接連結、最新憑證、發佈佇列,以及客戶 WhatsApp 號碼與 Instagram、Facebook、TikTok、YouTube、LinkedIn 帳戶的已簽名事件,並會加入更多頻道。每個頻道均透過該網絡的官方 API 運作,所有連接全天候 24/7 監察。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。

常見問題

切換後,我能否在客戶不重新登入的情況下遷移其已連接帳戶?

不能。每個網絡都將存取權限綁定至請求它的應用程式,因此每個帳戶都需要透過 easyCoexistence 的連接連結登入一次。

easyCoexistence 是否支援 X、Threads 或 Telegram?

目前不支援。其他帳戶可在您現有的服務商保留,待其他帳戶遷移完成。新網絡會以同一價格、透過同一個 Partner API 陸續加入。

轉用 easyCoexistence 後,我能否保留 Unipile 的 LinkedIn 私訊?

請保留在 Unipile。easyCoexistence 透過貼文與留言支援 LinkedIn 專頁與個人檔案,但不提供 LinkedIn 私訊。

切換後,easyCoexistence 的費用是多少?

每個連接每月 US$ 9 起,在每個網絡上收費相同,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。

繼續閱讀

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

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

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

驗證日期