適用於 SaaS 的統一社交媒體 API:一次整合 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 及更多渠道
easyCoexistence 的合作夥伴 API 讓 SaaS 只需一次整合,即可連接客戶的 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 及更多渠道。一組 API 金鑰及一次連接會話調用即可完成連接;同一組調用可列出這些渠道、返回最新憑證、設定 Webhook,並發送已簽署的狀態事件。另有一個帖文端點,可一次發布至 Instagram、Facebook、TikTok 及 LinkedIn。回覆會使用客戶的存取權杖,直接透過各平台自身的 API 發出。
每個 easyCoexistence 帳戶各有一組合作夥伴 API 金鑰;其連接的每個號碼及社交帳戶均屬於該帳戶。
每條連接每月收費,WhatsApp 號碼與社交帳戶收費相同,連接數越多,單價越低。
Instagram 帳戶透過 API 發布的帖文,在任何滾動 24 小時內均有上限;輪播帖文計為一則。
TikTok 透過其 API 為每個帳戶發布的影片,每分鐘不超過六則。
用戶發送訊息後,WhatsApp 的客戶服務窗口隨即開啟;窗口關閉後,只能發送已獲批准的訊息範本。
一次整合涵蓋什麼?
各平台共通的工作,透過 https://easycoexistence.com/api/v1 及一組 ec_live_ 金鑰完成。您的程式只需學習這些調用一次;客戶的 TikTok 帳戶與其 Instagram 帳戶的處理方式相同,錯誤、ID 及已簽署事件也保持一致:
各平台仍會決定什麼?
其 API 允許的範圍。easyCoexistence 以相同方式連接、續期及監察每個帳戶,但您的產品能提供的功能,取決於各平台自身的規則,因此私訊、留言事件及帖文類型在各平台之間各有不同:
為何號碼與社交帳戶是獨立資源?
因為它們承載的內容不同。號碼關聯一部電話、一個 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,錯誤訊息會列出開放予該帳戶的渠道。
設定方法
- Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
- Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
- Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
- Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
- 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 為您的 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 監察
驗證日期