Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Webhooki social media: komentarze, wzmianki i wiadomości na jeden endpoint

easyCoexistence przekazuje zdarzenia z mediów społecznościowych na Twój własny endpoint HTTPS na bieżąco: komentarze, wzmianki i wiadomości prywatne z Instagrama i Facebooka oraz komentarze z TikToka. Każde zdarzenie trafia w jednej kopercie, z oryginalnym zdarzeniem sieci w środku, bez zmian, podpisanej dla każdego konta nagłówkiem X-EC-Signature. Włączysz to dla konta poleceniem set_social_webhook_destination z Claude lub ChatGPT albo przez Partner API. Wiadomości z numeru WhatsApp również trafiają na Twój serwer.

  • Komentarze, wzmianki i wiadomości prywatne na bieżąco
  • Jedna koperta, podpisana dla każdego konta
  • Ustawiana z Claude, ChatGPT lub Partner API
Rozpocznij bezpłatny okres próbny

Przez 3 dni nic nie zapłacisz. Anuluj w dowolnym momencie.

Wyłącznie oficjalne APIMCP dla Claude i ChatGPTKażde połączenie monitorowane 24/73 dni za darmo
1 attempt

Ile razy easyCoexistence wysyła każde przekazane zdarzenie social media; nie przechowuje kopii, więc nic nie zostanie wysłane ponownie później.

Within 5 minutes

Jak szybko webhook comment.update TikToka zgłasza utworzenie, usunięcie lub zmianę widoczności komentarza pod publicznymi filmami należącego do Ciebie konta.

In comments

Gdzie aplikacje z Instagram Login otrzymują wzmianki @: w powiadomieniu webhooka komentarzy, a nie w osobnym polu.

3 events

Co powiadomienia push YouTube zgłaszają dla kanału: nowy film, nowy tytuł lub nowy opis.

7 days

Jak długo Meta ponawia dostarczanie webhooka WhatsApp, którego serwer nie przyjął, co może skutkować duplikatami.

Jakie zdarzenia wysyła każda sieć?

Instagram, Facebook i TikTok przesyłają zdarzenia do easyCoexistence, które przekazuje każde z nich na adres URL ustawiony dla danego konta. Instagram wysyła nowe komentarze, przy czym wzmianki @ przychodzą w powiadomieniu o komentarzach, oraz wiadomości prywatne (DM). Strona Facebooka wysyła aktywność w feedzie, obejmującą nowe komentarze, a także wiadomości z Messengera i wzmianki o stronie. TikTok wysyła comment.update, uruchamiane przy utworzeniu, usunięciu lub zmianie widoczności komentarza.

YouTube i LinkedIn nie wysyłają do easyCoexistence zdarzeń o komentarzach ani wiadomościach, więc agent odczytuje ich komentarze na żądanie. Numer WhatsApp działa na własnej ścieżce: Meta dostarcza wiadomości bezpośrednio na Twój serwer albo easyCoexistence przekazuje je podpisane, gdy numer działa w trybie zarządzanym.

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

Jak wygląda przekazane zdarzenie?

Ta sama koperta JSON na każdej sieci, wysyłana z nagłówkiem Content-Type application/json: platform, czyli sieć; account_id, czyli identyfikator używany przez narzędzia MCP i Partner API; external_id, czyli identyfikator konta w sieci; oraz entry, czyli zdarzenie sieci w postaci, w jakiej nadeszło. Dla Instagrama i Facebooka entry to wpis webhooka Meta, z changes dla komentarzy i wzmianek oraz messaging dla wiadomości prywatnych. Dla TikToka zawiera zdarzenie comment.update, z comment_id, video_id i parent_comment_id jako ciągi znaków, dzięki czemu 64-bitowe identyfikatory nie są zaokrąglane. Wiadomość z Messengera wygląda tak:

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?" }
      }
    ]
  }
}

Jak zweryfikować X-EC-Signature?

Sekretem podpisu zwróconym przy ustawianiu adresu docelowego, unikalnym dla tego konta i pokazywanym tylko raz. Nagłówek ma postać t=<unix>,v1=<hex>, a v1 to HMAC-SHA256 z znacznika czasu, kropki i surowego ciała żądania, z kluczem będącym tym sekretem. Odczytaj ciało jako bajty, zanim je sparsujesz, odrzuć znacznik czasu odbiegający o więcej niż 5 minut od Twojego zegara, wyszukaj sekret po account_id zdarzenia i porównaj oba skróty w stałym czasie. Następnie odpowiedz 2xx i dodaj pracę do kolejki. W PHP zajmuje to kilka linijek:

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

Jak włączyć przekazywanie dla konta?

Z asystenta albo z Twojego backendu. Poproś Claude lub ChatGPT o uruchomienie set_social_webhook_destination z kontem i Twoim adresem HTTPS albo wywołaj PUT /api/v1/channels/:id/webhook w Partner API z kluczem ec_live_ i treścią zawierającą url. Obie metody zwracają signing_secret konta jednorazowo, więc zapisz go od razu powiązanego z account_id. Ponowne wywołanie wystawia nowy sekret, a url o wartości null wyłącza przekazywanie.

Adres URL musi być HTTPS na publicznym hoście: prywatny adres zostanie odrzucony przy ustawianiu i ponownie przy dostarczaniu. Jeden endpoint może obsługiwać wiele kont, ponieważ każde zdarzenie wskazuje swój account_id. Dla numeru WhatsApp set_webhook_destination kieruje dostarczenia Meta do Ciebie, a set_inbound_mode z forward_url przekazuje je podpisane.

Co się dzieje, gdy endpoint jest wolny lub niedostępny?

Zdarzenie nie zostaje wysłane ponownie. easyCoexistence wykonuje jedną próbę, czeka do 8 sekund na odpowiedź, nie podąża za przekierowaniami i nie przechowuje kopii, ponieważ ponawianie oznaczałoby przechowywanie komentarzy i wiadomości Twoich klientów. Odpowiadaj 2xx, gdy tylko podpis się zgadza, wykonuj wolną pracę z kolejki i deduplikuj na identyfikatorach sieci, takich jak ID komentarza czy wiadomości (mid), na wypadek gdyby zdarzenie dotarło dwukrotnie.

WhatsApp działa inaczej. W trybie bezpośrednim Meta ponawia dostarczenie, którego Twój serwer nie przyjął, przez do 7 dni. W trybie zarządzanym easyCoexistence kolejkuje wiadomości dla Twojego adresu przekazywania i ponawia z rosnącymi przerwami. Zdarzenia statusu Partnera, na przykład rozłączenie połączenia, są ponawiane przez około 33 godziny.

Jak komentarze z YouTube i LinkedIn trafiają do agenta?

Agent odczytuje je zgodnie z harmonogramem. Powiadomienia push YouTube zgłaszają nowy film, nowy tytuł lub nowy opis, a nie komentarze, a easyCoexistence nie otrzymuje zdarzeń komentarzy z LinkedIn, więc żadne z nich nie przekazuje niczego. Agent sprawdza je sam: list_youtube_comments zwraca wątki pod filmem albo całego kanału, także te wstrzymane do moderacji, a list_linkedin_comments zwraca komentarze pod postem albo odpowiedzi pod jednym komentarzem. W n8n, Make lub Zapier wyzwalacz harmonogramu uruchamia sprawdzenie; we własnym kodzie zadanie cron pobiera dane uwierzytelniające kanału i wywołuje bezpośrednio endpoint commentThreads YouTube lub endpoint comments LinkedIn.

Jak to skonfigurować

  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.

Typowe błędy

  • Sprawdzanie HMAC na sparsowanym JSON. Podpis obejmuje surowe ciało bajt po bajcie, a ponowna serializacja obiektu zmienia te bajty, więc weryfikuj przed parsowaniem.
  • Używanie jednego sekretu dla wszystkich kont. Każde konto podpisuje własnym sekretem, więc wyszukaj go po account_id zdarzenia, zanim porównasz v1.
  • Ponowne ustawienie adresu bez aktualizacji endpointu. Każde wywołanie wystawia nowy sekret, a stary przestaje podpisywać od razu, więc zapisz nowy natychmiast.
  • Podanie adresu, który przekierowuje. Przekazywanie nie podąża za przekierowaniami, więc przeniesienie na nową ścieżkę lub host gubi zdarzenie; ustaw ostateczny adres.
Z EasyCoexistence zrobisz to

easyCoexistence wysyła komentarze, wzmianki i wiadomości prywatne z Instagrama i Facebooka oraz komentarze z TikToka na Twój endpoint na bieżąco, podpisane dla każdego konta, a wiadomości z WhatsApp kieruje na Twój serwer. Dzięki temu Twoi agenci AI słyszą klientów przez oficjalne API każdej sieci, a każde połączenie jest monitorowane 24/7. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Najczęściej zadawane pytania

Jak wiadomości z numeru WhatsApp docierają do mojego endpointu?

Na jeden z dwóch sposobów. set_webhook_destination sprawia, że Meta dostarcza je bezpośrednio na Twój serwer, a set_inbound_mode z forward_url sprawia, że easyCoexistence przekazuje je podpisane nagłówkiem X-EC-Signature, ponawiając z rosnącymi przerwami.

Czy to samo zdarzenie może dotrzeć dwukrotnie?

Może, więc deduplikuj na identyfikatorach samej sieci, takich jak ID komentarza czy wiadomości (mid). Ponowne próby Meta dla dostarczenia WhatsApp, którego Twój serwer nie przyjął, przez do 7 dni też mogą dać duplikaty.

Czy jeden endpoint może odbierać zdarzenia z kilku kont?

Tak. Każde zdarzenie niesie platform i account_id, więc jeden adres URL może obsługiwać wiele kont, o ile sprawdza każdy podpis sekretem danego konta.

Ile kosztuje easyCoexistence dla webhooków social media?

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, tak samo w każdej sieci. Przekazywanie, serwer MCP i Partner API są wliczone, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w