Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Social media webhooks: comments, mentions at mensahe sa iisang endpoint

Ipinapasa ng easyCoexistence ang social media events sa sarili ninyong HTTPS endpoint habang nangyayari: comments, mentions at DMs mula sa Instagram at Facebook, at comments mula sa TikTok. Bawat isa ay dumarating sa iisang envelope, kasama ang event ng network na hindi binago, at naka-sign bawat account gamit ang X-EC-Signature. I-on ito bawat account gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang Partner API. Umaabot din sa server ninyo ang mga mensahe mula sa numero sa WhatsApp.

  • Comments, mentions at DMs habang nangyayari
  • Isang envelope, naka-sign para sa bawat account
  • I-set mula sa Claude, ChatGPT o Partner API
Magsimula ng Libreng Trial

Walang sisingilin sa loob ng 3 araw. Mag-cancel anumang oras.

Official API langMCP para sa Claude at ChatGPTBawat koneksyon ay minomonitor 24/73 araw na libre
1 attempt

Ilang beses ipinapadala ng easyCoexistence ang bawat forwarded social event; wala itong kopya, kaya hindi na ito ipapadala muli sa bandang huli.

Within 5 minutes

Gaano kabilis iniuulat ng comment.update webhook ng TikTok na may comment na nagawa, nabura o nagbago ang visibility sa mga public video ng account na pag-aari ninyo.

In comments

Saan tumatanggap ng @mentions ang mga app sa Instagram Login: sa loob ng comments webhook notification, hindi bilang sariling field.

3 events

Ano ang iniuulat ng push notifications ng YouTube para sa isang channel: bagong upload, bagong title o bagong description.

7 days

Gaano katagal patuloy na sinusubukan ng Meta ang WhatsApp webhook na hindi tinanggap ng server ninyo, na maaaring magdulot ng duplicate.

Anong mga event ang ipinapadala ng bawat network?

Ipinapadala ng Instagram, Facebook at TikTok ang mga event sa easyCoexistence, na ipinapasa ito sa URL na itinakda ninyo para sa account na iyon. Ipinapadala ng Instagram ang mga bagong comment, kung saan dumarating ang @mentions sa loob ng comments notification, at ang mga DM. Ipinapadala ng Facebook Page ang feed activity, na sumasaklaw sa mga bagong comment, pati mensahe sa Messenger at mention sa Page. Ipinapadala ng TikTok ang comment.update, na nagti-trigger kapag nagawa, nabura o nagbago ang visibility ng comment.

Hindi nagpapadala ang YouTube at LinkedIn ng comment o mensahe na event sa easyCoexistence, kaya binabasa ng agent ang kanilang comments kapag hiniling. Ang numero sa WhatsApp ay may sariling landas: diretsong inihahatid ng Meta ang mga mensahe nito sa server ninyo, o ipinapasa ito ng easyCoexistence na naka-sign kapag ang numero ay tumatakbo sa managed mode.

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

Ano ang hitsura ng isang ipinapasang event?

Pareho ang JSON envelope sa bawat network, ipinapadala gamit ang Content-Type application/json: platform, ang network; account_id, ang ID na ginagamit ng MCP tools at ng Partner API; external_id, ang ID ng account sa network; at entry, ang sariling event ng network gaya ng pagdating nito. Para sa Instagram at Facebook, ang entry ay webhook entry ng Meta, na may changes para sa comments at mentions at messaging para sa DM. Para sa TikTok, dala nito ang comment.update event, kasama ang comment_id, video_id at parent_comment_id bilang string, kaya hindi nire-round ang 64-bit IDs. Ganito dumarating ang mensahe sa 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?" }
      }
    ]
  }
}

Paano i-verify ang X-EC-Signature?

Gamit ang signing secret na ibinabalik kapag itinakda ninyo ang destination, natatangi sa account na iyon at ipinapakita nang isang beses. Ang header ay may anyong t=<unix>,v1=<hex>, at ang v1 ay HMAC-SHA256 ng timestamp, isang tuldok, at ang raw request body, gamit ang secret na iyon. Basahin ang body bilang bytes bago i-parse, tanggihan ang timestamp na mahigit 5 minuto ang layo sa orasan ninyo, hanapin ang secret gamit ang account_id ng event, at ihambing ang dalawang digest sa constant time. Pagkatapos, sumagot ng 2xx at i-queue ang trabaho. Sa PHP, ilang linya lamang ang kailangan:

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

Paano i-on ang forwarding para sa isang account?

Mula sa assistant o sa backend ninyo. Hilingin sa Claude o ChatGPT na patakbuhin ang set_social_webhook_destination kasama ang account at ang HTTPS URL ninyo, o i-call ang PUT /api/v1/channels/:id/webhook sa Partner API gamit ang ec_live_ key ninyo at body na may url. Parehong ibinabalik ang signing_secret ng account nang isang beses, kaya itabi ito laban sa account_id sa sandaling iyon. Kapag inulit ang alinman, gagawa ito ng bagong secret, at ang url na null ay magpapatay ng forwarding.

Dapat HTTPS ang URL sa public host: tinatanggihan ang private address kapag itinakda ito at muli sa pag-deliver. Puwedeng pagsilbihan ng isang endpoint ang maraming account, dahil pinangalanan ng bawat event ang account_id nito. Para sa numero sa WhatsApp, itinuturo ng set_webhook_destination ang mga delivery ng Meta sa inyo, at ang set_inbound_mode na may forward_url ang nagfo-forward nito na naka-sign.

Ano ang mangyayari kapag mabagal o down ang endpoint ninyo?

Hindi na ito ipapadala muli. Isang pagsubok lang ang ginagawa ng easyCoexistence, naghihintay ng sagot nang hanggang 8 segundo, hindi sumusunod sa redirect, at walang itinatagong kopya, dahil ang pag-retry ay mangangahulugang pag-iimbak ng mga comment at mensahe ng mga customer ninyo. Sumagot ng 2xx sa sandaling tama ang signature, gawin ang mabagal na trabaho mula sa queue, at i-deduplicate gamit ang sariling ID ng network, gaya ng comment ID o message mid, kung sakaling dumating nang dalawang beses ang event.

Iba ang WhatsApp. Sa direct mode, inuulit ng Meta ang delivery na hindi tinanggap ng server ninyo nang hanggang 7 araw. Sa managed mode, ipinipila ng easyCoexistence ang mga mensahe para sa forward URL ninyo at nagre-retry nang may backoff. Ang mga partner status event, gaya ng pagbagsak ng koneksyon, ay inuulit nang humigit-kumulang 33 oras.

Paano nakakarating sa agent ang comments ng YouTube at LinkedIn?

Sa pamamagitan ng pagbabasa nito ayon sa iskedyul. Hindi comments ang iniuulat ng push notifications ng YouTube kundi bagong upload, bagong title o bagong description, at hindi tumatanggap ang easyCoexistence ng comment event mula sa LinkedIn, kaya walang ipinapasa ang alinman sa dalawa. Sa halip, nagsusuri ang agent: ibinabalik ng list_youtube_comments ang mga thread ng isang video o ng buong channel, kasama ang mga naka-hold for review, at ibinabalik ng list_linkedin_comments ang mga comment ng isang post o ang mga reply sa ilalim nito. Sa n8n, Make o Zapier, sinisimulan ng schedule trigger ang pagsusuri; sa sariling code ninyo, kukunin ng cron job ang credentials ng channel at direktang tatawagin ang commentThreads ng YouTube o ang comments endpoint ng LinkedIn.

Paano ito i-set up

  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.

Mga karaniwang pagkakamali

  • Pag-check ng HMAC sa parsed JSON. Sakop ng signature ang raw body byte sa byte, at kapag inulit ang serialization ng parsed object, nagbabago ang mga byte na iyon, kaya i-verify muna bago i-parse.
  • Paggamit ng iisang secret para sa bawat account. Bawat account ay nagsa-sign gamit ang sarili nitong secret, kaya hanapin ito gamit ang account_id ng event bago ihambing ang v1.
  • Muling pagtatakda ng destination nang hindi ina-update ang endpoint ninyo. Bawat tawag ay gumagawa ng bagong secret at agad na humihinto sa pag-sign ang luma, kaya itabi kaagad ang bago.
  • Pagbibigay ng URL na nagre-redirect. Hindi sumusunod sa redirect ang forwarding, kaya nawawala ang event kapag lumipat sa bagong path o host; itakda ang panghuling address.
Ginagawa ito gamit ang EasyCoexistence

Ipinapadala ng easyCoexistence ang comments, mentions at DMs ng Instagram at Facebook, pati comments ng TikTok, sa endpoint ninyo habang nangyayari, naka-sign bawat account, at ipinapasa ang mga mensahe ng WhatsApp sa server ninyo, para maabot ng mga AI agent ninyo ang mga customer sa bawat network sa pamamagitan ng opisyal na API nito, habang may 24/7 na pagmo-monitor sa bawat koneksyon. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdadagdag kayo ng koneksyon, na may unang 3 araw na free trial.

Mga madalas itanong

Paano dumarating sa endpoint ninyo ang mga mensahe mula sa numero sa WhatsApp?

Sa dalawang paraan. Diretsong inihahatid ng set_webhook_destination ang mga ito sa server ninyo, habang ipinapasa ng set_inbound_mode na may forward_url ang mga ito ng easyCoexistence na naka-sign gamit ang X-EC-Signature, na nagre-retry nang may backoff.

Puwede bang dumating nang dalawang beses ang parehong event?

Puwede, kaya i-deduplicate gamit ang sariling ID ng network, gaya ng comment ID o message mid. Maaari ring magdulot ng duplicate ang mga retry ng Meta sa delivery ng WhatsApp na hindi tinanggap ng server ninyo, nang hanggang 7 araw.

Puwede bang tumanggap ang isang endpoint ng event mula sa maraming account?

Oo. Dala ng bawat event ang platform at account_id, kaya puwedeng pagsilbihan ng isang URL ang maraming account, basta sinusuri nito ang bawat signature gamit ang sariling secret ng account na iyon.

Magkano ang gastos ng easyCoexistence para sa social media webhooks?

US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdadagdag ng koneksyon at pareho sa bawat network. Kasama ang forwarding, MCP server at Partner API, na may unang 3 araw na free trial.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong