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

Instagram webhook alanları: tam liste

Instagram Login üzerinde profesyonel bir hesap için Meta'nın webhook alanları tablosu şunları listeler: comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover ve standby. mentions, comments içinde iletilir; örneklerde message_edit da yer alır. Her biri instagram_business_basic iznine ek olarak instagram_business_manage_comments iznini veya çoğu mesajlaşma alanı için instagram_business_manage_messages iznini gerektirir. story_insights, Instagram Login ile sunulmaz.

easyCoexistence, bağlanan her Instagram hesabını comments, messages ve mentions'a abone eder ve bu olayları geldikçe HTTPS uç noktanıza iletir; her biri o hesabın gizli anahtarıyla imzalanır.

8

Uygulama Panelinde yeni bir Instagram ürününün başlangıçta abone olduğu alanlar; bunlar arasında comments, messages ve message_reactions da var.

Per app

Alanlar hesap bazında değil, uygulama bazında seçilir: bir hesap, uygulamanın seçtiği alanları alır.

Advanced Access

Meta'nın kurulum rehberinin Instagram Login webhook'ları için listelediği erişim düzeyi; comments ve live_comments bildirimleri için bu düzey gerekir.

story_insights

Meta'nın alan tablosunda Instagram Login için kullanılamaz olarak işaretlenmiştir; bu alan Facebook Login ve Unified Login ile sunulur.

10 Sep 2025

Meta'nın message_edit webhook'unu Business Login for Instagram ve Facebook Login for Business için tanıttığı tarih.

Instagram Login hangi webhook alanlarını sunar?

Bunlar Meta'nın alan tablosundan alınmıştır; her birini neyin tetiklediği ise örneklerden ve webhook referansından alınmıştır. Her alan, gösterilen izne ek olarak instagram_business_basic iznini de gerektirir; Meta, comments ve live_comments bildirimleri için Advanced Access şart koşar.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Hangi alanlar Instagram Login ile kullanılamaz?

Meta'nın alan tablosunun üç satırında Instagram Login izni yoktur; bu nedenle Instagram Login kullanan bir uygulama bunları almaz. Bir alan da yalnızca bu tablonun dışında bulunur:

  • story_insights: bir hikâyenin süresi dolduğunda metrikleri; Facebook Login veya Unified Login ve instagram_manage_insights ile. Meta'nın medya içgörüleri referansı, insights webhook'unun Instagram Login ile desteklenmediğini belirtir.
  • messaging_policy_enforcement ve response_feedback: yalnızca Meta'nın Instagram Messaging API'sinin sütununda bulunur.
  • Kendi alanı olarak mentions: Facebook Login ve Unified Login bunu instagram_manage_comments ile birlikte listeler; Instagram Login ise mentions'ı comments içine katar.

Alanlara nasıl abone olunur?

İki yerde. Uygulama Panelinde, Instagram ürününün webhook ayarları altında geri çağırma URL'sini ve doğrulama token'ını kaydedin; bu, Meta'nın doğrulama isteğini tetikler. Sonra alanları seçin; yeni bir Instagram ürünü bunlardan sekizine başlangıçta abone olur. Ardından her hesabı graph.instagram.com üzerinde POST /<IG_ID>/subscribed_apps ile abone yapın; subscribed_fields, panelde seçilen alanlara virgülle ayrılmış olarak ayarlanır.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

Her hesap farklı alanlar alabilir mi?

Hayır. Meta'nın kurulum rehberi, alanların uygulama kullanıcısının her hesabı için ayrı ayrı seçilemeyeceğini söyler: bir hesap, uygulama için seçilen alanları alır. Hesabın aboneliğindeki subscribed_fields, panelin alanlarını listelemeyi amaçlar; bu nedenle işleyici, uygulamanın seçtiği herhangi bir alanı bekler ve bir hesaptan ne istediğine göre değil, her olayın ne içerdiğine göre karar verir.

Bir bildirimde alanlar nasıl ayırt edilir?

Girişin yapısına göre. Yorum alanları bir changes dizisi içinde gelir; her değişiklik alanının adını belirtir. Mesajlaşma alanları ise alan adı olmadan bir messaging dizisi içinde gelir; sender, recipient ve timestamp'in yanındaki anahtar onları birbirinden ayırır:

  • changes[].field: comments veya live_comments; yorum value içinde gelir.
  • message: messages; hesabın kendi mesajlarının yankıları dahil, bunlar is_echo değerini true olarak taşır.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • sender'ın yanındaki referral: messaging_referral. message içindeki bir referral ise yeni bir konuşmadan veya Click-to-Direct reklamından gelir ve messages alanına aittir.
  • pass_thread_control, take_thread_control veya request_thread_control: messaging_handover; Meta'nın webhook referansı bunları böyle listeler.

easyCoexistence hangi alanlara abone olur?

comments, messages ve mentions; bağlantı kurulduğunda her Instagram hesabının abone olduğu liste budur. Instagram Login ile mentions, comments içinde gelir; bu nedenle abonelik comments ve DM'leri kapsar, DM'ler arasında da yankılar, Hikâye yanıtları, Hikâye etiketlemeleri ve ekler bulunur. Tablodaki diğer alanlar Meta tarafından yalnızca onlara abone olan bir uygulamaya iletilir ve bir bağlantının aboneliğinin parçası değildir. set_social_webhook_destination ile veya Partner API ile bir uç nokta ayarlandığında easyCoexistence Meta'nın imzasını doğrular, Meta'ya hemen yanıt verir ve hesap için her girişi ona POST eder:

  • platform ve external_id: instagram ve hesabın Instagram ID'si, entry.id ile eşittir.
  • account_id: easyCoexistence'taki bağlantının ID'si; MCP araçlarının aldığı ID budur.
  • entry: hesap için Meta'nın girişi, değiştirilmeden. Meta'nın object alanı ve X-Hub-Signature-256 başlığı iletilmez.
  • X-EC-Signature: t=<unix>,v1=<hex>; zaman damgasının, bir noktanın ve ham gövdenin HMAC-SHA256'sı, hesabın kendi gizli anahtarıyla imzalanır.
  • İletim: en fazla 8 saniyelik tek bir deneme; yönlendirme takip edilmez, bir kopya tutulmaz ve yeniden deneme yapılmaz.

Yaygın hatalar

  • Instagram Login ile bir mentions alanını beklemek. Meta, mentions'ı yorum bildirimine katar; bu nedenle yalnızca mentions alanına bağlı bir işleyici hiç çalışmaz.
  • Bir hesabın yalnızca kendi aboneliğinin adını andığı alanları aldığını varsaymak. Meta, uygulama için seçilen alanları iletir; bu nedenle her olayın ne içerdiğine göre dallanın.
  • message.referral ile en üst düzey referral'ı tek bir olay saymak. Birincisi messages üzerinde gelir; ikincisi ise mevcut bir konuşmada açılan bir ig.me bağlantısı için messaging_referral'dır.
  • Instagram Login ile story_insights'ı beklemek. Meta bunu orada kullanılamaz olarak işaretler; bu nedenle bir Hikâye'nin metriklerini, yayında olduğu sürece insights uç noktasından okuyun.
Bunu EasyCoexistence'la yapmak

Olaylar varsayılan olarak saklanmaz; otomasyonu açık olan bir hesap DM'lerini ve yorumlarını 7 gün tutar. Uç noktayı Claude'dan veya ChatGPT'den set_social_webhook_destination ile ya da Partner API ile ayarlayın. Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Instagram Login'in mentions webhook alanı var mı?

Ayrı bir alan yok. Meta, Instagram Login için mentions'ı comments bildirimine dahil eder; mentions ise Facebook Login ve Unified Login ile kendi alanıdır.

story_insights, Instagram Login ile kullanılabilir mi?

Hayır. Meta'nın alan tablosu bunu Instagram Login için kullanılamaz olarak işaretler; medya içgörüleri referansı da insights webhook'unun orada desteklenmediğini belirtir.

Instagram mesaj webhook'u hangi izinleri gerektirir?

instagram_business_basic ve instagram_business_manage_messages, Advanced Access ile birlikte; Meta'nın kurulum rehberi bunu Instagram Login webhook'ları için listeler.

Meta, Instagram için message_edit webhook'unu ne zaman ekledi?

10 Eylül 2025'te; Business Login for Instagram ve Facebook Login for Business için. Bir düzenleme, messaging dizisinde message_edit anahtarı altında gelir.

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