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

Webhook za poruke na Instagramu: sadržaj DM-a, eho-poruke i polja

Webhook polje messages za Instagram isporučuje DM-ove profesionalnog računa čim stignu: tekst, privitke, dijeljene objave, odgovore na Story i spominjanja, ugrađene odgovore i brisanja. Svaki događaj nalazi se u nizu messaging, s Instagram-scoped ID-em pošiljatelja, primateljem, vremenskom oznakom i objektom poruke. Poruke koje sam račun šalje stižu na istom polju s is_echo postavljenim na true.

easyCoexistence pretplaćuje svaki povezani Instagram račun na messages i proslijeđuje njegove DM-ove, uključujući eho-poruke, na vaš HTTPS endpoint čim stignu, potpisane tajnim ključem tog računa; prosljeđivanje ne zadržava kopiju, a DM-ovi se prema zadanim postavkama ne pohranjuju.

is_echo

Postavljeno na true kod događaja poruke za poruku koju je sam račun poslao.

24 hours

Standardni prozor za razmjenu poruka za većinu korisničkih radnji, unutar kojeg aplikacija može odgovoriti osobi.

ig_post

Vrsta privitka za dijeljenu objavu; stari tip dijeljenja podržavao se samo do 1. veljače 2026.

story_mention

Vrsta privitka DM događaja koji Meta šalje kad netko spomene račun u svojoj Story objavi.

2534041

Podkod pogreške pod kodom 200, kad je vlasnik računa onemogućio pristup izravnim porukama na Instagramu.

Kada se polje messages aktivira?

Kada osoba pošalje DM profesionalnom računu i kada račun pošalje DM. Metini primjeri i reference navode ove slučajeve, svaki kao događaj poruke s objektom poruke:

  • Tekst i mediji kao privitci: slike, video, zvuk i datoteke.
  • Dijeljena objava ili Reel, kao privitak ig_post, ig_reel ili reel.
  • Odgovor na Story računa, s reply_to.story, i Story koja spominje račun, kao privitak story_mention.
  • Ugrađeni odgovor na raniju poruku, s reply_to.mid, i brzi odgovor, s quick_reply.payload.
  • Poruka koju je osoba obrisala (is_deleted), nepodržani mediji (is_unsupported) i poruka od nekoga tko je kliknuo oglas Click-to-Direct (referral).
  • Poruka koju je račun poslao, koja se vraća s is_echo postavljenim na true.

Kako izgleda obavijest o porukama?

POST zahtjev čiji JSON ima object postavljen na instagram. Za razliku od komentara, poruka se nalazi u nizu messaging unutar elementa entry koji pripada računu, a svaki element sadrži sender, recipient, timestamp i message. Odgovor na Story računa izgleda ovako:

A messages notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "message": {
            "mid": "<MESSAGE_ID>",
            "text": "<MESSAGE_TEXT>",
            "reply_to": {
              "story": {
                "url": "<CDN_URL_FOR_THE_STORY>",
                "id": "<STORY_ID>"
              }
            }
          }
        }
      ]
    }
  ]
}

Što znači svako polje?

Polja koja Meta dokumentira za događaj poruke pod Instagram Loginom, od vanjskog prema unutarnjem:

  • entry[].id: ID profesionalnog računa. entry[].time: kada je Meta poslala obavijest; Metini primjeri poruka daju ga u milisekundama.
  • sender.id i recipient.id: kod dolazne DM poruke ID osobe vezan uz Instagram i ID računa; kod eho-poruke isti dva, obrnuto.
  • timestamp: kada je poruka poslana, u milisekundama u Metinim primjerima. Poruke sortirajte prema njemu, a ne prema redoslijedu dolaska.
  • message.mid: ID poruke, za uklanjanje duplikata, reakcije i odgovor na tu poruku s reply_to.mid.
  • message.text: uključen kad poruka sadrži tekst.
  • message.attachments[]: svaki s type i payloadom, obično url. Payload dijeljene objave ig_post dodaje ig_post_media_id i title, odnosno njezin naslov.
  • message.reply_to: mid za ugrađeni odgovor ili story s url-om i ID-em Story objave za odgovor na Story.
  • message.quick_reply.payload i message.referral: odabrani brzi odgovor te ref, ad_id, source, type i ads_context_data Click-to-Direct oglasa.
  • message.is_deleted, is_echo, is_self i is_unsupported: uključeni samo kad su istiniti.
  • message.admin_text i handoff_reason: u kvalificiranim aplikacijama obavijest da je Metina aplikacija, primjerice Meta Business Agent, predala razgovor; može stići bez mid-a ili teksta.

Kako rade eho-poruke?

Kad račun pošalje poruku, Meta za nju šalje i događaj poruke s is_echo postavljenim na true. sender.id je tada račun, a recipient.id ID osobe vezan uz Instagram. Testna poruka koju račun šalje sam sebi nosi i is_self. Eho-poruke bilježe što je račun rekao, što je potrebno dnevniku razgovora, ali obrađivač koji odlučuje hoće li odgovoriti mora ih preskočiti. Meta ne šalje eho-poruku kad račun reagira na poruku ili ukloni reakciju.

An echo of a message the account sent
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448061203,
      "messaging": [
        {
          "sender": { "id": "<IG_ID>" },
          "recipient": { "id": "<IGSID>" },
          "timestamp": 1793448060950,
          "message": {
            "mid": "<MESSAGE_ID>",
            "text": "<REPLY_TEXT>",
            "is_echo": true
          }
        }
      ]
    }
  ]
}

Na koji ID odgovarate?

Na sender.id, Instagram-scoped ID osobe. Meta ga stvara kad netko pošalje poruku računu ili prokomentira njegove medije, a vezan je uz tu osobu i taj račun. POST /<IG_ID>/messages s recipient.id postavljenim na njega šalje odgovor. Događaj ne nosi ime ni korisničko ime; GET /<IGSID> s poljima kao što su name i username ih vraća, jer je osoba koja je poslala poruku računu dala pristanak koji to pretraživanje zahtijeva.

Kako poruka otvara 24-satni prozor?

Aplikacija može poslati poruku osobi tek nakon što ona pošalje poruku računu i samo unutar standardnog prozora za razmjenu poruka koji otvara njezina radnja. Za većinu radnji traje 24 sata, a do 7 dana od prve poruke poslane nakon klika na oglas Click-to-Direct. Nova poruka od osobe otvara novi prozor, pa je njezina najnovija vremenska oznaka ona koju treba pratiti. Eho-poruka je poruka samog računa i ne produljuje ništa. Odgovore koje piše osoba može koristiti Metin zasebni 7-dnevni prozor Human Agent, označen s human_agent.

Što događaj poruke ne sadrži?

Nekoliko stvari koje bi obrađivač mogao tražiti nedostaje, prema Metinim referencama za poruke:

  • Ime ili korisničko ime osobe: samo Instagram-scoped ID, koji razrješava GET /<IGSID>.
  • Medij za jednokratni prikaz: stiže kao privremeni privitak bez URL-a.
  • Točna slika iz karusela: reakcija na jednu sliku u objavi karusela ili njezino proslijeđivanje prijavljuje prvu sliku.
  • Reakcije, izmjene i potvrde čitanja, koje dolaze na vlastitim poljima.
  • Oznaka pročitano: poruka isporučena webhookom ostaje nepročitana u Instagram pristiglo j pošti dok se ne pošalje odgovor.

Koja druga polja za poruke navodi Meta?

Metin popis polja i primjera za Instagram Login navodi ova polja uz messages, svako kao zaseban događaj poruke. easyCoexistence pretplaćuje svaki račun samo na messages, comments i mentions, pa nijedno od njih nije dio onoga što proslijeđuje:

  • message_reactions: osoba reagira na poruku ili ukloni reakciju, s reaction.mid, action postavljenim na react ili unreact, te reaction i emoji.
  • message_edit: osoba uredi poruku, s message_edit.mid, novim tekstom i num_edit.
  • messaging_postbacks: osoba dodirne icebreaker ili gumb predloška, s postback.mid, title i payload.
  • messaging_referral: osoba koja je već u razgovoru otvori ig.me poveznicu s parametrom ref.
  • messaging_seen: osoba pročita poruku, s read.mid.
  • messaging_optins, messaging_handover i standby: posljednja dva za aplikacije koje dijele razgovor prema Metinom protokolu predaje.

Što račun mora uključiti?

Dopustite pristup porukama. Meta zahtijeva da profesionalni račun to uključi prije nego što se njegovim porukama može upravljati putem API-ja, u aplikaciji Instagram pod Postavke, Poruke i odgovori na Story, Kontrole poruka, Povezani alati. Dok je isključeno, slanje ne uspijeva s kodom 200, podkodom 2534041. Aplikacija također treba instagram_business_basic i instagram_business_manage_messages, a za račune koje ne posjeduje ili ne upravlja potreban joj je Advanced Access.

Kako easyCoexistence proslijeđuje DM?

Kao komentar: svaki unos koji Meta isporuči za račun šalje se POST zahtjevom na vaš HTTPS endpoint unutar omotnice s platform, account_id, external_id i entry, potpisan u X-EC-Signature tajnim ključem računa, jednom i bez zadržane kopije. Eho-poruke se proslijeđuju zajedno s ostalima, pa provjerite is_echo prije odgovora. Za odgovor pozovite send_social_dm s account_id i sender.id događaja kao recipient_id, unutar 24-satnog prozora. Automatizacije koje se pokreću DM-om rade na istim događajima.

A forwarded DM with an image
{
  "platform": "instagram",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<IG_ID>",
  "entry": {
    "id": "<IG_ID>",
    "time": 1793448000512,
    "messaging": [
      {
        "sender": { "id": "<IGSID>" },
        "recipient": { "id": "<IG_ID>" },
        "timestamp": 1793447999874,
        "message": {
          "mid": "<MESSAGE_ID>",
          "attachments": [
            { "type": "image", "payload": { "url": "<URL_FOR_THE_MEDIA>" } }
          ]
        }
      }
    ]
  }
}

Uobičajene pogreške

  • Odgovaranje na eho-poruke. Događaj s postavljenim is_echo je poruka samog računa, pa odgovor na nju šalje račun u petlju sam sa sobom.
  • Pretpostavka da poruka uvijek ima tekst. Privitci, dijeljenja, spominjanja u Story objavama i brisanja stižu bez polja text, pa grananje mora ovisiti o tome što objekt poruke sadrži.
  • Sortiranje poruka prema redoslijedu dolaska. Meta nakon kvara može isporučiti poruke izvan redoslijeda, pa ih sortirajte prema vremenskoj oznaci.
  • Tumačenje time i timestamp kao sekundi. Metini primjeri poruka daju oba u milisekundama, a pročitani kao sekunde postaju datumi daleko u budućnosti.
Radite ovo uz EasyCoexistence

send_social_dm odgovara unutar 24-satnog prozora, a automatizacije mogu odgovarati same, fiksnim tekstom ili AI-jem. US$ 9 do US$ 0.75 po povezanom računu mjesečno, uz pad kako dodajete račune, uz prvih 3 dana besplatno.

Često postavljana pitanja

Jesu li vremenske oznake Instagram webhooka za poruke u sekundama ili milisekundama?

Milisekundama, prema Metinim primjerima poruka, i za timestamp i za entry.time. Pročitane kao sekunde, pretvaraju se u datume daleko u budućnosti.

Kako dohvatiti korisničko ime pošiljatelja iz Instagram DM webhooka?

Pozovite GET /<IGSID> s poljima kao što su name i username. Događaj nosi samo Instagram-scoped ID osobe.

Zašto ne stižu moji webhookovi za Instagram DM-ove?

Provjerite je li račun uključio Dopusti pristup porukama, je li pretplaćen na messages putem /subscribed_apps te je li aplikacija u statusu Live s Advanced Access za račune koje ne posjeduje.

Proslijeđuje li easyCoexistence reakcije na Instagram poruke?

Ne. Reakcije dolaze na message_reactions, a easyCoexistence pretplaćuje račune na messages, comments i mentions.

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