登录开始免费试用
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 天内不收取任何费用。随时取消。

仅使用官方 API支持 Claude 和 ChatGPT 的 MCP每个连接 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,或在 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 端点。

设置方法

  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)去重。对于您的服务器未接受的 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 监控

验证时间