Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Instagram webhook događaji: komentari, spominjanja i DM-ovi

Instagram webhook događaji javljaju aktivnost na profesionalnom računu čim se dogodi: nove komentare, @spominjanja i DM-ove. Meta šalje svaki od njih kao JSON metodom POST na HTTPS endpoint povezane aplikacije i ponovno pokušava neuspjelu isporuku na njega do 36 sati. easyCoexistence svaki događaj jednom prosljeđuje na vaš endpoint, potpisan za svaki račun, bez ponovnih pokušaja. Uz Instagram Login, spominjanja stižu unutar obavijesti o komentarima.

36 hours

Koliko dugo Meta ponavlja neuspjelu isporuku na endpoint aplikacije prije nego je odbaci.

1,000

Većinu ažuriranja Meta grupira u jednu webhook isporuku, iako grupiranje ne jamči.

is_echo

Oznaka koju Meta postavlja na događaje poruka koje je sam račun poslao.

Public

Samo medij na javnim računima pokreće obavijesti o komentarima i spominjanjima.

Koji su događaji?

Za profesionalni račun povezan s Instagram Loginom, tri vrste aktivnosti stižu kao događaji:

  • Komentari: novi komentar na medij računa, s ID-jem komentara, Instagram-ovim ID-jem i korisničkim imenom autora, tekstom te ID-jem i vrstom medija.
  • Spominjanja: uz Instagram Login stižu unutar obavijesti o komentarima, a ne kao zasebno polje.
  • Poruke: DM računu, sa pošiljateljem, primateljem, vremenskom oznakom i samom porukom, uključujući tekst, privitke i odgovore na Story.

Kako događaji stižu na vaš endpoint?

Meta isporučuje Instagram webhookove aplikaciji s kojom je račun povezan. easyCoexistence ih prima i prosljeđuje svaki na HTTPS endpoint koji ste postavili za taj račun, čim stigne, potpisan tajnim ključem za taj račun.

Endpoint postavite alatom set_social_webhook_destination iz Claudea ili ChatGPT-ja ili putem Partner API-ja, na PUT /channels/:id/webhook. Tajni ključ za potpisivanje prikazuje se samo jednom, ponovno postavljanje endpointa izdaje novi, a slanje null kao URL-a isključuje proslijeđivanje.

Kako izgleda isporuka?

POST s JSON tijelom koje sadrži platform, account_id koji vraća list_social_accounts za vezu, external_id Instagram računa i entry: webhook zapis za događaj, nepromijenjen. DM stiže na isti način, s nizom messaging umjesto changes. Novi komentar izgleda ovako:

A forwarded comment event
{
  "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>" }
        }
      }
    ]
  }
}

Kako provjeriti isporuku?

Svaka isporuka nosi zaglavlje X-EC-Signature oblika t=<unix>,v1=<hex>, gdje je v1 HMAC-SHA256 vremenske oznake, točke i neobrađenog tijela zahtjeva, ključen tajnim ključem za potpisivanje računa. Izračunajte ga nad neobrađenim tijelom točno kako je primljeno, usporedite u stalnom vremenu i odbacite vremensku oznaku stariju od 5 minuta.

Node.js: verifying X-EC-Signature
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));
}

Ponavlja li se isporuka?

Ne od strane easyCoexistence: proslijeđivanje šalje svaki događaj jednom, u memoriji, i ne čuva kopiju za ponovni pokušaj. Odgovorite 2xx brzo, a obradu obavite poslije, i spremite što god trebate čim stigne, jer Meta sama ne čuva povijest obavijesti koju bi se moglo naknadno dohvatiti.

Meta sama ponavlja neuspjelu isporuku aplikaciji do 36 sati, pa isti događaj ponekad može doći dvaput: uklonite duplikate prema ID-ju komentara ili mid-u poruke.

Što još handler treba provjeriti?

Nekoliko detalja u payloadima koji zbune prvi handler:

  • is_echo: događaj poruke s is_echo postavljenim na true poslao je sam račun, pa mu ne treba odgovor.
  • Odgovori na Story: DM koji odgovara na Story nosi reply_to s ID-jem i URL-om Storyja.
  • Spominjanja u Storyju: stižu kao poruka čija je vrsta privitka story_mention.
  • time: kada je Meta poslala obavijest, a ne kada je komentar ili poruka nastala; vremenska oznaka poruke nalazi se u njezinom unosu messaging.
  • ID-jevi albuma: događaji komentara ih ne sadrže; album potražite pomoću ID-ja komentara.

Uobičajene pogreške

  • Obrada prije odgovora. Proslijeđivanje se ne ponavlja, pa odmah vratite 2xx i događaj obradite poslije.
  • Provjera potpisa na raščlanjenom JSON-u. HMAC izračunajte nad neobrađenim tijelom točno kako je stiglo.
  • Odgovaranje na echo poruke. Poruka s is_echo postavljenim poslao je račun, a odgovor na nju pokreće petlju.
  • Preskakanje uklanjanja duplikata. Meta može isti događaj ponovno isporučiti nakon pogreške, pa ključ postavite na ID komentara ili mid poruke.
Radite ovo uz EasyCoexistence

easyCoexistence prosljeđuje komentare, spominjanja i DM-ove Instagram računa na vaš HTTPS endpoint čim stignu, potpisane tajnim ključem za taj račun i bez kopije zadržane usput. Uključite ih alatom set_social_webhook_destination iz Claudea ili ChatGPT-ja ili putem Partner API-ja. US$ 9 do US$ 0,75 po vezi mjesečno, s padom kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Što znači polje time u Instagram webhooku?

Kada je Meta poslala obavijest, a ne kada je komentar ili poruka nastala. Vremenska oznaka DM-a nalazi se u njegovom unosu messaging.

Ponavlja li Meta neuspjele Instagram webhook isporuke?

Da. Meta neuspjelu isporuku aplikaciji ponovno pokušava do 36 sati, pa isti događaj ponekad može stići dvaput: uklonite duplikate prema ID-ju komentara ili mid-u poruke. easyCoexistence svaki događaj prosljeđuje na vaš endpoint jednom, zato brzo odgovorite 2xx.

Koliko ažuriranja jedna Instagram webhook isporuka može sadržavati?

Do 1.000 kad ih Meta grupira, iako grupiranje ne jamči. Prođite kroz cijeli niz entry, a ne samo prvu stavku.

Imaju li spominjanja vlastiti događaj?

Ne uz Instagram Login. Meta spominjanja uključuje u obavijest o komentarima, pa stižu istim putem kao i komentari.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na