Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagram-DM-liitteet messages-webhookissa

Instagramin messages-webhook välittää DM-median message.attachments-kenttään: taulukon objekteja, joista kullakin on type ja payload, joka yleensä sisältää CDN:n URL:n. Metan Instagram Login -listassa on image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story ja vanha share. Kertakatseltava media saapuu ephemeral-liitteenä ilman URL-osoitetta.

easyCoexistence tilaa jokaisen yhdistetyn Instagram-tilin messages-tapahtumaan ja välittää DM:t liitteineen HTTPS-endpointisi sellaisina kuin Meta ne lähettää.

ig_post

Jaetun postauksen liitetyyppi. Sen payload lisää kentät ig_post_media_id ja title, eli postauksen kuvateksti, url-kentän rinnalle.

1 Feb 2026

Milloin vanha share-liitetyyppi lakkasi olemasta tuettu Instagram-postausten jakamisessa.

ephemeral

Katoavan, kertakatseltavan median liitetyyppi, joka saapuu ilman URL-osoitetta.

is_unsupported

Asetetaan arvoon true messages-tapahtumassa, kun viesti sisältää tukemattoman median.

First image

Mitä ilmoitus kertoo, kun joku reagoi tai välittää yhden karusellipostauksen kuvan.

Mitkä liitetyypit DM-tapahtuma voi sisältää?

Metan Instagram Login -esimerkit listaavat nämä message.attachments[].type-arvot, joista kullakin on payload-objekti. Useimmat payloadit sisältävät url-kentän, joka osoittaa median Metan CDN:ään. Meta dokumentoi lisäkenttiä vain ig_post-tyypille, joten lue tyyppi ennen payloadia.

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.

Miltä DM-viesti liitteillä näyttää?

Messages-tapahtuma, jonka message-objekti sisältää attachments-kentän tekstin sijasta tai sen rinnalla. Metan esimerkissä lähetetään kaksi mediaa yhdessä viestissä. Kummallakin on oma type ja payload.url, joten käsittelijän täytyy käydä taulukko läpi silmukalla eikä lukea vain ensimmäistä alkiota:

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>" } }
            ]
          }
        }
      ]
    }
  ]
}

Miltä jaettu postaus näyttää?

ig_post-liite. 3. marraskuuta 2025 alkaen Meta lähetti postausjaot sekä share- että ig_post-liitteellä. Share oli tuettu postauksille 1. helmikuuta 2026 asti, ja Meta sanoo, että uusien integraatioiden on tuettava ig_post-tyyppiä. Sen payload lisää postauksen median ID:n ja kuvatekstin title-kentässä:

The attachment of a shared post
"attachments": [
  {
    "type": "ig_post",
    "payload": {
      "ig_post_media_id": "<MEDIA_ID>",
      "title": "<POST_CAPTION>",
      "url": "<CDN_URL>"
    }
  }
]

Mitä kukin kenttä tarkoittaa?

Metan dokumentoimat DM-tapahtuman liitekentät ylhäältä alas taulukosta:

  • message.attachments[]: yksi objekti per mediakohde. Metan esimerkissä yhdessä viestissä on kaksi.
  • type: kohteen tyyppi yllä olevasta listasta. Haaroita sen mukaan ennen payloadin lukemista.
  • payload.url: median CDN-URL. Metan yleiskatsauksessa näitä URL-osoitteita kuvataan yksityisyyttä huomioiviksi: ne eivät palauta mitään, kun sisältö on poistettu tai vanhentunut.
  • payload.ig_post_media_id ja payload.title: vain ig_post-tyypillä, jaetun postauksen median ID ja kuvateksti.
  • message.text: näkyy vain, kun viesti sisältää myös tekstiä.
  • message.is_unsupported: true, kun viesti sisältää mediaa, jota webhook ei tue.

Kuinka kauan liitteiden URL-osoitteet toimivat?

Meta sitoo ne sisältöön. Sen yleiskatsauksen mukaan Instagramin CDN-URL-osoitteet ovat yksityisyyttä huomioivia ja lakkaavat palauttamasta mediaa, kun sisältö on poistettu tai vanhentunut. Sen story mention -ohjeen mukaan Storyn URL lakkaa renderöitymästä, kun Story vanhenee tai poistetaan. Sovellus, joka tarvitsee tiedoston, hakee sen tapahtuman saapuessa Metan sääntöjen mukaisesti. Story-mediaa esimerkiksi ei saa tallentaa tai välimuistittaa.

Mitä median webhook jättää pois?

Metan Instagram Messaging -ohje nimeää nämä aukot. Käsittelijän pitäisi odottaa niitä eikä käsitellä niitä virheinä:

  • Katoava media, kertakatselu tai salli toisto: ephemeral-tyyppinen liite ilman URL-osoitetta.
  • Tukematon media: viesti saapuu, ja is_unsupported-kenttä on asetettu arvoon true.
  • GIF:t ja tarrat: kyseisen ohjeen mukaan ne eivät laukaise webhookia, kun taas Metan Instagram Login -esimerkit listaavat ne image-tyypin alle.
  • Valittu karusellikuva: reaktio tai välitys yhdestä karusellipostauksen kuvasta raportoi ensimmäisen kuvan.
  • Jaot yleisesti: Metan viestintäohjeet sanovat edelleen, että mukana on vain jaetun median URL, vaikka ig_post lisää nyt median ID:n ja kuvatekstin.

Miten easyCoexistence välittää liitteet?

Muuttumattomana entryn sisällä: mediaa sisältävä DM-viesti saapuu endpointiisi Metan attachments-taulukon kanssa sellaisena kuin Meta sen lähetti, kehyksessä, jossa on platform, account_id, external_id ja entry, ja allekirjoitettuna X-EC-Signature-otsakkeella. Liitteitä ei ladata, eikä tapahtumia tallenneta oletuksena: tili, jolla automaatio on päällä, säilyttää DM-viestin tekstin, ei mediaa, 7 päivää. Hae tarvitsemasi media payload.url-osoitteesta tapahtuman saapuessa ja jätä Story-media tallentamatta.

Yleiset virheet

  • Vain ensimmäisen liitteen lukeminen. message.attachments on taulukko, ja Metan esimerkissä yhdessä viestissä on kaksi kohdetta, joten käy se läpi silmukalla.
  • Jaettujen postausten tunnistaminen yhä share-tyypiksi. Meta tuki sitä postauksille 1. helmikuuta 2026 asti. Lue ig_post ja hae sen payloadista median ID ja kuvateksti.
  • payload.url:n tallentaminen myöhempää hakua varten. Se lakkaa palauttamasta mediaa, kun sisältö poistetaan tai vanhenee. Lataa siis tarvitsemasi heti saapuessa, Story-media lukuun ottamatta.
  • payload.url:n lukeminen tyyppiä tarkistamatta. Kertakatseltava media saapuu ephemeral-tyyppisenä ilman URL-osoitetta, ja tukematon media asettaa is_unsupported-kentän arvoon true.
Näin teet tämän EasyCoexistencen avulla

Se allekirjoitetaan kyseisen tilin salaisuudella eikä kopiota tallenneta, joten agenttisi tai koodisi hakee tarvitsemansa median. send_social_dm vastaa 24 tunnin ikkunan sisällä. US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, laskien yhteyksiä lisättäessä, ja 3 ensimmäistä päivää ilmaiseksi.

Usein kysytyt kysymykset

Voinko tallentaa mediaa Instagram-DM-liitteestä?

Lataa tarvitsemasi, kun tapahtuma saapuu, sillä payload.url lakkaa palauttamasta mediaa, kun sisältö poistetaan tai vanhenee. Story-media on poikkeus: Metan sääntöjen mukaan sitä ei saa tallentaa tai välimuistittaa.

Miksi Instagram-DM-webhookissa ei ole median URL-osoitetta?

Yleensä siksi, että media on kertakatseltava, jolloin se saapuu ephemeral-liitteenä ilman URL-osoitetta. Toinen syy on tukematon media, jolloin is_unsupported asetetaan arvoon true.

Laukaisevatko Instagramin GIF:t ja tarrat messages-webhookin?

Metan dokumentaatio on ristiriitainen. Sen Instagram Login -esimerkit listaavat GIF:t ja tarrat image-tyypin alle, kun taas Instagram Messaging -ohje sanoo, että ne eivät laukaise webhookia. Testaa oikealla tilillä.

Voiko yksi Instagram-DM-tapahtuma sisältää useita liitteitä?

Kyllä. message.attachments on taulukko, ja Metan esimerkissä näkyy kaksi mediakohdetta yhdessä viestissä.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu