Instagram yorum webhook'u: payload, alanları tek tek
Instagram'ın yorumlar için webhook alanı, profesyonel bir hesabın medyasına (Reels dahil) bir yorum yapıldığında ya da bir yoruma yanıt verildiğinde uygulamayı bilgilendirir. Meta, field değeri comments olan bir değişiklik gönderir; bu değişiklikte value, yorumun id ve text değerlerini, yazarın Instagram'a özgü ID'sini ve kullanıcı adını from içinde, medyanın id ve product type değerlerini taşır. Yorum bir yanıtsa parent_id de bulunur.
easyCoexistence, bağlı her Instagram hesabını yorumlara abone eder ve Meta'nın o hesap için teslim ettiği comments olaylarını geldikleri anda HTTPS uç noktanıza iletir.
Yorum bir yanıtsa, yanıt verdiği yorumun ID'sini taşır.
Hesap kendi medyasına yorum yaptığında, hesabın kendi ID'sinin yanında from alanına eklenir.
Canlı yayın sırasındaki yorumlara ayrılmış ayrı bir alan; yayın bittiğinde bildirimleri durur.
comments ve live_comments bildirimleri için gereklidir; özel hesapların medyası hiçbir bildirim tetiklemez.
Yorumcuya özel bir yanıt göndermek için kalan süre, yorumun ID'siyle adreslenir.
Comments alanı ne zaman tetiklenir?
Biri, profesyonel hesabın sahip olduğu bir medyaya yorum yaptığında veya hesaptan bahsettiğinde, uygulama ve hesap alana abone olduğunda. Her yorum bildirimde bir değişikliktir ve bu durumlar aynı yapıyı paylaşır:
- Bir gönderi, Reel, Hikaye veya reklamda yeni bir yorum; media.
media_product_type, medyanın hangi yüzeyde olduğunu belirtir. - Mevcut bir yorumun altındaki yanıt; yanıtladığı yorumun ID'sini taşıyan
parent_idiçerir. - Hesabın kendi medyasında yaptığı yorum, yanıtları dahil: from.id hesabın kendi ID'sidir ve from,
self_ig_scoped_idekler. - Hesaba @ ile bahsetme: Instagram Login ile Meta, bahsetmeleri kendi alanı yerine comments bildirimine ekler.
- Canlı yayın sırasındaki bir yorum, aynı değer yapısıyla ayrı
live_commentsalanına gelir ve yayın bitince durur.
Bir yorum bildirimi nasıl görünür?
JSON'unda object değeri instagram ve bir entry dizisi bulunan bir POST isteğidir. Her entry tek bir profesyonel hesaptır: ID'si, Meta'nın bildirimi gönderdiği zaman ve yorum başına bir değişiklik tutan bir changes dizisi. Bir Reel'deki yanıt şöyle görünür:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}Her alan ne anlama gelir?
Meta'nın webhook referansının bir yorum için listelediği alanlar, dıştan içe doğru:
- entry[].id: profesyonel hesabın ID'si, /me'nin bunun için döndürdüğü
user_id. Yorumun hangi hesaba ait olduğunu gösterir. - entry[].time: Meta'nın bildirimi gönderdiği zaman, Unix zaman damgası olarak. Yorumun yazıldığı zaman değildir.
- changes[].field: comments, ya da bir canlı yayın için
live_comments. value'yu okumadan önce kontrol edin. - value.id: yorumun ID'si; herkese açık ya da özel olarak yanıtlamak, gizlemek veya silmek için kullanılan ID.
- value.text: yorumun metni; yorumda metin varsa eklenir.
- value.from.id ve value.from.username: yazarın Instagram'a özgü ID'si ve kullanıcı adı. value.from.
self_ig_scoped_id, yorumu hesabın kendisi yazdığında görünür. - value.media.id ve value.media.
media_product_type: yorum yapılan medya ve yüzeyi; Meta'nın medya referansı AD, FEED, STORY ve REELS değerlerini belirtir. - value.
parent_id: bir yanıtta, yanıtladığı yorumun ID'si. Üst düzey bir yorumda bu alan yoktur. - value.media.
ad_id,ad_titleveoriginal_media_id: referansta bir reklama yapılan yorumlar için listelenir.
Yorum alanı neyi bildirmez?
Bir işleyicinin bekleyebileceği bazı şeyler olaya dahil edilmez ya da hiç gönderilmez; Meta'nın kurulum rehberi ve referanslarına göre:
- Özel bir hesaba ait medyadaki yorumlar: Meta bunlar için yorum ya da bahsetme bildirimi göndermez.
- Albüm ID'leri: olay bunları içermez ve Meta albümü yorum ID'siyle aramanızı söyler.
- Dinamik reklamlarda kullanılan medyanın reklam ID'leri.
- Yorumun oluşturulma zamanı: GET /<
COMMENT_ID>?fields=timestamp bunu ISO 8601 biçiminde döndürür. - Yayın bittikten sonraki canlı yorumlar; canlı medyanın bildirimleri durur.
- Hikaye bahsetmeleri: Meta'nın bahsetme API'si bunları desteklemez, bunun yerine DM olarak hesaba ulaşırlar.
- Geçmiş olaylar: Meta sorgulanacak bir bildirim geçmişi tutmaz; bu yüzden her olay geldikçe ihtiyacınız olanı saklayın.
Comments alanı neye ihtiyaç duyar?
Instagram Login ile instagram_business_basic ve instagram_business_manage_comments izinleri ve Meta'nın comments ile live_comments bildirimleri için zorunlu kıldığı Advanced Access. Uygulama App Dashboard'da Live olmalı ve comments alanına abone olmalı; her hesap da POST /<IG_ID>/subscribed_apps üzerinden, subscribed_fields içinde comments ile abone edilmelidir. Meta, yorumlar için bu webhook'u yoklamaya (polling) tercih etmeyi kesinlikle önerir; hız sınırını da korur.
Olaydaki bir yoruma nasıl yanıt verilir?
Olayın taşıdığı ID'lerle. POST /<COMMENT_ID>/replies, bir message alanıyla ve value.id kullanarak yorumun altına herkese açık bir yanıt gönderir. POST /<IG_ID>/messages, recipient.comment_id değerini value.id olarak ayarlayarak yazara bir özel yanıt gönderir; bu yanıt yorumdan sonraki 7 gün içinde ya da canlı yayında yayın sürerken gönderilebilir. from.id Instagram'a özgü bir ID'dir, ancak kişi hesaba mesaj göndermeden bu ID'ye doğrudan yapılan bir DM başarısız olur. Bu yüzden kişiye DM ile ulaşmanın yolu özel yanıttır.
easyCoexistence bir yorumu nasıl iletir?
Geldiği anda, hesap için Claude ya da ChatGPT'den set_social_webhook_destination ile ya da Partner API'de PUT /channels/:id/webhook ile bir uç nokta ayarlandıktan sonra. easyCoexistence, bağlı her hesabı yorumları, bahsetmeleri ve DM'leri taşıyan alanlara abone eder, her teslimatta Meta'nın imzasını kontrol eder, Meta'ya hemen yanıt verir ve o hesaba ait her entry'yi bir zarf içinde HTTPS URL'nize POST eder:
- platform ve
external_id: instagram ve hesabın Instagram ID'si; entry.id ile eşittir. account_id: easyCoexistence'deki bağlantının ID'si;list_social_accountsbunu döndürür ve MCP araçları bunu kullanır.- entry: hesap için Meta'nın entry'si, değiştirilmeden; böylece toplu bir teslimat her entry için bir POST olur. Meta'nın object alanı ve X-Hub-Signature-256 iletilmez.
- Teslimat: tek bir deneme, en fazla 8 saniye beklenerek, yönlendirme takip edilmeden, herkese açık bir IP'ye çözümlenen bir HTTPS adresine. Hiçbir kopya tutulmaz ve yeniden deneme yapılmaz.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}Yorumdan DM'e kuralları aynı olayla ne yapar?
Bunlar olayı iletmeyle birlikte okur. Bir kural, yorum seçilen bir gönderide ya da tüm gönderilerde anahtar kelimelerinden birini içerdiğinde (büyük/küçük harf fark etmeksizin) eşleşir ve kuralın DM'ini yazara özel yanıt olarak gönderir; kuralda bir herkese açık yanıt da varsa onu da ekler. Hesabın kendi yorumları atlanır. Bir yoruma başlayan otomasyonlar, hiçbir kuralın yanıtlamadığı yorumları alır; bir kuralın yanıtladığı yorum yine de uç noktanıza ulaşır. Kuralın herkese açık yanıtı, hesabın kendisinden yeni bir comments olayı olarak geri dönebilir.
Yaygın hatalar
- comment_id aramak. Instagram Login altında yorumun ID'si value.id içindedir; comment_id, Meta'nın diğer giriş kurulumlarının payload'larına aittir.
- Hesabın kendi yorumlarına yanıt vermek. Bunların yanıtları, from.id değeri entry.id'ye eşit olan comments olayları olarak geri döner; onlara yanıt veren bir otomasyon kendi kendisiyle konuşmaya başlar.
- entry.time'ı yorumun zamanı sanmak. Meta'nın bildirimi gönderdiği zamanı kaydeder; yorumun kendi timestamp alanı, yazıldığı zamanı söyler.
- Canlı yorumları comments alanında beklemek. Bunlar live_comments alanına gelir; bu alan kendi aboneliğini ister ve yayın bittiğinde sessizleşir.
Olaylar o hesabın gizli anahtarıyla imzalanır ve hiçbir kopya tutulmaz. Yorumdan DM'e kuralları ve otomasyonlar aynı yorumlara gece gündüz yanıt verir. Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar, bağlantı eklendikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Instagram yorum webhook'u yanıtları da içerir mi?
Evet. Bir yanıt, kendi comments olayı olarak gelir; yanıt verdiği yorumun ID'sini taşıyan parent_id alanıyla birlikte.
Reels yorumları Instagram yorum webhook'unu tetikler mi?
Evet. Bir Reel'deki yorum, bir gönderideki gibi comments alanında gelir; media.media_product_type ikisini ayırt eder.
Instagram yorum webhook'um neden tetiklenmiyor?
En sık neden: uygulama Live değildir ya da Advanced Access'e sahip değildir, hesap hiç /subscribed_apps üzerinden abone edilmemiştir, medya özel bir hesaba aittir ya da yorum live_comments kullanan bir canlı yayında yapılmıştır.
Yorum webhook'u yorumcunun kullanıcı adını içerir mi?
Evet. value.from, kişinin kullanıcı adını Instagram'a özgü ID'siyle birlikte taşır; kimin yorum yaptığını göstermek için ek bir çağrı gerekmez.
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