社交媒体 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,或在 Partner API 上使用您的 ec_live_ 密钥调用 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 的推送通知只报告新上传、新标题或新描述,并不包括评论;easyCoexistence 也不会收到 LinkedIn 的评论事件,因此两者都不会转发任何内容。智能体需要主动查询:list_youtube_comments 返回某个视频或整个频道的评论线程,包括待审核的评论;list_linkedin_comments 返回某篇帖子的评论或其下的回复。在 n8n、Make 或 Zapier 中,由定时触发器启动查询;在您自己的代码中,由定时任务获取频道凭据,并直接调用 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)去重。对于您的服务器未接受的 WhatsApp 投递,Meta 最多会重试 7 天,这同样可能造成重复。
一个端点能接收多个账户的事件吗?
可以。每个事件都带有 platform 和 account_id,因此只要使用该账户自己的密钥校验签名,一个 URL 即可服务多个账户。
easyCoexistence 的社交媒体 Webhook 收费多少?
每个连接每月 US$ 9 至 US$ 0.75,随连接数增加而降低,无论哪个网络价格都相同。转发、MCP 服务器和 Partner API 均包含在内,并提供前 3 天免费试用。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间