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

社交媒體 Webhook:留言、提及與訊息,統一送至一個端點

easyCoexistence 會即時把社交媒體事件轉發至您自己的 HTTPS 端點:來自 Instagram 與 Facebook 的留言、提及和私訊,以及來自 TikTok 的留言。每則事件以一個封套送達,其中包含未經改動的網絡原始事件,並以 X-EC-Signature 為每個帳戶分別簽署。您可在 Claude 或 ChatGPT 中使用 set_social_webhook_destination,或透過 Partner API,為每個帳戶開啟此功能。WhatsApp 號碼的訊息同樣會送達您的伺服器。

  • 即時送達的留言、提及與私訊
  • 每個帳戶一個獨立簽署的封套
  • 透過 Claude、ChatGPT 或 Partner API 設定
開始免費試用

3 天內不收取任何費用。隨時取消。

僅使用官方 APIMCP 支援 Claude 與 ChatGPT所有連接 24/7 監察免費試用 3 天
1 attempt

easyCoexistence 每次轉發社交事件的發送次數;它不保留副本,因此之後不會再次發送。

Within 5 minutes

TikTok 的 comment.update Webhook 回報已擁有帳戶公開影片上留言被建立、刪除或改變可見度的速度。

In comments

Instagram Login 的應用程式接收 @提及的位置:在留言 Webhook 通知之內,而不是獨立欄位。

3 events

YouTube 推送通知就頻道報告的內容:新上傳影片、新標題或新描述。

7 days

Meta 對於您的伺服器未接受的 WhatsApp Webhook,會持續重試多久,這可能造成重複送達。

各網絡會發送哪些事件?

Instagram、Facebook 與 TikTok 會將事件推送至 easyCoexistence,再由它把每則事件傳給您為該帳戶設定的 URL。Instagram 會發送新留言及私訊,@提及會放在留言通知之內送達。Facebook 專頁會發送動態活動,當中包括新留言,以及 Messenger 訊息和提及該專頁的內容。TikTok 會發送 comment.update,於留言被建立、刪除或改變可見度時觸發。

YouTube 與 LinkedIn 不會向 easyCoexistence 發送留言或訊息事件,因此 AI 代理需按要求讀取它們的留言。WhatsApp 號碼則走自己的路徑:Meta 會把訊息直接送到您的伺服器;當號碼以管理模式運作時,easyCoexistence 則會以簽署方式轉發。

What arrivesSent by
InstagramComments, mentions and DMseasyCoexistence, signed per account
FacebookFeed activity, Messenger and mentionseasyCoexistence, signed per account
TikTokcomment.update eventseasyCoexistence, signed per account
WhatsAppMessages and echoes from the appMeta directly, or easyCoexistence in managed mode
YouTubeNo comment eventsRead with list_youtube_comments
LinkedInNo comment eventsRead with list_linkedin_comments

轉發的事件是什麼樣子?

各網絡都使用相同的 JSON 封套,以 Content-Type application/json 發送:platform 代表網絡;account_id 為 MCP 工具與 Partner API 使用的 ID;external_id 為該帳戶在網絡上的 ID;entry 為網絡傳來的原始事件。對 Instagram 與 Facebook 而言,entry 是 Meta 的 Webhook entry,留言與提及放在 changes 之中,私訊則放在 messaging 之中。對 TikTok 而言,它包含 comment.update 事件,其中 comment_id、video_id 與 parent_comment_id 均為字串,因此 64 位元的 ID 不會被四捨五入。Messenger 訊息的送達格式如下:

A forwarded Messenger message, trimmed
{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793318400512,
    "messaging": [
      {
        "sender": { "id": "<PAGE_SCOPED_ID>" },
        "recipient": { "id": "<PAGE_ID>" },
        "timestamp": 1793318399870,
        "message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
      }
    ]
  }
}

如何驗證 X-EC-Signature?

使用設定目的地時返回的簽署密鑰,該密鑰為每個帳戶獨有,且只顯示一次。標頭格式為 t=<unix>,v1=<hex>,v1 是以該密鑰為鍵,對時間戳、一個句點與原始請求主體計算的 HMAC-SHA256。在解析之前,先以位元組讀取主體;拒絕與您的時鐘相差超過 5 分鐘的時間戳;依事件的 account_id 查找密鑰;並以常數時間比較兩個摘要。隨後回應 2xx 並將工作排入佇列。PHP 中,只需數行程式碼:

PHP: verifying a forwarded event
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input');          // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true);                  // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? '');  // the signing_secret stored for that account

$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
    http_response_code(401);
    exit;
}

http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resent

如何為帳戶開啟轉發?

可從 AI 助理或您的後端開啟。請 Claude 或 ChatGPT 以該帳戶及您的 HTTPS URL 執行 set_social_webhook_destination,或使用您的 ec_live_ 金鑰,在 Partner API 上呼叫 PUT /api/v1/channels/:id/webhook,並在主體中加入 url 欄位。兩種方式都會一次性返回帳戶的 signing_secret,因此請當場將它與 account_id 一併儲存。再次呼叫任一方式會發出新的密鑰;url 設為 null 則關閉轉發。

URL 必須為公開主機上的 HTTPS:設定時及送達時,私有地址都會被拒絕。由於每個事件都會指明 account_id,一個端點可以服務多個帳戶。對於 WhatsApp 號碼,set_webhook_destination 會把 Meta 的送達導向您;而 set_inbound_mode 配合 forward_url,則會改為以簽署方式轉發。

端點緩慢或失效時會怎樣?

事件不會再次發送。easyCoexistence 只嘗試一次,最多等候 8 秒回應,不跟隨任何重新導向,也不保留副本,因為重試意味著要儲存您客戶的留言與訊息。在簽署驗證通過後即回應 2xx,把較慢的工作放入佇列,並以網絡本身的 ID(例如留言 ID 或訊息 mid)去重,以防事件送達兩次。

WhatsApp 則不同。在直接模式下,若您的伺服器未接受某次送達,Meta 最多會重試 7 天。在託管模式下,easyCoexistence 會把訊息排入轉發 URL 的佇列,並以退避方式重試。Partner 狀態事件(例如連接中斷)則大約重試 33 小時。

YouTube 與 LinkedIn 的留言如何抵達 AI 代理?

由代理按排程讀取。YouTube 的推送通知回報的是新上傳、新標題或新描述,而非留言;LinkedIn 亦不向 easyCoexistence 發送留言事件,因此兩者都不會轉發任何內容。代理改為主動查詢:list_youtube_comments 會返回某影片的留言串,或整個頻道的留言串,包括待審核的留言;list_linkedin_comments 則返回某貼文的留言,或某條留言下的回覆。在 n8n、Make 或 Zapier 中,排程觸發器會啟動查詢;在您自己的程式碼中,cron 工作會取得頻道的憑證,並直接呼叫 YouTube 的 commentThreads 或 LinkedIn 的 comments 端點。

設定方法

  1. Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
  2. Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
  3. Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
  4. Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.

常見錯誤

  • 對已解析的 JSON 進行 HMAC 檢查。簽署涵蓋原始主體的逐個位元組,而重新序列化已解析的物件會改變這些位元組,因此請先驗證再解析。
  • 所有帳戶共用同一個密鑰。每個帳戶以自己的密鑰簽署,因此在比較 v1 之前,請先依事件的 account_id 查找密鑰。
  • 重新設定目的地卻未更新端點。每次呼叫都會發出新的密鑰,舊密鑰會立即停止簽署,因此請即時儲存新密鑰。
  • 提供會重新導向的 URL。轉發不跟隨任何重新導向,因此若遷移至新路徑或主機,事件會遺失;請設定最終地址。
使用 EasyCoexistence 完成這項設定

easyCoexistence 會即時把 Instagram 與 Facebook 的留言、提及和私訊,以及 TikTok 的留言,以每個帳戶獨立簽署的方式送達您的端點,並把 WhatsApp 訊息路由至您的伺服器,讓您的 AI 代理透過各網絡的官方 API 聽見客戶的聲音,且每個連接全天候 24/7 受監察。每個連接每月 US$ 9 起,連接越多價格越低,最低降至 US$ 0.75,並提供首 3 天免費試用。

常見問題

WhatsApp 號碼的訊息如何送達我的端點?

有兩種方式。set_webhook_destination 讓 Meta 把訊息直接送到您的伺服器;set_inbound_mode 配合 forward_url,則讓 easyCoexistence 以 X-EC-Signature 簽署後轉發,並以退避方式重試。

同一事件會否送達兩次?

會的,因此請以網絡本身的 ID 去重,例如留言 ID 或訊息 mid。Meta 對於您的伺服器未接受的 WhatsApp 送達所作的重試,最長可達 7 天,也可能造成重複。

一個端點能接收多個帳戶的事件嗎?

可以。每個事件都會附上 platform 與 account_id,因此一個 URL 可以服務多個帳戶,但前提是它要以該帳戶各自的密鑰驗證每個簽署。

easyCoexistence 的社交媒體 Webhook 收費多少?

每個連接每月 US$ 9 起,連接越多價格越低,最低降至 US$ 0.75,各網絡收費相同。轉發、MCP 伺服器與 Partner API 均包括在內,並提供首 3 天免費試用。

繼續閱讀

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

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

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

驗證日期