社交媒體 Webhook:留言、提及與訊息,統一送至一個端點
easyCoexistence 會即時把社交媒體事件轉發至您自己的 HTTPS 端點:來自 Instagram 與 Facebook 的留言、提及和私訊,以及來自 TikTok 的留言。每則事件以一個封套送達,其中包含未經改動的網絡原始事件,並以 X-EC-Signature 為每個帳戶分別簽署。您可在 Claude 或 ChatGPT 中使用 set_social_webhook_destination,或透過 Partner API,為每個帳戶開啟此功能。WhatsApp 號碼的訊息同樣會送達您的伺服器。
- 即時送達的留言、提及與私訊
- 每個帳戶一個獨立簽署的封套
- 透過 Claude、ChatGPT 或 Partner API 設定
3 天內不收取任何費用。隨時取消。
easyCoexistence 每次轉發社交事件的發送次數;它不保留副本,因此之後不會再次發送。
TikTok 的 comment.update Webhook 回報已擁有帳戶公開影片上留言被建立、刪除或改變可見度的速度。
Instagram Login 的應用程式接收 @提及的位置:在留言 Webhook 通知之內,而不是獨立欄位。
YouTube 推送通知就頻道報告的內容:新上傳影片、新標題或新描述。
Meta 對於您的伺服器未接受的 WhatsApp Webhook,會持續重試多久,這可能造成重複送達。
各網絡會發送哪些事件?
Instagram、Facebook 與 TikTok 會將事件推送至 easyCoexistence,再由它把每則事件傳給您為該帳戶設定的 URL。Instagram 會發送新留言及私訊,@提及會放在留言通知之內送達。Facebook 專頁會發送動態活動,當中包括新留言,以及 Messenger 訊息和提及該專頁的內容。TikTok 會發送 comment.update,於留言被建立、刪除或改變可見度時觸發。
YouTube 與 LinkedIn 不會向 easyCoexistence 發送留言或訊息事件,因此 AI 代理需按要求讀取它們的留言。WhatsApp 號碼則走自己的路徑:Meta 會把訊息直接送到您的伺服器;當號碼以管理模式運作時,easyCoexistence 則會以簽署方式轉發。
| What arrives | Sent by | |
|---|---|---|
| Comments, mentions and DMs | easyCoexistence, signed per account | |
| Feed activity, Messenger and mentions | easyCoexistence, signed per account | |
| TikTok | comment.update events | easyCoexistence, signed per account |
| Messages and echoes from the app | Meta directly, or easyCoexistence in managed mode | |
| YouTube | No comment events | Read with list_youtube_comments |
| No comment events | Read 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 訊息的送達格式如下:
{
"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
// 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 端點。
設定方法
- 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.
- Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
- Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
- 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 會即時把 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 監察
驗證日期