Instagram webhook za poruke: DM payload, ehoi i polja
Polje messages u Instagram webhooku isporučuje DM-ove profesionalnog naloga čim stignu: tekst, priloge, deljene objave, odgovore na priče i pominjanja, odgovore uz navođenje ranije poruke i brisanja. Svaki događaj nosi niz messaging sa ID-jem pošiljaoca na Instagramu, primaocem, vremenskom oznakom i objektom message, a poruke koje nalog sam pošalje stižu na istom polju sa is_echo postavljenim na true.
easyCoexistence pretplaćuje svaki povezani Instagram nalog na messages i prosleđuje njegove DM-ove, uključujući ehoe, na vaš HTTPS endpoint čim stignu, potpisane tajnim ključem tog naloga; prosleđivanje ne zadržava kopiju, a DM-ovi se podrazumevano ne čuvaju.
Postavljeno na true za događaj poruke kada je nalog sam poslao poruku.
Standardni prozor za slanje poruka za većinu radnji korisnika, u kojem aplikacija može da odgovori toj osobi.
Tip priloga za deljenu objavu; stari tip za deljenje podržan je samo do 1. februara 2026.
Tip priloga DM događaja koji Meta šalje kada neko pomene nalog u svojoj priči.
Podkod greške, pod kodom 200, kada vlasnik naloga isključi pristup direktnim porukama na Instagramu.
Kada se polje messages aktivira?
Kada osoba pošalje DM profesionalnom nalogu i kada nalog sam pošalje DM. Meta-ini primeri i reference navode ove slučajeve, svaki kao događaj poruke sa objektom message:
- Tekst i mediji kao prilozi: slike, video, audio i fajlovi.
- Deljena objava ili Reel, kao prilog
ig_post,ig_reelili reel. - Odgovor na priču naloga, sa
reply_to.story, i priča u kojoj je nalog pomenut, kao prilogstory_mention. - Odgovor uz navođenje ranije poruke, sa
reply_to.mid, i brzi odgovor, saquick_reply.payload. - Poruka koju je osoba obrisala (
is_deleted), nepodržan medijski sadržaj (is_unsupported) i poruka od osobe koja je kliknula na oglas Click-to-Direct (referral). - Poruka koju je nalog poslao, koja se vraća sa
is_echopostavljenim na true.
Kako izgleda obaveštenje o porukama?
POST zahtev čiji JSON ima object postavljen na instagram. Za razliku od komentara, poruka se nalazi u nizu messaging unutar entry naloga, a svaki element nosi sender, recipient, timestamp i message. Odgovor na priču naloga izgleda ovako:
{
"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>"
}
}
}
}
]
}
]
}Šta znači svako polje?
Polja koja Meta dokumentuje za događaj poruke pod Instagram Login, od spolja ka unutra:
- entry[].id: ID profesionalnog naloga. entry[].time: kada je Meta poslala obaveštenje; Meta-ini primeri poruka daju ga u milisekundama.
- sender.id i recipient.id: kod dolazne DM poruke, ID osobe ograničen na Instagram nalog i ID naloga; kod eha, isti par obrnuto.
- timestamp: kada je poruka poslata, u milisekundama u Meta-inim primerima. Poruke sortirajte po njemu, a ne po redosledu dolaska.
- message.mid: ID poruke, za deduplikaciju, reakciju i odgovor na tu poruku preko
reply_to.mid. - message.text: uključen kada poruka sadrži tekst.
- message.attachments[]: svaki sa type i payload, obično url. Payload deljene objave
ig_postdodajeig_post_media_idi title, njen natpis. - message.
reply_to: mid za odgovor uz navođenje ranije poruke, ili story sa url-om i id-jem priče za odgovor na priču. - message.
quick_reply.payload i message.referral: izabrani brzi odgovor, i ref,ad_id, source, type iads_context_dataoglasa Click-to-Direct. - message.
is_deleted,is_echo,is_selfiis_unsupported: uključeni samo kada su true. - message.
admin_textihandoff_reason: na kvalifikovanim aplikacijama, obaveštenje da je Meta aplikacija, poput Meta Business Agent, preuzela razgovor; može stići bez mid ili teksta.
Kako rade ehoi?
Kada nalog pošalje poruku, Meta za nju takođe šalje događaj poruke, sa is_echo postavljenim na true. sender.id tada je nalog, a recipient.id je Instagram ID osobe, a probna poruka koju nalog šalje sebi nosi i is_self. Ehoi beleže šta je nalog rekao, što evidencija razgovora zahteva, ali handler koji odlučuje da li će odgovoriti mora da ih preskoči. Meta ne šalje eho kada nalog reaguje na poruku ili ukloni reakciju.
{
"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?
sender.id, ID osobe vezan za Instagram. Meta ga kreira kada neko pošalje poruku nalogu ili komentariše njegove medije, i vezan je za tu osobu i taj nalog. POST /<IG_ID>/messages sa recipient.id postavljenim na taj ID šalje odgovor. Događaj ne nosi ime ni korisničko ime; GET /<IGSID> sa poljima kao što su name i username ih vraća, jer je osoba koja je pisala nalogu dala saglasnost koju to pretraživanje zahteva.
Kako poruka otvara 24-časovni prozor?
Aplikacija može da pošalje poruku osobi tek nakon što ona piše nalogu, i samo u standardnom prozoru za slanje poruka koji njena radnja otvara. Za većinu radnji traje 24 sata, a do 7 dana od prve poruke poslate nakon klika na oglas Click-to-Direct. Nova poruka od osobe otvara novi prozor, pa je njena poslednja vremenska oznaka ona koju treba pratiti; eho je poruka samog naloga i ne produžava ništa. Odgovore koje piše osoba mogu koristiti Metin zasebni prozor Human Agent od 7 dana, označen human_agent.
Šta događaj poruke ne nosi?
Neke stvari koje handler može tražiti nedostaju, prema Metinim referencama za poruke:
- Ime ili korisničko ime osobe: samo Instagram ID, koji razrešava GET /<IGSID>.
- Medij za jednokratni prikaz: stiže kao privremeni prilog bez URL-a.
- Tačna slika iz karusela: reakcija na jednu sliku iz objave karusela ili njen prosleđivanje prijavljuje prvu sliku.
- Reakcije, izmene i potvrde čitanja, koje stižu na sopstvenim poljima.
- Oznaka pročitano: poruka isporučena webhookom ostaje nepročitana u Instagram sandučetu dok se ne pošalje odgovor.
Koja druga polja poruka navodi Meta?
Metina lista polja i primeri za Instagram Login navode, pored messages, i ova, svako kao zaseban događaj poruke. easyCoexistence pretplaćuje svaki nalog samo na messages, comments i mentions, pa nijedno od njih nije deo onoga što prosleđuje:
message_reactions: osoba reaguje na poruku ili ukloni reakciju, sa reaction.mid, action postavljenim na react ili unreact, i reakcijom i emoji.message_edit: osoba menja poruku, samessage_edit.mid, novim tekstom inum_edit.messaging_postbacks: osoba dodirne icebreaker ili dugme šablona, sa postback.mid, title i payload.messaging_referral: osoba koja je već u razgovoru otvara ig.me link sa parametrom ref.messaging_seen: osoba čita poruku, sa read.mid.messaging_optins,messaging_handoveri standby: poslednja dva za aplikacije koje dele razgovor po Metinom protokolu predaje.
Šta nalog mora da uključi?
„Dozvoli pristup porukama“. Meta zahteva da profesionalni nalog to uključi pre nego što se njegovim porukama može upravljati preko API-ja, u Instagram aplikaciji pod Podešavanja, Poruke i odgovori na priče, Kontrole poruka, Povezani alati. Dok je isključeno, slanja ne uspevaju sa kodom 200, podkodom 2534041. Aplikacija takođe treba instagram_business_basic i instagram_business_manage_messages, a za naloge koje ne poseduje niti upravlja njima, Advanced Access.
Kako easyCoexistence prosleđuje DM?
Kao kod komentara: svaki unos koji Meta isporuči za nalog šalje se POST zahtevom na vaš HTTPS endpoint, u omotaču sa platform, account_id, external_id i entry, potpisan u X-EC-Signature tajnim ključem naloga, jednom i bez čuvanja kopije. Ehoi se prosleđuju sa ostalim, pa proverite is_echo pre odgovora. Za odgovor pozovite send_social_dm sa account_id i sender.id događaja kao recipient_id, unutar 24-časovnog prozora. Automatizacije koje počinju DM-om rade na istim događajima.
{
"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>" } }
]
}
}
]
}
}Česte greške
- Odgovaranje na ehoe. Događaj sa postavljenim is_echo je poruka samog naloga, a odgovor na nju šalje nalog u petlju sa samim sobom.
- Pretpostavka da poruka uvek ima tekst. Prilozi, deljenja, pominjanja u pričama i brisanja stižu bez polja text, pa grananje zavisi od onoga što objekat message sadrži.
- Sortiranje poruka po redosledu dolaska. Meta posle greške može isporučiti poruke van redosleda, pa ih sortirajte po timestamp.
- Tumačenje time i timestamp kao sekunde. Meta-ini primeri poruka daju oba u milisekundama, a pročitani kao sekunde postaju datumi daleko u budućnosti.
send_social_dm odgovara unutar 24-časovnog prozora, a automatizacije mogu same da odgovore fiksnim tekstom ili AI-jem. Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Da li su timestamp vrednosti Instagram webhook poruka u sekundama ili milisekundama?
U milisekundama, prema Meta-inim primerima poruka, i za timestamp i za vreme unosa. Ako ih pročitate kao sekunde, postaju datumi daleko u budućnosti.
Kako da dobijem korisničko ime pošiljaoca iz Instagram DM webhooka?
Pozovite GET /<IGSID> sa poljima kao što su name i username. Događaj nosi samo Instagram ID osobe.
Zašto moji Instagram DM webhookovi ne stižu?
Proverite da li je nalog uključio „Dozvoli pristup porukama“, da li je pretplaćen na messages preko /subscribed_apps i da li je aplikacija Live sa Advanced Access za naloge koje ne poseduje.
Da li easyCoexistence prosleđuje reakcije na Instagram poruke?
Ne. Reakcije stižu na message_reactions, a easyCoexistence pretplaćuje naloge na messages, comments i mentions.
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