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

適用於 SaaS 的統一社交媒體 API:一次整合 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 及更多渠道

easyCoexistence 的合作夥伴 API 讓 SaaS 只需一次整合,即可連接客戶的 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 及更多渠道。一組 API 金鑰及一次連接會話調用即可完成連接;同一組調用可列出這些渠道、返回最新憑證、設定 Webhook,並發送已簽署的狀態事件。另有一個帖文端點,可一次發布至 Instagram、Facebook、TikTok 及 LinkedIn。回覆會使用客戶的存取權杖,直接透過各平台自身的 API 發出。

1 key

每個 easyCoexistence 帳戶各有一組合作夥伴 API 金鑰;其連接的每個號碼及社交帳戶均屬於該帳戶。

US$ 9 to US$ 0.75

每條連接每月收費,WhatsApp 號碼與社交帳戶收費相同,連接數越多,單價越低。

100 posts

Instagram 帳戶透過 API 發布的帖文,在任何滾動 24 小時內均有上限;輪播帖文計為一則。

15 a day

TikTok 透過其 API 為每個帳戶發布的影片,每分鐘不超過六則。

24 hours

用戶發送訊息後,WhatsApp 的客戶服務窗口隨即開啟;窗口關閉後,只能發送已獲批准的訊息範本。

一次整合涵蓋什麼?

各平台共通的工作,透過 https://easycoexistence.com/api/v1 及一組 ec_live_ 金鑰完成。您的程式只需學習這些調用一次;客戶的 TikTok 帳戶與其 Instagram 帳戶的處理方式相同,錯誤、ID 及已簽署事件也保持一致:

ConnectPOST /connect-sessions, with channel set to the network
ListGET /connections for numbers, GET /channels for social accounts
Credentials?credentials=1 on either, with tokens renewed for you
WebhooksPUT /connections/{id}/webhook or PUT /channels/{id}/webhook
Status eventsconnection.* and channel.*, signed, with your external_ref
PostsPOST /channels/{id}/posts, now or at publish_at
RemoveDELETE on the connection or the channel

各平台仍會決定什麼?

其 API 允許的範圍。easyCoexistence 以相同方式連接、續期及監察每個帳戶,但您的產品能提供的功能,取決於各平台自身的規則,因此私訊、留言事件及帖文類型在各平台之間各有不同:

WhatsAppMessages and replies on the Cloud API, templates outside the 24-hour window
InstagramPosts, carousels, Reels and Stories; comments; replies to DMs
FacebookPage posts; comments; replies to Messenger DMs
TikTokVideo and photo posts; public replies to comments; no DMs
YouTubeUploads and comments through YouTube's own API; no DMs
LinkedInPosts a person approves, text with an image or a link; no DMs

為何號碼與社交帳戶是獨立資源?

因為它們承載的內容不同。號碼關聯一部電話、一個 WhatsApp Business 帳戶及 Meta 的評級;社交帳戶則有用戶名稱及平台 ID。因此,號碼位於 /connections,社交帳戶位於 /channels,各自擁有獨立 ID、獨立的重定向參數(connection_id 或 channel_id)及獨立的事件名稱。純 WhatsApp 整合除非主動要求,否則不會接觸渠道;連接本身是兩者共用的唯一調用。

一次帖文調用如何跨平台運作?

請求主體在各平台都相同:text、media、link 及 publish_at,另加幾個個別平台會讀取的欄位,例如 Instagram 的 ig_type、TikTok 的 title 與 disable_comment,以及 LinkedIn 的 image_alt。帖文入隊前,會先檢查各平台的限制:

  • Instagram:一張圖片或一段影片,或 2 至 10 張輪播;JPEG 圖片;無 link 欄位;文字最多 2,200 個字元。
  • Facebook:文字、一個連結、一張圖片或一段影片;文字最多 63,206 個字元。
  • TikTok:一段影片,或 1 至 35 張 JPEG 或 WebP 圖片組成的相片帖文;無 link 欄位;文字最多 2,200 個字元。
  • LinkedIn:文字,附一張圖片或一個連結,其中連結需要標題;不支援影片;文字最多 3,000 個字元。

easyCoexistence 是否會介於您的程式與各平台之間?

只限於能為您節省工作的環節:連接、續期存取權杖、轉發留言及私訊事件,以及運行帖文隊列。回覆、讀取及其他操作,均由您的後端直接以客戶的存取權杖發送至各平台的 API;Meta 則會將號碼的訊息直接送到您的伺服器。平台新增的功能一經推出,您的程式即可直接調用,無須等待封裝層。

新平台加入時會發生什麼事?

新平台會以新的 channel 值出現在相同的調用中。您的連接會話會指定該平台,其帳戶會出現在 GET /channels 中,其事件使用 channel.* 名稱,而每個帳戶的收費與其他連接相同。若您的帳戶尚未能使用某渠道,系統會返回 400 channel_unavailable,錯誤訊息會列出開放予該帳戶的渠道。

設定方法

  1. Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
  2. Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
  3. Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
  4. Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
  5. Post and replyPublish with POST /channels/{id}/posts and reply through each network's API with fresh credentials.

常見錯誤

  • 為 TikTok、YouTube 或 LinkedIn 建立私訊功能。這些連接沒有私訊,因此應在這些平台規劃留言回覆;WhatsApp、Instagram 及 Messenger 則規劃私訊回覆。
  • 發送 Instagram 帖文時沒有附上媒體。Instagram 需要一張圖片或一段影片,否則請求會在入隊前被拒絕,因此請按平台附上媒體。
  • 將 channel_id 與 connection_id 儲存在同一欄位而不標示類型。它們是獨立資源,各有獨立 ID,因此請記錄每個值屬於哪一種。
  • 從無審核的自動流程發布 LinkedIn 帖文。LinkedIn 的 API 條款限制自動發帖,因此每則 LinkedIn 帖文請先由人工核准。
使用 EasyCoexistence 完成這項設定

easyCoexistence 為您的 SaaS 提供一次整合,連接客戶的 WhatsApp 號碼,以及其 Instagram、Facebook、TikTok、YouTube 及 LinkedIn 帳戶,並支援更多渠道:連接連結、憑證、Webhook、狀態事件及帖文,全部透過各平台的官方 API 運行,每條連接並以 24/7 全天候監察。每條連接每月 US$ 9 至 US$ 0.75,連接數越多,單價越低,首 3 天免費。

常見問題

一個端點能否接收所有平台的事件?

能。將每個渠道的目的地都設為同一個 URL,並根據請求主體中的 platform 與 account_id 進行路由。WhatsApp 號碼的訊息會由 Meta 送至其自身的 webhook_url,該 URL 可以與其他平台指向同一伺服器。

我是否需要自行向 Meta、TikTok、Google 及 LinkedIn 註冊應用程式?

不需要。客戶透過 easyCoexistence 在這些平台上的應用程式登入,您的後端會取得調用各平台 API 所需的存取權杖。

帖文端點會發布到哪些平台?

Instagram、Facebook 專頁、TikTok 及 LinkedIn。YouTube 影片則透過 YouTube 自身的 API,使用該渠道的憑證上傳。

easyCoexistence 的統一 API 收費多少?

各平台收費相同:每條連接每月 US$ 9 至 US$ 0.75,按您連接總數所屬的級別計算,首 3 天免費。

繼續閱讀

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

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

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

驗證日期