Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

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.

ig_post

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.

1 Feb 2026

Când tipul vechi de atașament share a încetat să mai fie acceptat pentru partajările de postări Instagram.

ephemeral

Tipul de atașament pentru media efemeră, cu vizualizare unică, care sosește fără URL.

is_unsupported

Setat la true într-un eveniment de mesaj când mesajul conține media neacceptată.

First image

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.

imageA photo. Meta's Instagram Login list also puts GIFs and stickers under this type.
videoA video, at payload.url.
audioAudio, at payload.url.
fileA file, at payload.url.
ig_postA shared post: url, ig_post_media_id and title, its caption.
ig_reel and reelA shared Reel; Meta lists both names, each with a url.
story_mentionA Story that mentions the account, at its CDN URL.
shareThe legacy post share, supported until 1 February 2026.
media, story, ig_storyAlso in Meta's list, with no payload described.
ephemeralView-once media, sent with no URL.

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:

A DM with two attachments, 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>",
            "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:

The attachment of a shared post
"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 pentru ig_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_unsupported setat 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_post adaugă 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.
Faceți acest lucru cu EasyCoexistence

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