Atașamentele DM-urilor Instagram în webhook-ul de mesaje
Webhook-ul de mesaje Instagram transmite media din DM-uri în message.attachments: un array de obiecte, fiecare cu un câmp type și un payload care conține de obicei un URL CDN. Lista Meta pentru Instagram Login include image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story și tipul vechi share, iar media cu vizualizare unică sosește ca atașament efemer, fără URL.
easyCoexistence abonează fiecare cont Instagram conectat la messages și transmite DM-urile cu atașamentele lor către endpoint-ul dumneavoastră HTTPS exact cum le trimite Meta, semnate cu secretul acelui cont și fără nicio copie păstrată, astfel încât agentul sau codul dumneavoastră să descarce media de care are nevoie.
Tipul de atașament pentru o postare partajată; payload-ul său adaugă ig_post_media_id și title, legenda postării, lângă url.
Când tipul vechi de atașament share a încetat să mai fie acceptat pentru partajările de postări Instagram.
Tipul de atașament pentru media efemeră, cu vizualizare unică, care sosește fără URL.
Setat la true într-un eveniment de mesaj când mesajul conține media neacceptată.
Ce raportează o notificare atunci când cineva reacționează la sau redistribuie o singură imagine dintr-o postare de tip carusel.
Ce tipuri de atașamente poate conține un eveniment DM?
Exemplele Meta pentru Instagram Login listează aceste valori pentru message.attachments[].type, fiecare cu un obiect payload. Majoritatea payload-urilor conțin un url către media de pe CDN-ul Meta, iar Meta documentează câmpuri suplimentare în payload doar pentru ig_post, așa că citiți mai întâi tipul, apoi payload-ul.
Cum arată un DM cu atașamente?
Un eveniment de mesaj al cărui obiect message conține attachments în loc de text sau alături de text. Exemplul Meta trimite două elemente media într-un singur mesaj, fiecare cu propriul type și payload.url, așa că un handler trebuie să parcurgă array-ul în buclă, nu să citească doar primul element:
{
"object": "instagram",
"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": "<CDN_URL>" } },
{ "type": "video", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
]
}Cum arată o postare partajată?
Un atașament ig_post. Începând cu 3 noiembrie 2025, Meta a trimis partajările de postări cu atașamente share și ig_post; share a fost acceptat pentru postări până la 1 februarie 2026, iar Meta spune că integrările noi trebuie să accepte ig_post. Payload-ul său adaugă ID-ul media al postării și legenda acesteia, ca title:
"attachments": [
{
"type": "ig_post",
"payload": {
"ig_post_media_id": "<MEDIA_ID>",
"title": "<POST_CAPTION>",
"url": "<CDN_URL>"
}
}
]Ce înseamnă fiecare câmp?
Câmpurile de atașament documentate de Meta pentru un eveniment DM, de la array în jos:
- message.attachments[]: un obiect pentru fiecare element media; exemplul Meta conține două într-un singur mesaj.
- type: ce fel de element este, din lista de mai sus. Verificați-l înainte de a citi payload-ul.
- payload.url: un URL CDN pentru media. Prezentarea generală Meta numește aceste URL-uri care respectă confidențialitatea: nu mai întorc nimic după ce conținutul este șters sau a expirat.
- payload.
ig_post_media_idși payload.title: doar pentruig_post, ID-ul media al postării partajate și legenda acesteia. - message.text: prezent doar când mesajul conține și text.
- message.
is_unsupported: true când mesajul conține media pe care webhook-ul nu o acceptă.
Cât timp funcționează URL-urile atașamentelor?
Meta le leagă de conținut. Prezentarea generală spune că URL-urile CDN Instagram respectă confidențialitatea și nu mai întorc media după ce conținutul a fost șters sau a expirat, iar ghidul pentru mențiuni în Story spune că URL-ul unui Story nu mai se afișează când Story-ul expiră sau este șters. O aplicație care are nevoie de un fișier ar trebui să-l descarce în momentul în care sosește evenimentul, în limitele regulilor Meta: media din Story, de exemplu, nu trebuie stocată sau memorată în cache.
Ce media nu include webhook-ul?
Ghidul de mesagerie Instagram al Meta numește aceste lacune, pe care un handler ar trebui să le aștepte, nu să le trateze ca erori:
- Media care dispare, cu vizualizare unică sau redare permisă o singură dată: un atașament de tipul ephemeral, fără URL.
- Media neacceptată: mesajul sosește cu
is_unsupportedsetat la true. - GIF-uri și stickere: acel ghid spune că nu declanșează niciun webhook, în timp ce exemplele Meta pentru Instagram Login le listează la image.
- Imaginea aleasă din carusel: o reacție la sau o redistribuire a uneia dintre imaginile unei postări de tip carusel raportează prima imagine.
- Partajările în general: ghidurile Meta pentru mesagerie spun în continuare că se include doar URL-ul conținutului partajat, deși
ig_postadaugă acum ID-ul media și legenda.
Cum transmite easyCoexistence atașamentele?
Neschimbat, în interiorul entry: un DM cu media ajunge la endpoint-ul dumneavoastră cu array-ul attachments al Meta, așa cum l-a trimis Meta, într-un plic cu platform, account_id, external_id și entry, semnat cu X-EC-Signature. Atașamentele nu sunt descărcate, iar evenimentele nu sunt stocate implicit: un cont cu o automatizare activată păstrează textul unui DM, nu media lui, timp de 7 zile. Descărcați media de care aveți nevoie de la payload.url în momentul sosirii evenimentului și nu stocați media din Story.
Greșeli frecvente
- Citirea doar a primului atașament. message.attachments este un array, iar exemplul Meta conține două elemente într-un singur mesaj, deci parcurgeți-l în buclă.
- Încă potrivirea tipului share pentru postările partajate. Meta l-a acceptat pentru postări până la 1 februarie 2026; citiți ig_post, cu ID-ul media și legenda în payload.
- Salvarea payload.url pentru a-l descărca mai târziu. Acesta nu mai întoarce media după ce conținutul este șters sau expiră, așa că descărcați ce aveți nevoie la sosire, cu excepția media din Story.
- Citirea payload.url fără verificarea tipului. Media cu vizualizare unică sosește ca ephemeral, fără URL, iar media neacceptată setează is_unsupported.
send_social_dm răspunde în fereastra de 24 de ore. De la US$ 9 la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Pot stoca media dintr-un atașament DM Instagram?
Descărcați ce aveți nevoie în momentul în care sosește evenimentul, deoarece payload.url nu mai întoarce media după ce conținutul este șters sau expiră. Media din Story face excepție: regulile Meta spun că nu trebuie stocată sau memorată în cache.
De ce un webhook DM Instagram nu are URL pentru media?
De obicei pentru că media are vizualizare unică, caz în care sosește ca atașament ephemeral fără URL, sau pentru că este neacceptată, caz în care is_unsupported este setat la true.
GIF-urile și stickerele Instagram declanșează webhook-ul de mesaje?
Documentația Meta nu este consecventă: exemplele Instagram Login listează GIF-urile și stickerele la image, iar ghidul de mesagerie Instagram spune că nu declanșează niciun webhook. Testați cu un cont real.
Poate un singur eveniment DM Instagram să conțină mai multe atașamente?
Da. message.attachments este un array, iar exemplul Meta arată două elemente media într-un singur mesaj.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la