由 Ayrshare、Zernio 或 Unipile 切換至 easyCoexistence:代碼需要改動的地方
由 Ayrshare、Zernio 或 Unipile 切換至 easyCoexistence,代碼會有四個部分改變:連結、定址、發文與事件。連結方式改為每個帳戶一個託管的連接會話;定址改用 channel_id 或 connection_id,並配合您的 external_ref;發文則是每個帳戶各一次 POST /channels/:id/posts;事件則按帳戶簽名,或由 Meta 直接發送給您。每位客戶都需要再登入一次,並透過該網絡自己的同意畫面完成授權。
將 Ayrshare 請求指向 User Profile 的標頭,與 Authorization 中的 Primary Profile API 金鑰並列。
generateJWT 生成的 Ayrshare 連結預設有效期;最長 2,880 分鐘需購買其 Max Pack。
Zernio 的貼文狀態:draft、pending_approval、scheduled、publishing、published、partial、failed 與 cancelled。
Unipile 的 API 接受的標頭,用於以您自己的 DSN 為基礎網址的呼叫,例如託管授權連結。
easyCoexistence 連接連結的有效時間;每個連結只完成一個號碼或一次社交登入。
各項概念如何對應?
概念大致保留,但結構有所改變。客戶、連接帳戶的連結、定址用的 ID、發文呼叫與事件,都有對應的項目。以下每一行均依據各服務商的官方文件(於 2026 年 11 月 3 日閱讀)及 easyCoexistence 的 Partner API 參考文件:
| Ayrshare, Zernio or Unipile | easyCoexistence | |
|---|---|---|
| Your customer | An Ayrshare User Profile, a Zernio profile or the name on a Unipile link | external_ref on each connect session, connection and event |
| Linking | generateJWT, GET /v1/connect/{platform} or POST /api/v1/hosted/accounts/link | POST /connect-sessions, one account per link |
| Addressing | Profile-Key, profileId with accountId, or account_id | channel_id for a social account, connection_id for a number |
| Authentication | A Bearer key, with Profile-Key on Ayrshare; X-API-KEY on Unipile | Authorization: Bearer ec_live_… |
| Posting | One request with a list of platforms, on Ayrshare and Zernio | POST /channels/:id/posts, one per account |
| Incoming events | The provider's webhooks | Signed 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 分鐘,後者則有效一小時。
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 為您的 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 監察
驗證日期