Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Instagram DM ekleri, messages webhook'unda

Instagram'ın messages webhook'u DM medyasını message.attachments içinde taşır: her biri bir type ve genellikle bir CDN url'si içeren payload'a sahip nesnelerden oluşan bir dizi. Meta'nın Instagram Login için listesi image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story ve eski share türünü sayar; tek görüntülük medya ise URL'siz bir ephemeral ek olarak gelir.

easyCoexistence, bağlı her Instagram hesabını messages'a abone eder ve ekli DM'leri, Meta'nın gönderdiği biçimde HTTPS uç noktanıza iletir; her hesap kendi gizli anahtarıyla imzalanır ve hiçbir kopya tutulmaz, böylece ajanınız veya kodunuz ihtiyaç duyduğu medyayı alır.

ig_post

Paylaşılan bir gönderinin ek türü; payload'una url'nin yanına ig_post_media_id ve gönderinin açıklaması olan title eklenir.

1 Feb 2026

Eski share ek türünün Instagram gönderi paylaşımları için desteğinin sona erdiği tarih.

ephemeral

Kaybolan, tek görüntülük medyanın ek türü; URL'siz gelir.

is_unsupported

Bir mesaj olayında, mesaj desteklenmeyen medya içerdiğinde true olarak ayarlanır.

First image

Birisi karusel gönderisindeki tek bir görsele tepki verdiğinde veya onu ilettiğinde bildirimin neyi rapor ettiği.

Bir DM olayı hangi ek türlerini taşıyabilir?

Meta'nın Instagram Login örnekleri message.attachments[].type için şu değerleri listeler; her birinin bir payload nesnesi vardır. Çoğu payload, Meta'nın CDN'indeki medyaya işaret eden bir url içerir. Meta ek payload alanlarını yalnızca ig_post için belgelediğinden, payload'a bakmadan önce türü okuyun.

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.

Ekli bir DM nasıl görünür?

Metin yerine veya metnin yanında attachments içeren bir message nesnesine sahip bir messages olayı. Meta'nın örneği, tek bir mesajda iki medya öğesi gönderir; her birinin kendi type ve payload.url değeri vardır, bu yüzden bir işleyici ilk öğeyi okumak yerine diziyi döngüye almalıdır:

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

Paylaşılan bir gönderi nasıl görünür?

Bir ig_post eki. 3 Kasım 2025'ten itibaren Meta, gönderi paylaşımlarını hem share hem de ig_post eki ile gönderdi; share türü 1 Şubat 2026'ya kadar gönderiler için desteklendi ve Meta yeni entegrasyonların ig_post'u desteklemesi gerektiğini söylüyor. Payload'u, gönderinin medya kimliğini ve açıklamasını title olarak ekler:

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

Her alan ne anlama gelir?

Meta'nın bir DM olayı için belgelediği ek alanlar, diziden başlayarak:

  • message.attachments[]: medya öğesi başına bir nesne; Meta'nın örneğinde bir mesajda iki tane vardır.
  • type: öğenin ne olduğu, yukarıdaki listeden. payload'u okumadan önce buna göre dallanın.
  • payload.url: medya için bir CDN URL'si. Meta'nın genel bakışı bu URL'lere gizliliğe duyarlı der: içerik silindiğinde veya süresi dolduğunda hiçbir şey döndürmezler.
  • payload.ig_post_media_id ve payload.title: yalnızca ig_post için; paylaşılan gönderinin medya kimliği ve açıklaması.
  • message.text: yalnızca mesaj ayrıca metin içerdiğinde bulunur.
  • message.is_unsupported: mesaj webhook'un desteklemediği medya içerdiğinde true.

Ek URL'leri ne kadar süre çalışır?

Meta bunları içeriğe bağlar. Genel bakışında Instagram'ın CDN URL'lerinin gizliliğe duyarlı olduğunu ve içerik silindikten veya süresi dolduktan sonra medya döndürmeyi bıraktığını söyler; hikâye bahsetme rehberi ise bir hikâye'nin URL'sinin hikâye süresi dolunca veya silinince görüntülenmeyi durdurduğunu belirtir. Bir dosyaya ihtiyaç duyan bir uygulama, olay geldiğinde onu Meta'nın kurallarına uyarak almalıdır: örneğin hikâye medyası saklanamaz veya önbelleğe alınamaz.

Webhook hangi medyayı dışarıda bırakır?

Meta'nın Instagram Messaging rehberi, bir işleyicinin hata saymak yerine beklemesi gereken boşlukları adlandırır:

  • Kaybolan medya, tek görüntülük veya tekrar oynatmaya izin veren: type değeri ephemeral olan ve URL'si olmayan bir ek.
  • Desteklenmeyen medya: mesaj is_unsupported değeri true olarak gelir.
  • GIF'ler ve çıkartmalar: bu rehbere göre hiçbir webhook tetiklemezler; Meta'nın Instagram Login örnekleri ise bunları image altında listeler.
  • Seçilen karusel görseli: karusel gönderisindeki bir görsele verilen tepki veya o görselin iletilmesi, ilk görseli bildirir.
  • Genel olarak paylaşımlar: Meta'nın mesajlaşma rehberleri hâlâ paylaşılan medyanın yalnızca URL'sinin dahil edildiğini söylüyor, ancak ig_post artık medya kimliğini ve açıklamayı ekliyor.

easyCoexistence ekleri nasıl iletir?

Girdinin içinde değişmeden: medyalı bir DM, uç noktanıza Meta'nın attachments dizisiyle, Meta'nın gönderdiği haliyle ulaşır; platform, account_id, external_id ve entry içeren bir zarf içinde gelir ve X-EC-Signature ile imzalanır. Ekler indirilmez ve olaylar varsayılan olarak saklanmaz: otomasyonu açık olan bir hesap, bir DM'in medyasını değil metnini 7 gün tutar. İhtiyaç duyduğunuz medyayı olay geldiğinde payload.url'den alın ve hikâye medyasını saklamayın.

Yaygın hatalar

  • İlk eki okumak. message.attachments bir dizidir ve Meta'nın örneğinde tek bir mesajda iki öğe bulunur; bu yüzden diziyi döngüye alın.
  • Paylaşılan gönderiler için hâlâ share türüyle eşleştirmek. Meta bunu 1 Şubat 2026'ya kadar gönderiler için destekledi; ig_post'u, medya kimliği ve açıklaması payload'unda olacak şekilde okuyun.
  • Sonra almak için payload.url'yi kaydetmek. İçerik silindiğinde veya süresi dolduğunda medya döndürmeyi bırakır; bu yüzden ihtiyacınız olanı, hikâye medyası hariç, geldiği anda indirin.
  • payload.url'yi türü kontrol etmeden okumak. Tek görüntülük medya URL'siz ephemeral olarak gelir; desteklenmeyen medya ise is_unsupported değerini ayarlar.
Bunu EasyCoexistence'la yapmak

send_social_dm, 24 saatlik pencere içinde yanıt verir. Bağlantı başına ayda US$ 9 ile US$ 0.75 arası, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

Instagram DM ekinden medya saklayabilir miyim?

Olay geldiğinde ihtiyacınız olanı indirin, çünkü payload.url içerik silindiğinde veya süresi dolduğunda medya döndürmeyi bırakır. Hikâye medyası istisnadır: Meta'nın kurallarına göre saklanamaz veya önbelleğe alınamaz.

Neden bir Instagram DM webhook'unda medya URL'si yok?

Genellikle medya tek görüntülüktür ve URL'siz bir ephemeral ek olarak gelir ya da desteklenmiyordur ve is_unsupported değerini true yapar.

Instagram GIF'leri ve çıkartmaları messages webhook'unu tetikler mi?

Meta'nın belgeleri çelişiyor: Instagram Login örnekleri GIF'leri ve çıkartmaları image altında listeler, Instagram Messaging rehberi ise hiçbir webhook tetiklemediklerini söyler. Gerçek bir hesapla test edin.

Tek bir Instagram DM olayı birden fazla ek taşıyabilir mi?

Evet. message.attachments bir dizidir ve Meta'nın örneği tek bir mesajda iki medya öğesi gösterir.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi