Sosiaalisen median webhookit: kommentit, maininnat ja viestit yhteen päätepisteeseen
easyCoexistence välittää sosiaalisen median tapahtumat omaan HTTPS-päätepisteeseesi heti, kun ne tapahtuvat: Instagramin ja Facebookin kommentit, maininnat ja DM:t sekä TikTokin kommentit. Jokainen saapuu yhteen kääreeseen, jonka sisällä on verkoston oma tapahtuma muuttumattomana. Kääre on allekirjoitettu tilikohtaisesti X-EC-Signature-otsakkeella. Ota välitys käyttöön tilikohtaisesti set_social_webhook_destination-työkalulla Claudesta tai ChatGPT:stä, tai Partner API:n kautta. WhatsApp-numeron viestit tulevat myös palvelimellesi.
- Kommentit, maininnat ja DM:t heti, kun ne tapahtuvat
- Yksi kääre, allekirjoitettu jokaiselle tilille
- Asetus Claudesta, ChatGPT:stä tai Partner API:sta
Ei veloituksia 3 päivään. Peruuta milloin tahansa.
Kuinka monta kertaa easyCoexistence lähettää kunkin välitetyn sosiaalisen median tapahtuman; se ei säilytä kopiota, joten mitään ei lähetetä myöhemmin uudelleen.
Kuinka nopeasti TikTokin comment.update-webhookin ilmoittaa, että kommentti on luotu, poistettu tai että sen näkyvyys muuttuu omistetun tilin julkisissa videoissa.
Missä Instagram Login -sovellukset vastaanottavat @-maininnat: kommentti-webhookin ilmoituksen sisällä, ei omana kenttänään.
Mitä YouTuben push-ilmoitukset kertovat kanavasta: uuden latauksen, uuden otsikon tai uuden kuvauksen.
Kuinka kauan Meta yrittää uudelleen WhatsApp-webhookia, jonka palvelimesi ei hyväksynyt, mikä voi aiheuttaa kaksoiskappaleita.
Mitä tapahtumia kukin verkosto lähettää?
Instagram, Facebook ja TikTok lähettävät tapahtumia easyCoexistenceen, joka välittää jokaisen tapahtuman tilille asettamaasi URL-osoitteeseen. Instagram lähettää uudet kommentit, ja @-maininnat tulevat kommentti-ilmoituksen sisällä, sekä DM-viestit. Facebook-sivu lähettää syötteen toimintaa, johon kuuluvat uudet kommentit, Messengerin viestit ja sivun maininnat. TikTok lähettää comment.update-tapahtuman, joka laukeaa, kun kommentti luodaan, poistetaan tai sen näkyvyys muuttuu.
YouTube ja LinkedIn eivät lähetä easyCoexistenceen kommentti- tai viestitapahtumia, joten agentti lukee niiden kommentit pyynnöstä. WhatsApp-numero toimii omalla reitillään: Meta toimittaa viestit suoraan palvelimellesi, tai easyCoexistence välittää ne allekirjoitettuina, kun numero toimii hallitussa tilassa.
| What arrives | Sent by | |
|---|---|---|
| Comments, mentions and DMs | easyCoexistence, signed per account | |
| Feed activity, Messenger and mentions | easyCoexistence, signed per account | |
| TikTok | comment.update events | easyCoexistence, signed per account |
| Messages and echoes from the app | Meta directly, or easyCoexistence in managed mode | |
| YouTube | No comment events | Read with list_youtube_comments |
| No comment events | Read with list_linkedin_comments |
Miltä välitetty tapahtuma näyttää?
Sama JSON-kääre kaikissa verkoissa, lähetetty Content-Type-otsakkeella application/json: platform eli verkosto; account_id eli tunnus, jota MCP-työkalut ja Partner API käyttävät; external_id eli tilin tunnus verkostossa; ja entry eli verkoston oma tapahtuma sellaisena kuin se saapui. Instagramissa ja Facebookissa entry on Metan webhook-merkintä, jonka changes-kenttä kattaa kommentit ja maininnat ja messaging-kenttä DM-viestit. TikTokissa se sisältää comment.update-tapahtuman, jossa comment_id, video_id ja parent_comment_id ovat merkkijonoja, joten 64-bittisiä tunnuksia ei pyöristetä. Messengerin viesti saapuu näin:
{
"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?" }
}
]
}
}Miten X-EC-Signature vahvistetaan?
Allekirjoitussalaisuudella, joka palautetaan, kun asetat kohteen. Se on tilikohtainen ja näytetään vain kerran. Otsake on muotoa t=<unix>,v1=<hex>, ja v1 on HMAC-SHA256 aikaleimasta, pisteestä ja pyynnön raakarungosta, avaimena tuo salaisuus. Lue runko tavuina ennen jäsentämistä, hylkää aikaleima, joka poikkeaa kellostasi yli 5 minuuttia, hae salaisuus tapahtuman account_id-kentän perusteella ja vertaa kahta tiivistettä vakioajassa. Vastaa sitten 2xx ja aseta työ jonoon. PHP:ssä tähän menee muutama rivi:
<?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 resentMiten välitys otetaan käyttöön tilillä?
Avustajalta tai omasta backendistäsi. Pyydä Claudea tai ChatGPT:tä ajamaan set_social_webhook_destination tilille ja HTTPS-URL-osoitteesi kanssa, tai kutsu PUT /api/v1/channels/:id/webhook Partner API:ssa ec_live_-avaimellasi ja rungolla, joka sisältää url-kentän. Molemmat palauttavat tilin signing_secretin kerran, joten tallenna se account_id:n kohdalle heti. Kutsun uudelleen toistaminen luo uuden salaisuuden, ja url-arvo null kytkee välityksen pois.
URL:n on oltava HTTPS julkisessa isännässä: yksityinen osoite hylätään asettaessa ja uudelleen toimituksessa. Yksi päätepiste voi palvella monta tiliä, koska jokainen tapahtuma nimeää account_id:n. WhatsApp-numeron kohdalla set_webhook_destination ohjaa Metan toimitukset sinulle, ja set_inbound_mode forward_url-kentällä välittää ne allekirjoitettuina.
Mitä tapahtuu, kun päätepisteesi on hidas tai alhaalla?
Tapahtumaa ei lähetetä uudelleen. easyCoexistence tekee yhden yrityksen, odottaa vastausta enintään 8 sekuntia, ei seuraa uudelleenohjauksia eikä säilytä kopiota, sillä uusintayritys tarkoittaisi asiakkaidesi kommenttien ja viestien tallentamista. Vastaa 2xx heti, kun allekirjoitus täsmää, tee hitaat työt jonosta ja poista kaksoiskappaleet verkoston omien tunnusten perusteella, kuten kommentin ID:n tai viestin mid-arvon, siltä varalta että tapahtuma saapuu kahdesti.
WhatsApp poikkeaa tästä. Suoratoimitusmoodissa Meta yrittää uudelleen toimitusta, jonka palvelimesi ei hyväksynyt, jopa 7 päivää. Hallitussa tilassa easyCoexistence jonottaa viestit forward_url-osoitteelle ja yrittää uudelleen porrastetusti. Partner-tilatapahtumat, kuten yhteyden katkeaminen, yritetään uudelleen noin 33 tunnin ajan.
Miten YouTuben ja LinkedInin kommentit päätyvät agentille?
Lukemalla ne aikataulun mukaan. YouTuben push-ilmoitukset kertovat uudesta latauksesta, uudesta otsikosta tai uudesta kuvauksesta, eivät kommenteista, ja easyCoexistence ei vastaanota LinkedInistä kommenttitapahtumia, joten kumpikaan ei välitä mitään. Agentti tarkistaa itse: list_youtube_comments palauttaa videon ketjut tai koko kanavan, mukaan lukien moderointiin pidätetyt, ja list_linkedin_comments palauttaa julkaisun kommentit tai yhden kommentin vastaukset. n8n-, Make- tai Zapier-palvelussa aikataulutettu laukaisin käynnistää tarkistuksen. Omassa koodissasi cron-työ hakee kanavan tunnistetiedot ja kutsuu suoraan YouTuben commentThreads- tai LinkedInin comments-päätepistettä.
Näin otat sen käyttöön
- 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.
- Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
- Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
- Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.
Yleiset virheet
- HMAC:n tarkistaminen jäsennetyn JSON:in päältä. Allekirjoitus kattaa raakarungon tavu tavulta, ja jos jäsennetty objekti sarjallistetaan uudelleen, tavut muuttuvat, joten varmista ennen jäsentämistä.
- Yhden salaisuuden käyttäminen kaikille tileille. Jokainen tili allekirjoittaa omalla salaisuudellaan, joten hae se tapahtuman account_id:n perusteella ennen v1:n vertaamista.
- Kohteen asettaminen uudelleen ilman päätepisteen päivittämistä. Jokainen kutsu luo uuden salaisuuden ja vanha lakkaa allekirjoittamasta heti, joten tallenna uusi välittömästi.
- URL, joka uudelleenohjaa. Välitykset eivät seuraa uudelleenohjauksia, joten siirto uuteen polkuun tai isäntään menettää tapahtuman. Aseta lopullinen osoite.
easyCoexistence välittää Instagramin ja Facebookin kommentit, maininnat ja DM-viestit sekä TikTokin kommentit päätepisteeseesi heti, kun ne tapahtuvat, allekirjoitettuina tilikohtaisesti, ja ohjaa WhatsApp-viestit palvelimellesi. Tekoälyagenttisi kuulevat asiakkaista kunkin verkoston virallisen API:n kautta, ja jokaista yhteyttä valvotaan 24/7. Hinta alkaen US$ 9 yhteydeltä kuukaudessa, laskien US$ 0,75:een yhteyksiä lisättäessä. Ensimmäiset 3 päivää ovat ilmainen kokeilu.
Usein kysytyt kysymykset
Miten WhatsApp-numeron viestit päätyvät päätepisteeseeni?
Kahdella tavalla. set_webhook_destination saa Metan toimittamaan ne suoraan palvelimellesi, kun taas set_inbound_mode forward_url-kentällä saa easyCoexistencen välittämään ne allekirjoitettuina X-EC-Signature-otsakkeella, yrittäen uudelleen porrastetusti.
Voiko sama tapahtuma saapua kahdesti?
Voi, joten poista kaksoiskappaleet verkoston omien tunnusten perusteella, kuten kommentin ID:n tai viestin mid-arvon. Myös Metan uusintayritykset WhatsApp-toimitukselle, jota palvelimesi ei hyväksynyt, jopa 7 päivää, voivat tuoda kaksoiskappaleita.
Voiko yksi päätepiste vastaanottaa tapahtumia useilta tileiltä?
Kyllä. Jokainen tapahtuma kantaa mukanaan platform- ja account_id-kentät, joten yksi URL-osoite voi palvella monta tiliä, kunhan se tarkistaa jokaisen allekirjoituksen kyseisen tilin omalla salaisuudella.
Mitä easyCoexistence maksaa sosiaalisen median webhookeista?
Hinta alkaen US$ 9 yhteydeltä kuukaudessa, laskien US$ 0,75:een yhteyksiä lisättäessä, ja se on sama jokaisessa verkossa. Välitys, MCP-palvelin ja Partner API ovat mukana. Ensimmäiset 3 päivää ovat ilmainen kokeilu.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu