IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Viambatisho vya DM vya Instagram katika webhook ya ujumbe

Webhook ya ujumbe ya Instagram hubeba media za DM katika message.attachments: safu ya vitu, kila kimoja kikiwa na type na payload ambayo mara nyingi huwa na URL ya CDN. Orodha ya Meta ya Instagram Login inataja image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story na share ya zamani. Media ya kutazamwa mara moja hufika kama kiambatisho cha ephemeral bila URL.

easyCoexistence inajiandikisha kwa messages kwa kila akaunti ya Instagram iliyounganishwa na kusambaza DM pamoja na viambatisho vyake kwenye endpoint yako ya HTTPS kama Meta inavyovituma, ikisainiwa kwa siri ya akaunti hiyo bila nakala yoyote kuhifadhiwa, ili wakala au msimbo wako uchukue media unayohitaji.

ig_post

Aina ya kiambatisho cha chapisho lililoshirikiwa; payload yake huongeza ig_post_media_id na title, yaani maelezo ya chapisho, pamoja na url.

1 Feb 2026

Wakati aina ya zamani ya kiambatisho cha share iliacha kuungwa mkono kwa kushiriki machapisho ya Instagram.

ephemeral

Aina ya kiambatisho cha media zinazotoweka au zinazoonekana mara moja, ambazo hufika bila URL.

is_unsupported

Huwekwa kuwa true kwenye tukio la ujumbe ujumbe unapokuwa na media isiyoungwa mkono.

First image

Kile ambacho arifa huripoti mtu anapoitikia au kusambaza picha moja ya chapisho la carousel.

Ni aina gani za viambatisho ambazo tukio la DM linaweza kubeba?

Mifano ya Meta ya Instagram Login inaorodhesha thamani hizi kwa message.attachments[].type, kila moja ikiwa na kitu cha payload. Payload nyingi zina url inayoelekeza kwenye media kwenye CDN ya Meta, na Meta inaandika sehemu za ziada za payload kwa ig_post pekee, kwa hiyo soma type kabla ya payload.

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.

DM yenye viambatisho inaonekanaje?

Tukio la messages ambalo kitu cha message kina attachments badala ya maandishi, au pamoja nayo. Mfano wa Meta unatuma media mbili kwenye ujumbe mmoja, kila moja ikiwa na type na payload.url yake, kwa hiyo kishughulikiaji lazima kipitie safu nzima badala ya kusoma kipengele cha kwanza pekee:

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

Chapisho lililoshirikiwa linaonekanaje?

Kiambatisho cha ig_post. Kuanzia 3 Novemba 2025 Meta ilituma kushiriki machapisho kwa viambatisho vya share na ig_post pamoja; share iliungwa mkono kwa machapisho hadi 1 Februari 2026, na Meta inasema uunganishaji mpya lazima uunge mkono ig_post. Payload yake inaongeza media ID ya chapisho na maelezo yake kama title:

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

Kila sehemu inamaanisha nini?

Sehemu za viambatisho ambazo Meta inaandika kwa tukio la DM, kuanzia safu hadi chini:

  • message.attachments[]: kitu kimoja kwa kila kipengele cha media; mfano wa Meta una viwili kwenye ujumbe mmoja.
  • type: kipengele ni nini, kutoka orodha hapo juu. Chagua kulingana na type kabla ya kusoma payload.
  • payload.url: URL ya CDN ya media. Muhtasari wa Meta unaita URL hizi zenye kuzingatia faragha: hazirudishi chochote mara maudhui yanapofutwa au kuisha muda.
  • payload.ig_post_media_id na payload.title: kwa ig_post pekee, media ID ya chapisho lililoshirikiwa na maelezo yake.
  • message.text: iko tu ujumbe unapokuwa pia na maandishi.
  • message.is_unsupported: true ujumbe unapokuwa na media ambayo webhook haiungi mkono.

URL za viambatisho hudumu kwa muda gani?

Meta inazifunga kwenye maudhui. Muhtasari wake unasema URL za CDN za Instagram zina kuzingatia faragha na huacha kurudisha media mara maudhui yanapofutwa au kuisha muda. Mwongozo wa story_mention unasema URL ya Story huacha kuonyesha Story inapoisha muda au kufutwa. Programu inayohitaji faili inapaswa kuichukua tukio linapofika, ndani ya kanuni za Meta: media ya Story, kwa mfano, haipaswi kuhifadhiwa wala kuwekwa kwenye akiba (cache).

Webhook haijumuishi media gani?

Mwongozo wa Meta wa Instagram Messaging unataja mapengo haya, ambayo kishughulikiaji kinapaswa kuyatarajia badala ya kuyachukulia kama hitilafu:

  • Media zinazotoweka, zinazoonekana mara moja au zinazoruhusu kucheza tena: kiambatisho cha aina ephemeral, bila URL.
  • Media isiyoungwa mkono: ujumbe unafika na is_unsupported imewekwa true.
  • GIF na stika: mwongozo huo unasema hazianzishi webhook yoyote, ilhali mifano ya Meta ya Instagram Login inazitaja chini ya image.
  • Picha iliyochaguliwa ya carousel: mwitikio kwa picha moja, au usambazaji wake, ndani ya chapisho la carousel huripoti picha ya kwanza.
  • Kushiriki kwa ujumla: miongozo ya Meta ya messages bado inasema URL ya media iliyoshirikiwa pekee ndiyo inayojumuishwa, ingawa ig_post sasa inaongeza media ID na maelezo.

easyCoexistence inasambazaje viambatisho?

Bila kubadilika, ndani ya entry: DM yenye media hufika kwenye endpoint yako na attachments array ya Meta kama Meta ilivyoituma, ndani ya envelope ya platform, account_id, external_id na entry, iliyosainiwa kwa X-EC-Signature. Attachments hazipakuliwi, na matukio hayahifadhiwi kwa chaguo-msingi: akaunti yenye otomatiki iliyowashwa huhifadhi maandishi ya DM, si media yake, kwa siku 7. Chukua media unayohitaji kutoka payload.url tukio linapofika, na usihifadhi media ya Story.

Makosa ya kawaida

  • Kusoma kiambatisho cha kwanza pekee. message.attachments ni safu, na mfano wa Meta una vitu viwili kwenye ujumbe mmoja, kwa hiyo pitia safu nzima.
  • Bado kulinganisha type share kwa machapisho yaliyoshirikiwa. Meta iliungwa mkono kwa machapisho hadi 1 Februari 2026; soma ig_post, pamoja na media ID na maelezo kwenye payload yake.
  • Kuhifadhi payload.url ili kuichukua baadaye. Huacha kurudisha media mara maudhui yanapofutwa au kuisha muda, kwa hiyo pakua unachohitaji tukio linapofika, isipokuwa media ya Story.
  • Kusoma payload.url bila kuangalia type. Media ya kutazamwa mara moja hufika kama ephemeral bila URL, na media isiyoungwa mkono huweka is_unsupported.
Kufanya hili ukitumia EasyCoexistence

send_social_dm hujibu ndani ya dirisha la saa 24. US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, inashuka unapoongeza miunganisho, na kipindi cha majaribio bila malipo cha siku 3.

Maswali yanayoulizwa mara kwa mara

Je, naweza kuhifadhi media kutoka kiambatisho cha DM ya Instagram?

Pakua unachohitaji tukio linapofika, kwa sababu payload.url huacha kurudisha media mara maudhui yanapofutwa au kuisha muda. Media ya Story ni ubaguzi: kanuni za Meta zinasema haipaswi kuhifadhiwa wala kuwekwa kwenye akiba.

Kwa nini webhook ya DM ya Instagram haina URL ya media?

Mara nyingi kwa sababu media ni ya kutazamwa mara moja, ambayo hufika kama kiambatisho cha ephemeral bila URL, au haiungwi mkono, ambayo huweka is_unsupported kuwa true.

Je, GIF na stika za Instagram huanzisha webhook ya messages?

Nyaraka za Meta hazikubaliani: mifano yake ya Instagram Login inaweka GIF na stika chini ya image, ilhali mwongozo wake wa Instagram Messaging unasema hazianzishi webhook yoyote. Jaribu kwa akaunti halisi.

Je, tukio moja la DM la Instagram linaweza kubeba viambatisho kadhaa?

Ndiyo. message.attachments ni safu, na mfano wa Meta unaonyesha vitu viwili vya media kwenye ujumbe mmoja.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye