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

代理商社交媒體 API:從自家軟件管理客戶的帳戶

社交媒體 API 讓代理商自家的軟件為每個客戶的帳戶進行連接、發佈、回覆及製作報告。透過 easyCoexistence 的 Partner API,客戶的 WhatsApp 號碼,以及 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 帳戶,會以客戶 ID 標記的託管連結加入代理商的帳戶,而一個 API 金鑰即可排程、分流及監察所有這些帳戶。

200 characters

連接工作階段接受的 external_ref 最長長度,即代理商為客戶設定的 ID,並保存於每個連接上。

1 hour

託管連接連結對開啟它的客戶保持有效的時長。

Advanced Access

Meta 應用程式在 App Review 及商業驗證後,為其並不擁有或管理的 Instagram 專業帳戶提供服務所需的條件。

ADMINISTRATOR

成員為取得 rw_organization_admin 權限所需的 LinkedIn 專頁角色,該權限可管理專頁及讀取其報告。

End of cycle

代理商透過 API 移除客戶連接後,何時停止計費。

API 如何組織代理商的客戶?

按您的客戶 ID 劃分。每次連接工作階段均以 external_ref 傳送,該值會保留於工作階段所建立的每個號碼及帳戶上,並會隨每則狀態事件回傳。GET /channels?external_ref=client_118 會列出該客戶的社交帳戶,加上 &channel=instagram 可限定至單一網絡;GET /connections?external_ref=client_118 則列出其 WhatsApp 號碼。所有客戶都位於代理商的同一個帳戶之下,共用一個 ec_live_ 金鑰,因此全部數量都落在同一個價格級別內。

One client's accounts
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

客戶如何授予存取權?

透過代理商發送的連結。以 POST /connect-sessions 傳送 channel(網絡)、客戶的 external_ref,以及代理商名稱 partner_name,即可取得 url。客戶開啟連結後,在網絡本身的同意畫面登入;若為 WhatsApp 號碼,則使用 Meta 的彈出視窗掃描 QR 碼。完成後會返回代理商的 redirect_url。透過 Facebook 或 LinkedIn 登入,可一次帶入多個專頁,每個專頁各自成為一個連接,請對照客戶的委託內容核對清單。

代理商如何為客戶發佈內容?

透過代理商自身的審批流程。代理商的軟件會保留草稿,直至客戶批核,然後把每則已批核的貼文連同 publish_at 送至 POST /channels/:id/posts,時間最遠可設於 90 天後。GET /channels/:id/posts 顯示單一帳戶的排程,GET /posts 配合 status 篩選器則可查看所有客戶的待發佈項目;post.published 與 post.failed 會告知客戶經理結果。LinkedIn 貼文一律須由個人批核,代理商的批核步驟已可提供此項。

代理商如何代客戶回覆留言及私訊?

透過一個按帳戶分流的收件匣。PUT /channels/:id/webhook 為每個 Instagram 帳戶、Facebook 專頁及 TikTok 帳戶設定一個目的地;每則轉發的留言、提及或私訊都附帶 account_id,對應至客戶。WhatsApp 號碼的訊息會從 Meta 送至為其設定的 webhook_url。回覆則透過各網絡的 API 送出,所用憑證來自 GET /channels/:id?credentials=1;代理商團隊也能透過同一帳戶中的 MCP 連接器,在 Claude 或 ChatGPT 內跨客戶工作。

代理商如何製作客戶報告?

從各網絡自身的分析數據擷取,並使用客戶帳戶的憑證呼叫。Instagram 及 Facebook 的洞察數據來自 Meta 的 Graph API,TikTok 的來自其 API for Business,YouTube 的來自 YouTube Analytics(其基礎網址已包含在憑證內),LinkedIn 的則來自其統計端點。代理商的報告工作會在每次執行開始時,為每個帳戶取得最新憑證,提取該期間的數據,並歸檔於客戶的 external_ref 之下。

代理商如何得知客戶帳戶需要跟進?

透過已簽署的狀態事件。channel.disconnected 與 connection.disconnected 均帶有客戶的 external_ref,因此代理商的軟件可通知該客戶的客戶經理,並向客戶發送新的連接連結。每個連接均受 24/7 監察,連接中斷時代理商的擁有人亦會收到電郵通知。客戶若在網絡的設定中撤銷存取權,也會以相同方式顯示。

客戶離開時,API 會發生什麼事?

代理商的客戶退出流程會按 external_ref 列出客戶的連接,並對每個連接呼叫 DELETE /channels/:id 及 DELETE /connections/:id。這些連接的計費於本計費週期結束時停止,已排程的貼文若位於已移除的渠道上會被取消,而已移除社交帳戶的存取權杖會被清除。WhatsApp 號碼會保留在 Cloud API 上,直至客戶在 WhatsApp Business 應用程式中將其斷開連接。

常見錯誤

  • 於客戶批核前便將貼文排入隊列。已排隊的貼文會在指定時間發佈,不會再作其他檢查,因此請於審批步驟中保留草稿,待批核後才發送。
  • 將 Partner API 金鑰放在客戶入口網站的前端。該金鑰可接觸帳戶內每位客戶的憑證,因此請將其保存於代理商的伺服器上。
  • 等待客戶 YouTube 頻道或 LinkedIn 專頁的留言事件。easyCoexistence 兩者皆不會接收此類事件,因此報告或收件匣工作需透過各網絡的 API 讀取。
使用 EasyCoexistence 完成這項設定

easyCoexistence 為代理商自家的軟件提供單一 API,連接客戶的 WhatsApp 號碼,以及其 Instagram、Facebook、TikTok、YouTube 與 LinkedIn 帳戶,並會陸續加入更多渠道。功能包括以客戶劃分的託管連接連結、發佈隊列、轉發的留言與私訊、供報告使用的最新憑證,以及每個連接的 24/7 監察。每個連接每月 US$ 9 起,隨連接數量增加而下降,最低降至 US$ 0.75,首 3 天免費試用。

常見問題

客戶是否需要自己的 easyCoexistence 帳戶?

不需要。客戶只需開啟託管連結並登入,該連接便會加入代理商的帳戶,由其計費及監察。

代理商可否為客戶分別使用不同的 API 金鑰?

每個帳戶只有一個金鑰。若要使用獨立金鑰,須建立獨立的 easyCoexistence 帳戶,每個帳戶各自從第一個級別起計費,因此多數代理商會改以 external_ref 區分客戶。

客戶連接時能否看到代理商的名稱?

可以。託管頁面會顯示以 partner_name 傳送的名稱。網絡本身的同意畫面則會顯示 easyCoexistence 為要求存取權的應用程式。

easyCoexistence 對代理商收費多少?

每個客戶連接每月 US$ 9 起,隨代理商新增客戶而下降,最低降至 US$ 0.75,所有網絡收費相同,首 3 天免費試用。

繼續閱讀

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

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

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

驗證日期