Instagram DM attachments sa messages webhook
Ang messages webhook ng Instagram ay nagdadala ng DM media sa message.attachments: isang array ng mga object, bawat isa ay may type at payload na kadalasang may CDN url. Ang listahan ng Meta para sa Instagram Login ay naglalaman ng image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story at ang legacy na share, at ang view-once media ay dumarating bilang ephemeral attachment na walang URL.
Sina-subscribe ng easyCoexistence ang bawat naka-connect na Instagram account sa messages at ipinapasa ang mga DM kasama ang kanilang attachment sa inyong HTTPS endpoint gaya ng pagpapadala ng Meta, naka-sign gamit ang secret ng account na iyon at walang kopyang itinatago, para makuha ng inyong agent o code ang media na kailangan nito.
Attachment type para sa shared post; dinadagdagan ng payload nito ang ig_post_media_id at title, ang caption ng post, katabi ng url.
Kailan huminto ang suporta sa lumang share attachment type para sa mga Instagram post share.
Attachment type ng disappearing, view-once media, na dumarating nang walang URL.
Nakatakda sa true sa event ng mensahe kapag naglalaman ang mensahe ng hindi suportadong media.
Ang iniuulat ng notification kapag may nag-react o nag-forward ng isang larawan mula sa carousel post.
Anong attachment type ang maaaring dalhin ng DM event?
Ipinapakita ng mga halimbawa ng Meta para sa Instagram Login ang mga value na ito para sa message.attachments[].type, bawat isa ay may payload object. Karamihan sa payload ay may url papunta sa media sa CDN ng Meta, at dokumentado ng Meta ang dagdag na payload field para sa ig_post lamang, kaya basahin muna ang type bago ang payload.
Ano ang itsura ng DM na may attachment?
Isang messages event kung saan ang object ng mensahe ay naglalaman ng attachments sa halip na text, o kasama nito. Ang sample ng Meta ay nagpapadala ng dalawang media item sa isang mensahe, bawat isa ay may sariling type at payload.url, kaya dapat mag-loop ang handler sa array sa halip na basahin ang unang elemento:
{
"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>" } }
]
}
}
]
}
]
}Ano ang itsura ng shared post?
Isang ig_post attachment. Mula 3 Nobyembre 2025, nagpadala ang Meta ng post share na may share at ig_post attachment; suportado ang share para sa post hanggang 1 Pebrero 2026, at sinabi ng Meta na dapat suportahan ng mga bagong integration ang ig_post. Dinadagdagan ng payload nito ang media ID ng post at ang caption nito bilang title:
"attachments": [
{
"type": "ig_post",
"payload": {
"ig_post_media_id": "<MEDIA_ID>",
"title": "<POST_CAPTION>",
"url": "<CDN_URL>"
}
}
]Ano ang ibig sabihin ng bawat field?
Ang mga attachment field na dokumentado ng Meta para sa DM event, mula sa array pababa:
- message.attachments[]: isang object bawat media item; may dalawa sa isang mensahe ang sample ng Meta.
- type: kung ano ang item, mula sa listahan sa itaas. Suriin muna ito bago basahin ang payload.
- payload.url: CDN URL ng media. Tinatawag ng overview ng Meta na privacy-aware ang mga URL na ito: wala silang ibabalik kapag nabura o nag-expire na ang content.
- payload.
ig_post_media_idat payload.title: saig_postlamang, ang media ID ng shared post at ang caption nito. - message.text: naroroon lamang kapag may kasamang text ang mensahe.
- message.
is_unsupported: true kapag naglalaman ang mensahe ng media na hindi sinusuportahan ng webhook.
Gaano katagal gumagana ang mga URL ng attachment?
Nakatali ito sa content. Sinasabi ng overview ng Meta na privacy-aware ang mga CDN URL ng Instagram at tumitigil sa pagbabalik ng media kapag nabura o nag-expire na ang content, at sinasabi ng gabay nito sa story mention na tumitigil sa pag-render ang URL ng Story kapag nag-expire o nabura ito. Kung kailangan ng app ng file, kunin ito sa pagdating ng event, ayon sa mga patakaran ng Meta: ang Story media, halimbawa, ay hindi dapat i-store o i-cache.
Anong media ang hindi kasama sa webhook?
Pinangalanan ng gabay ng Meta sa Instagram Messaging ang mga puwang na ito, na dapat asahan ng handler at hindi ituring na error:
- Disappearing media, view once o allow replay: attachment ng type na ephemeral, walang URL.
- Unsupported media: dumarating ang mensahe na may
is_unsupportedna nakatakda sa true. - GIF at sticker: sinasabi ng gabay na hindi sila nagti-trigger ng webhook, habang inilista ng mga halimbawa ng Meta para sa Instagram Login ang mga ito sa ilalim ng image.
- Ang napiling carousel image: ang reaksyon sa, o forward ng, isang image sa carousel post ay nag-uulat ng unang image.
- Share sa pangkalahatan: sinasabi pa rin ng mga gabay ng Meta sa messaging na URL lamang ng shared media ang kasama, bagaman dinadagdagan na ng
ig_postang media ID at caption.
Paano ipinapasa ng easyCoexistence ang mga attachment?
Hindi nagbabago, sa loob ng entry: ang DM na may media ay umaabot sa endpoint ninyo kasama ang attachments array ng Meta ayon sa pagkakapadala ng Meta, sa isang envelope na may platform, account_id, external_id at entry, na pinirmahan gamit ang X-EC-Signature. Hindi dina-download ang mga attachment, at hindi itinatago ang mga event bilang default: ang account na may naka-on na automation ay nagtatago ng teksto ng DM, hindi ng media nito, nang 7 araw. Kunin ang media na kailangan ninyo mula sa payload.url pagdating ng event, at huwag i-store ang Story media.
Mga karaniwang pagkakamali
- Pagbabasa lamang ng unang attachment. Ang message.attachments ay isang array, at may dalawang item sa isang mensahe ang sample ng Meta, kaya mag-loop dito.
- Pagtutugma pa rin sa type na share para sa shared post. Suportado ito ng Meta para sa post hanggang 1 Pebrero 2026; basahin ang ig_post, kasama ang media ID at caption sa payload nito.
- Pag-save ng payload.url para kunin sa susunod. Tumitigil ito sa pagbabalik ng media kapag nabura o nag-expire na ang content, kaya i-download ang kailangan ninyo pagdating, maliban sa Story media.
- Pagbasa sa payload.url nang hindi tinitingnan ang type. Ang view-once media ay dumarating bilang ephemeral na walang URL, at ang unsupported media ay nagtatakda ng is_unsupported sa halip.
send_social_dm ay sumasagot sa loob ng 24-hour window. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, kasama ang unang 3 araw na free trial.
Mga madalas itanong
Maaari ba akong mag-store ng media mula sa attachment ng Instagram DM?
I-download ang kailangan ninyo pagdating ng event, dahil tumitigil sa pagbabalik ng media ang payload.url kapag nabura o nag-expire na ang content. Ang Story media ang eksepsiyon: sinasabi ng mga patakaran ng Meta na hindi ito dapat i-store o i-cache.
Bakit walang media URL ang webhook ng Instagram DM?
Kadalasan dahil view-once ang media, na dumarating bilang ephemeral attachment na walang URL, o unsupported, na nagtatakda ng is_unsupported sa true.
Nagti-trigger ba ng messages webhook ang GIF at sticker ng Instagram?
Nagkakaiba ang mga dokumento ng Meta: inilista ng mga halimbawa nito para sa Instagram Login ang GIF at sticker sa ilalim ng image, habang sinasabi ng gabay nitong Instagram Messaging na hindi sila nagti-trigger ng webhook. Mag-test gamit ang totoong account.
Maaari bang maglaman ang isang Instagram DM event ng maraming attachment?
Oo. Ang message.attachments ay isang array, at ipinapakita ng sample ng Meta ang dalawang media item sa iisang mensahe.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong