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ää.
Jaetun postauksen liitetyyppi. Sen payload lisää kentät ig_post_media_id ja title, eli postauksen kuvateksti, url-kentän rinnalle.
Milloin vanha share-liitetyyppi lakkasi olemasta tuettu Instagram-postausten jakamisessa.
Katoavan, kertakatseltavan median liitetyyppi, joka saapuu ilman URL-osoitetta.
Asetetaan arvoon true messages-tapahtumassa, kun viesti sisältää tukemattoman median.
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.
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:
{
"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ä:
"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_idja payload.title: vainig_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_postlisää 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.
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