IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Webhooks za mitandao ya kijamii: maoni, kutajwa na ujumbe hadi endpoint moja

easyCoexistence inapeleka matukio ya mitandao ya kijamii kwa endpoint yako ya HTTPS yanapotokea: maoni, kutajwa na DM kutoka Instagram na Facebook, na maoni kutoka TikTok. Kila tukio hufika katika bahasha moja ya JSON, tukio asili la mtandao likibaki bila kubadilishwa, na likisainiwa kwa kila akaunti kwa X-EC-Signature. Washa kwa kila akaunti kwa kutumia set_social_webhook_destination kutoka Claude au ChatGPT, au kupitia Partner API. Ujumbe wa nambari ya WhatsApp pia hufika kwenye seva yako.

  • Maoni, kutajwa na DM yanapotokea
  • Bahasha moja, iliyosainiwa kwa kila akaunti
  • Weka kutoka Claude, ChatGPT au Partner API
Anza kipindi cha majaribio bila malipo

Hakuna kinachotozwa kwa siku 3. Ghairi wakati wowote.

API rasmi pekeeMCP kwa Claude na ChatGPTKila muunganisho hufuatiliwa 24/7Siku 3 bila malipo
1 attempt

Mara ngapi easyCoexistence hutuma kila tukio la mtandao lililopelekwa; haihifadhi nakala, kwa hiyo hakuna kinachotumwa tena baadaye.

Within 5 minutes

Muda ambao webhook ya comment.update ya TikTok huchukua kuripoti maoni yaliyoundwa, yaliyofutwa au yaliyobadilisha mwonekano kwenye video za umma za akaunti inayomilikiwa.

In comments

Mahali programu za Instagram Login hupokea kutajwa kwa @: ndani ya arifa ya webhook ya maoni, si kama sehemu yao yenyewe.

3 events

Kile ambacho arifa za kusukuma za YouTube huripoti kwa kituo: upakiaji mpya, kichwa kipya au maelezo mapya.

7 days

Muda ambao Meta huendelea kujaribu tena webhook ya WhatsApp ambayo seva yako haikukubali, jambo linaloweza kuleta nakala.

Ni matukio gani kila mtandao hutuma?

Instagram, Facebook na TikTok husukuma matukio kwa easyCoexistence, ambayo huyapitisha kila moja kwenye URL uliyoweka kwa akaunti hiyo. Instagram hutuma maoni mapya, huku kutajwa kwa @ kukifika ndani ya arifa ya maoni, pamoja na DM. Ukurasa wa Facebook hutuma shughuli za mlisho, zinazojumuisha maoni mapya, pamoja na ujumbe wa Messenger na kutajwa kwa Ukurasa. TikTok hutuma tukio la comment.update, linalotumwa maoni yanapoundwa, yanapofutwa au yanapobadilisha mwonekano.

YouTube na LinkedIn hazituma easyCoexistence matukio yoyote ya maoni au ujumbe, kwa hiyo wakala wa AI husoma maoni yao anapoomba. Nambari ya WhatsApp hufanya kazi kwenye njia yake yenyewe: Meta huwasilisha ujumbe wake moja kwa moja kwa seva yako, au easyCoexistence huupeleka ukiwa umesainiwa wakati nambari inaendeshwa katika hali ya usimamizi.

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

Tukio lililopelekwa linaonekanaje?

Bahasha ile ile ya JSON kwenye kila mtandao, inayotumwa kwa Content-Type application/json: platform, yaani mtandao wenyewe; account_id, kitambulisho ambacho zana za MCP na Partner API hutumia; external_id, kitambulisho cha akaunti kwenye mtandao; na entry, tukio la mtandao lenyewe kama lilivyofika. Kwa Instagram na Facebook, entry ni webhook entry ya Meta, yenye changes kwa maoni na kutajwa, na messaging kwa DM. Kwa TikTok ina tukio la comment.update, yenye comment_id, video_id na parent_comment_id kama mistari, kwa hiyo vitambulisho vya 64-bit havipunguzwi. Ujumbe wa Messenger hufika hivi:

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

Unathibitishaje X-EC-Signature?

Kwa siri ya kutia sahihi inayorudishwa unapoweka lengwa, ya kipekee kwa akaunti hiyo na inayoonyeshwa mara moja tu. Kichwa kinasomeka t=<unix>,v1=<hex>, na v1 ni HMAC-SHA256 ya muhuri wa muda, nukta, na mwili ghafi wa ombi, ukitumia siri hiyo kama ufunguo. Soma mwili kama baiti kabla ya kuuchambua, kataa muhuri wa muda unaozidi dakika 5 kutoka saa yako, tafuta siri kwa account_id ya tukio, kisha linganisha digesti mbili kwa muda usiobadilika. Kisha jibu 2xx na weka kazi kwenye foleni. Kwa PHP, hilo linachukua mistari michache:

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

Unawashaje usambazaji kwa akaunti?

Kutoka kwa msaidizi wa AI au kutoka backend yako. Muombe Claude au ChatGPT aendeshe set_social_webhook_destination kwa akaunti na URL yako ya HTTPS, au tuma PUT /api/v1/channels/:id/webhook kwenye Partner API ukitumia ufunguo wako wa ec_live_ na mwili wenye url. Zote mbili hurudisha signing_secret ya akaunti mara moja, kwa hiyo ihifadhi pamoja na account_id hapo hapo. Kuita tena yoyote kati ya hizo hutoa siri mpya, na url ya null huzima usambazaji.

URL lazima iwe HTTPS kwenye host ya umma: anwani ya faragha hukataliwa unapoiweka na tena wakati wa kutuma. Endpoint moja inaweza kuhudumia akaunti nyingi, kwa kuwa kila tukio hutaja account_id yake. Kwa nambari ya WhatsApp, set_webhook_destination huelekeza uwasilishaji wa Meta kwako, na set_inbound_mode yenye forward_url huyapeleka yakiwa yamesainiwa.

Nini hutokea endpoint yako ikiwa polepole au imezimika?

Tukio halitumwi tena. easyCoexistence hufanya jaribio moja, husubiri hadi sekunde 8 kwa jibu, haifuati uelekezaji wowote na haihifadhi nakala, kwa sababu kujaribu tena kungemaanisha kuhifadhi maoni na jumbe za wateja wako. Jibu 2xx mara tu sahihi inapothibitika, fanya kazi nzito kutoka kwenye foleni, na ondoa nakala kwa kutumia vitambulisho vya mtandao wenyewe, kama kitambulisho cha maoni au mid ya ujumbe, endapo tukio litafika mara mbili.

WhatsApp ni tofauti. Katika hali ya moja kwa moja, Meta hujaribu tena uwasilishaji ambao seva yako haikukubali kwa hadi siku 7. Katika hali ya usimamizi, easyCoexistence huweka ujumbe kwenye foleni kwa forward URL yako na kujaribu tena kwa kuchelewesha zaidi kila mara. Matukio ya hali ya Partner, kama muunganisho kukatika, hujaribiwa tena kwa takriban saa 33.

Maoni ya YouTube na LinkedIn hufikaje kwa wakala?

Kwa kuyasoma kwa ratiba. Arifa za kusukuma za YouTube huripoti upakiaji mpya, kichwa kipya au maelezo mapya, si maoni, na easyCoexistence haipokei matukio yoyote ya maoni kutoka LinkedIn, kwa hiyo hakuna kinachopelekwa. Wakala hukagua badala yake: list_youtube_comments hurudisha mijadala ya video au ya kituo kizima, ikiwa pamoja na ile iliyo kwenye ukaguzi, na list_linkedin_comments hurudisha maoni ya chapisho au majibu chini ya moja. Katika n8n, Make au Zapier, trigger ya ratiba huanzisha ukaguzi; katika msimbo wako mwenyewe, kazi ya cron huchukua vitambulisho vya kituo na kuita moja kwa moja endpoint ya commentThreads ya YouTube au ya maoni ya LinkedIn.

Jinsi ya kuisanidi

  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.

Makosa ya kawaida

  • Kukagua HMAC juu ya JSON iliyochambuliwa. Sahihi inafunika mwili ghafi baiti kwa baiti, na kuandika upya kitu kilichochambuliwa hubadilisha baiti hizo, kwa hiyo thibitisha kabla ya kuchambua.
  • Kutumia siri moja kwa akaunti zote. Kila akaunti hutia sahihi kwa siri yake, kwa hiyo itafute kwa account_id ya tukio kabla ya kulinganisha v1.
  • Kuweka lengwa tena bila kusasisha endpoint yako. Kila wito hutoa siri mpya na ya zamani huacha kutia sahihi mara moja, kwa hiyo ihifadhi mpya papo hapo.
  • Kutoa URL inayoelekeza upya. Usambazaji hauifuati elekezi yoyote, kwa hiyo kuhamia njia mpya au host mpya hupoteza tukio; weka anwani ya mwisho.
Kufanya hili ukitumia EasyCoexistence

easyCoexistence hutuma maoni, kutajwa na DM za Instagram na Facebook, pamoja na maoni ya TikTok, kwa endpoint yako kadri yanavyotokea, yakisainiwa kwa kila akaunti, na huelekeza ujumbe wa WhatsApp kwa seva yako, ili mawakala wako wa AI wasikie kutoka kwa wateja kupitia API rasmi ya kila mtandao, huku kila muunganisho ukifuatiliwa saa 24. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inayopungua unapoongeza muunganisho, huku siku 3 za kwanza zikiwa bila malipo.

Maswali yanayoulizwa mara kwa mara

Ujumbe wa nambari ya WhatsApp hufikaje kwenye endpoint yangu?

Kwa njia mbili. set_webhook_destination huelekeza Meta kuwasilisha ujumbe moja kwa moja kwa seva yako, wakati set_inbound_mode yenye forward_url huelekeza easyCoexistence kuupeleka ukiwa umesainiwa kwa X-EC-Signature, ukijaribu tena kwa kuchelewesha zaidi kila mara.

Je, tukio moja linaweza kufika mara mbili?

Linaweza, kwa hiyo ondoa nakala kwa kutumia vitambulisho vya mtandao wenyewe, kama kitambulisho cha maoni au mid ya ujumbe. Majaribio ya Meta ya kuwasilisha tena ujumbe ambao seva yako haikukubali, hadi siku 7, nayo yanaweza kuleta nakala.

Je, endpoint moja inaweza kupokea matukio kutoka akaunti kadhaa?

Ndiyo. Kila tukio hubeba platform na account_id, kwa hiyo URL moja inaweza kuhudumia akaunti nyingi, mradi inakagua kila sahihi kwa siri ya akaunti hiyo yenyewe.

easyCoexistence inagharimu kiasi gani kwa webhook za mitandao ya kijamii?

US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inayopungua unapoongeza muunganisho, na kiwango kile kile kwenye kila mtandao. Usambazaji, seva ya MCP na Partner API vimejumuishwa, huku siku 3 za kwanza zikiwa bila malipo.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye