Instagram-webhookit: kommentit, maininnat ja DM-viestit
Instagram-webhook-tapahtumat kertovat ammattilaistilin toiminnasta heti, kun se tapahtuu: uusista kommenteista, @-maininnoista ja DM-viesteistä. Meta lähettää jokaisen tapahtuman POST-pyynnöllä JSON-muodossa yhdistetyn sovelluksen HTTPS-endpointiin ja yrittää epäonnistunutta toimitusta sinne uudelleen jopa 36 tunnin ajan. easyCoexistence välittää jokaisen tapahtuman päätepisteeseesi kerran, allekirjoitettuna tilikohtaisesti, ilman uudelleenyrityksiä. Instagram Loginilla maininnat tulevat kommenttiilmoituksen sisällä.
Kuinka kauan Meta yrittää epäonnistunutta toimitusta uudelleen sovelluksen endpointiin ennen kuin luopuu siitä.
Useimmat päivitykset Meta koostaa yhdeksi webhook-toimitukseksi, vaikka se ei takaa koostamista.
Lippu, jonka Meta asettaa tapahtumiin, jotka tili itse lähetti.
Vain julkisten tilien media laukaisee kommentti- ja maininta-ilmoitukset.
Mitä tapahtumia on?
Ammattilaistilille, joka on yhdistetty Instagram Loginilla, kolme aktiviteettityyppiä saapuu tapahtumina:
- Kommentit: uusi kommentti tilin mediaan, kommentin ID, kirjoittajan Instagram-kohtainen ID ja käyttäjänimi, teksti sekä median ID ja tyyppi.
- Maininnat: Instagram Loginilla ne tulevat kommenttiilmoituksen sisällä eikä omana kenttänään.
- Viestit: DM-viesti tilille, jossa on lähettäjä, vastaanottaja, aikaleima ja itse viesti, mukaan lukien teksti, liitteet ja Story-vastaukset.
Miten tapahtumat saapuvat endpointiisi?
Meta toimittaa Instagram-webhookit sovellukselle, johon tili on yhdistetty. easyCoexistence vastaanottaa ne ja välittää jokaisen eteenpäin sille tilille asettamaasi HTTPS-endpointiin heti saapuessaan, allekirjoitettuna kyseisen tilin salaisuudella.
Aseta endpoint set_social_webhook_destination-työkalulla Claudesta tai ChatGPT:stä, tai Partner API:lla reitillä PUT /channels/:id/webhook. Allekirjoitussalaisuus näytetään kerran, endpointin uudelleen asettaminen luo uuden, ja URL:ksi null-arvon antaminen sammuttaa välityksen.
Miltä toimitus näyttää?
POST-pyyntö JSON-rungolla, joka sisältää platform-kentän, account_id:n, jonka list_social_accounts palauttaa yhteydelle, Instagram-tilin external_id:n ja entry-kentän: Metan webhook-entry tapahtumalle muuttumattomana. DM saapuu samalla tavalla, mutta changes-taulukon sijaan on messaging-taulukko. Uusi kommentti näyttää tältä:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}Miten toimituksen voi todentaa?
Jokaisessa toimituksessa on X-EC-Signature-otsikko muodossa t=<unix>,v1=<hex>, jossa v1 on aikaleiman, pisteen ja raa'an pyynnön rungon HMAC-SHA256, avaimena tilin allekirjoitussalaisuus. Laske se raa'an pyynnön rungon yli juuri sellaisena kuin se saapui, vertaa vakioajassa ja hylkää aikaleima, joka on vanhempi kuin 5 minuuttia.
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}Yritetäänkö toimitusta uudelleen?
easyCoexistence ei toimita uudelleen: välitys lähettää jokaisen tapahtuman kerran muistissa eikä säilytä kopiota, josta voisi yrittää uudelleen. Vastaa nopeasti 2xx-koodilla ja tee työ myöhemmin. Tallenna tarvitsemasi heti saapuessaan, koska Meta ei myöskään säilytä historiaa aiemmista ilmoituksista, joita voisi myöskään kysellä.
Meta itse yrittää epäonnistunutta toimitusta sovellukseen uudelleen jopa 36 tunnin ajan, joten sama tapahtuma voi harvoin saapua kahdesti: poista kaksoiskappaleet kommentin ID:n tai viestin mid:n perusteella.
Mitä muuta käsittelijän pitää tarkistaa?
Muutama Metan payloadin yksityiskohta kompastuttaa ensimmäisen käsittelijän:
is_echo: viestitapahtuma, jonkais_echoon true, on tilin itse lähettämä, joten siihen ei tarvitse vastata.- Story-vastaukset: DM, joka vastaa Storyyn, sisältää
reply_to-kentän Storyn ID:n ja URL:n kanssa. - Story-maininnat: saapuvat viestinä, jonka liitetyyppi on
story_mention. - time: milloin Meta lähetti ilmoituksen, ei milloin kommentti tai viesti tehtiin. Viestin oma aikaleima on sen messaging-merkinnässä.
- Albumi-ID:t: kommenttitapahtumat eivät sisällä niitä, joten hae albumi kommentin ID:llä.
Yleiset virheet
- Työn tekeminen ennen vastaamista. Välitys ei yritä uudelleen, joten palauta 2xx heti ja käsittele tapahtuma myöhemmin.
- Allekirjoituksen tarkistaminen jäsennetystä JSON:ista. Laske HMAC raa'an rungon yli juuri sellaisena kuin se saapui.
- Kaikuihin vastaaminen. Viestitapahtuma, jonka is_echo on asetettu, on tilin lähettämä, ja siihen vastaaminen aloittaa silmukan.
- Deduplikoinnin ohittaminen. Meta voi toimittaa saman tapahtuman uudelleen virheen jälkeen, joten tunnista tapahtumat kommentin ID:n tai viestin mid:n perusteella.
easyCoexistence välittää Instagram-tilin kommentit, maininnat ja DM-viestit HTTPS-endpointiisi heti, kun ne saapuvat. Ne allekirjoitetaan tilikohtaisella salaisuudella, eikä välityksen aikana säilytetä kopiota. Ota käyttöön set_social_webhook_destination-työkalulla Claudesta tai ChatGPT:stä tai Partner API:lla. Hinta on US$ 9 yhteydeltä kuukaudessa ja laskee US$ 0,75:een, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Mitä Instagram-webhookin time-kenttä tarkoittaa?
Milloin Meta lähetti ilmoituksen, ei milloin kommentti tai viesti tehtiin. DM:n oma aikaleima on sen messaging-merkinnässä.
Yrittääkö Meta uudelleen epäonnistuneet Instagram-webhook-toimitukset?
Kyllä. Meta yrittää epäonnistunutta toimitusta sovellukseen uudelleen jopa 36 tunnin ajan, joten sama tapahtuma voi harvoin saapua kahdesti: poista kaksoiskappaleet kommentin ID:n tai viestin mid:n perusteella. easyCoexistence välittää jokaisen tapahtuman endpointiisi kerran, joten vastaa nopeasti 2xx-koodilla.
Kuinka monta päivitystä yhdessä Instagram-webhook-toimituksessa voi olla?
Jopa 1 000, kun Meta koostaa ne, vaikka Meta ei takaa koostamista. Käy läpi koko entry-taulukko sen sijaan, että lukisit vain ensimmäisen kohteen.
Onko maininnoilla oma tapahtumansa?
Ei Instagram Loginilla. Meta sisällyttää maininnat kommenttiilmoitukseen, joten ne saapuvat samaa reittiä kuin kommentit.
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