Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Instagram webhook događaji: komentari, pominjanja i direktne poruke

Instagram webhook događaji prijavljuju aktivnost na profesionalnom nalogu čim se dogodi: nove komentare, @pominjanja i direktne poruke. Meta šalje svaki kao JSON POST na HTTPS endpoint povezane aplikacije i ponavlja neuspelu isporuku na njega do 36 sati. easyCoexistence prosleđuje svaki događaj vašem endpointu jednom, potpisan po nalogu, bez ponavljanja. Uz Instagram Login, pominjanja stižu unutar obaveštenja o komentarima.

36 hours

Koliko dugo Meta nastavlja da ponavlja neuspelu isporuku na endpoint aplikacije pre nego što je odbaci.

1,000

Većinu ažuriranja Meta grupiše u jednu webhook isporuku, ali grupisanje nije zagarantovano.

is_echo

Oznaka koju Meta postavlja na događaje poruka koje je poslao sam nalog.

Public

Samo medijski sadržaj na javnim nalozima pokreće obaveštenja o komentarima i pominjanjima.

Koji događaji postoje?

Za profesionalni nalog povezan preko Instagram Login-a, tri vrste aktivnosti stižu kao događaji:

  • Komentari: novi komentar na medij naloga, sa ID-jem komentara, Instagram ID-jem autora, korisničkim imenom, tekstom, te ID-jem i tipom medija.
  • Pominjanja: uz Instagram Login stižu unutar obaveštenja o komentarima, a ne kao zasebno polje.
  • Poruke: direktna poruka nalogu, sa pošiljaocem, primaocem, vremenskom oznakom i samom porukom, uključujući tekst, priloge i odgovore na Story.

Kako događaji stižu do vašeg endpoint-a?

Meta isporučuje Instagram webhook-ove aplikaciji na koju je nalog povezan. easyCoexistence ih prima i svaki prosleđuje HTTPS endpoint-u koji ste podesili za taj nalog, čim stigne, potpisan tajnim ključem za taj nalog.

Endpoint podesite funkcijom set_social_webhook_destination iz Claude ili ChatGPT-ja, ili preko Partner API-ja putem PUT /channels/:id/webhook. Potpisni ključ se prikazuje jednom, ponovno podešavanje endpoint-a izdaje novi, a prosleđivanje isključujete tako što za URL prosledite null.

Kako izgleda isporuka?

POST zahtev sa JSON telom koje sadrži platform, account_id koji list_social_accounts daje za vezu, external_id Instagram naloga i entry: webhook entry koji Meta šalje za događaj, nepromenjen. Direktna poruka stiže na isti način, ali sa nizom messaging umesto 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 proveravate isporuku?

Svaka isporuka nosi zaglavlje X-EC-Signature u obliku t=<unix>,v1=<hex>, gde je v1 HMAC-SHA256 od vremenske oznake, tačke (.) i neobrađenog tela zahteva, a ključ je tajni ključ naloga. Izračunajte ga nad neobrađenim telom tačno onako kako je primljeno, uporedite u konstantnom 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));
}

Da li se isporuka ponavlja?

Ne od strane easyCoexistence: prosleđivanje šalje svaki događaj jednom, u memoriji, i ne čuva kopiju za ponovno slanje. Brzo odgovorite statusom 2xx, a posao obavite posle, i sačuvajte šta god vam treba čim stigne, jer ni Meta ne čuva istoriju prošlih obaveštenja koju je moguće upitati.

Sama Meta ponavlja neuspelu isporuku aplikaciji do 36 sati, pa isti događaj ponekad može da vam stigne dvaput: deduplikujte po ID-ju komentara ili polju mid poruke.

Šta još handler treba da proveri?

Nekoliko detalja u payload-ovima koje šalje Meta zbunjuje prve handlere:

  • is_echo: poruka sa is_echo postavljenim na true poslao je sam nalog, pa joj ne treba odgovor.
  • Odgovori na Story: direktna poruka koja odgovara na Story nosi reply_to sa ID-jem i URL-om Story-ja.
  • Pominjanja u Story-ju: stižu kao poruka čiji je tip priloga story_mention.
  • time: kada je Meta poslala obaveštenje, a ne kada je komentar ili poruka napisana; vremenska oznaka same poruke nalazi se u njenom messaging unosu.
  • ID-jevi albuma: događaji komentara ih ne sadrže; album potražite pomoću ID-ja komentara.

Česte greške

  • Obrada pre odgovora. Prosleđivanje ne ponavlja slanje, zato odmah vratite 2xx i događaj obradite posle.
  • Provera potpisa na parsiranom JSON-u. HMAC izračunajte nad neobrađenim telom tačno onako kako je stiglo.
  • Odgovaranje na eho. Poruka sa postavljenim is_echo je ona koju je poslao nalog, a odgovor na nju pokreće petlju.
  • Preskakanje deduplikacije. Meta može ponovo da isporuči isti događaj posle greške, pa ključ postavite na ID komentara ili polje mid poruke.
Ovo radite uz EasyCoexistence

easyCoexistence prosleđuje komentare, pominjanja i direktne poruke Instagram naloga na vaš HTTPS endpoint čim stignu, potpisane tajnim ključem za taj nalog i bez čuvanja kopije usput. Uključite ih funkcijom set_social_webhook_destination iz Claude ili ChatGPT-ja, ili preko Partner API-ja. Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Šta znači polje time u Instagram webhook-u?

Kada je Meta poslala obaveštenje, a ne kada je komentar ili poruka napisana. Vremenska oznaka same direktne poruke nalazi se u njenom messaging unosu.

Da li Meta ponavlja neuspele Instagram webhook isporuke?

Da. Meta ponavlja neuspelu isporuku aplikaciji do 36 sati, pa isti događaj ponekad može da stigne dvaput: deduplikujte po ID-ju komentara ili polju mid poruke. easyCoexistence prosleđuje svaki događaj vašem endpoint-u jednom, zato brzo odgovorite statusom 2xx.

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

Do 1.000 kada Meta ih grupiše, ali grupisanje nije zagarantovano. Prođite kroz ceo niz entry umesto da čitate samo prvi element.

Da li pominjanja imaju poseban događaj?

Ne uz Instagram Login. Meta uključuje pominjanja u obaveštenje o komentarima, pa stižu istim putem kao komentari.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na