ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Вебхуки соцсетей: комментарии, упоминания и сообщения на один эндпоинт

easyCoexistence пересылает события соцсетей на ваш HTTPS-эндпоинт сразу, как они происходят: комментарии, упоминания и личные сообщения из Instagram и Facebook, а также комментарии из TikTok. Каждое событие приходит в одном конверте, и событие сети внутри передаётся без изменений. Конверт подписан для каждого аккаунта заголовком X-EC-Signature. Включить пересылку для аккаунта можно через set_social_webhook_destination в Claude или ChatGPT либо через Partner API. Сообщения номера WhatsApp тоже доходят до вашего сервера.

  • Комментарии, упоминания и личные сообщения по мере появления
  • Один конверт, подписанный для каждого аккаунта
  • Настройка из Claude, ChatGPT или Partner API
Начать бесплатный пробный период

В течение 3 дней ничего не списывается. Отмена в любое время.

Только официальные APIMCP для Claude и ChatGPTКаждое подключение под мониторингом 24/73 дня бесплатно
1 attempt

Сколько раз easyCoexistence отправляет каждое пересланное событие соцсети; копию он не хранит, поэтому повторно ничего не отправляется позже.

Within 5 minutes

Как быстро вебхук comment.update от TikTok сообщает о созданном, удалённом комментарии или изменении его видимости в публичных видео вашего аккаунта.

In comments

Где приложения на Instagram Login получают упоминания @: внутри уведомления вебхука комментариев, а не в отдельном поле.

3 events

Что сообщают push-уведомления YouTube о канале: новую загрузку, новое название или новое описание.

7 days

Сколько времени Meta повторяет доставку вебхука WhatsApp, который ваш сервер не принял, что может привести к дубликатам.

Какие события присылает каждая сеть?

Instagram, Facebook и TikTok отправляют события в easyCoexistence, который передаёт каждое из них на URL, указанный для этого аккаунта. Instagram присылает новые комментарии и личные сообщения, а упоминания @ приходят внутри уведомления о комментариях. Страница Facebook присылает активность ленты, куда входят новые комментарии, а также сообщения Messenger и упоминания страницы. TikTok присылает comment.update, который срабатывает при создании или удалении комментария либо при изменении его видимости.

YouTube и LinkedIn не присылают в easyCoexistence событий о комментариях или сообщениях, поэтому агент читает их комментарии по запросу. Номер 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; external_id, ID аккаунта в сети; и entry, собственное событие сети в том виде, в каком оно пришло. Для Instagram и Facebook entry является entry вебхука Meta, с 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 от метки времени, точки и исходного тела запроса, с этим секретом в качестве ключа. Читайте тело как байты до разбора JSON, отклоняйте метку времени, которая отличается от вашего времени более чем на 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

Как включить пересылку для аккаунта?

Из ассистента или из вашего бэкенда. Попросите Claude или ChatGPT выполнить set_social_webhook_destination с аккаунтом и вашим HTTPS-URL, либо вызовите PUT /api/v1/channels/:id/webhook в Partner API с вашим ключом ec_live_ и телом, содержащим 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 ставит сообщения в очередь для вашего forward_url и повторяет попытки с нарастающими паузами. События статуса партнёра, например обрыв подключения, повторяются около 33 часов.

Как комментарии YouTube и LinkedIn доходят до агента?

Их читают по расписанию. Push-уведомления YouTube сообщают о новой загрузке, новом названии или новом описании, а не о комментариях, и easyCoexistence не получает событий о комментариях от LinkedIn, поэтому ничего из них не пересылается. Агент проверяет сам: list_youtube_comments возвращает треды видео или всего канала, включая ожидающие проверки, а list_linkedin_comments возвращает комментарии к публикации или ответы под одним комментарием. В n8n, Make или Zapier триггер по расписанию запускает проверку. В вашем коде cron-задача получает учётные данные канала и напрямую вызывает commentThreads YouTube или эндпоинт comments LinkedIn.

Как настроить

  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.

Распространённые ошибки

  • Проверка HMAC по разобранному JSON. Подпись охватывает исходное тело побайтно, а повторная сериализация разобранного объекта меняет эти байты, поэтому проверяйте подпись до разбора.
  • Один секрет на все аккаунты. Каждый аккаунт подписывает своим секретом, поэтому ищите его по account_id события до сравнения v1.
  • Повторная настройка адреса без обновления эндпоинта. Каждый вызов выпускает новый секрет, а старый сразу перестаёт подписывать, поэтому сохраните новый немедленно.
  • Адрес, который перенаправляет. Пересылки не следуют перенаправлениям, поэтому переход на новый путь или хост теряет событие; укажите конечный адрес.
Настройка с EasyCoexistence

easyCoexistence отправляет комментарии, упоминания и личные сообщения Instagram и Facebook, а также комментарии TikTok на ваш эндпоинт сразу, по мере их появления, с подписью для каждого аккаунта, и передаёт сообщения WhatsApp на ваш сервер. Так ваши ИИ-агенты получают сообщения от клиентов через официальный API каждой сети, а каждое подключение находится под круглосуточным мониторингом. От 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 для вебхуков соцсетей?

От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений, одинаково для каждой сети. Пересылка, MCP-сервер и Partner API включены, первые 3 дня бесплатно.

Читайте дальше

API комментариев в соцсетях для Instagram, TikTok, Facebook, YouTube и LinkedInЧитайте, отвечайте и модерируйте комментарии в Instagram, Facebook, TikTok, YouTube и LinkedIn из Claude, ChatGPT или своего кода, через официальные API.API для личных сообщений: Instagram, Messenger и WhatsApp через один APIОтвечайте на личные сообщения в Instagram, Messenger и WhatsApp из Claude, ChatGPT или своего кода: шаблоны, автоматизации и ответы ИИ через API Meta.Как получать сообщения клиентов WhatsApp и комментарии соцсетей по вебхукуВебхук на каждое подключение: сообщения WhatsApp напрямую от Meta, защита секретом в URL, а комментарии и DM соцсетей подписаны X-EC-Signature.Автоматизация социальных сетей в n8n: Instagram, TikTok, Facebook и другиеАвтоматизируйте Instagram, TikTok, Facebook и YouTube в n8n: подписанные события Instagram, Facebook и TikTok в узле Webhook и AI-агент с 35+ инструментами MCP.Публикация в Instagram, TikTok и Facebook из Node.js одним APIПубликуйте, планируйте и отвечайте в Instagram, Facebook, TikTok, YouTube и LinkedIn из Node.js и TypeScript через fetch, плюс MCP-инструменты для агента.Публикация в Instagram, TikTok и Facebook из Python через один APIПубликуйте посты, читайте комментарии и отвечайте на личные сообщения в Instagram, Facebook, TikTok, YouTube и LinkedIn из Python через официальные API.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на