Webhook'ta Instagram Story mention'ları ve Story yanıtları
Instagram, Story mention'larını ve Story yanıtlarını messages webhook alanında DM olarak iletir. Bir mention, attachments alanında story_mention türünde bir öğe içeren mesaj olarak gelir; Story'nin CDN URL'si payload.url içindedir. Yanıt, kişinin metnini ve reply_to.story alanını taşır; bu alan Story'nin url ve id değerlerini, link çıkartması olan bir Story için de link_sticker_url değerini içerir.
easyCoexistence, her bağlı Instagram hesabını messages alanına abone eder; böylece Story mention'ları ve Story yanıtları, diğer DM'leriyle birlikte geldikleri anda HTTPS uç noktanıza ulaşır; hesabın sırrıyla imzalanır ve hiçbir kopya tutulmaz.
Birisi hesabı Story'sinde etiketlediğinde Meta'nın gönderdiği messages olayının ek türü.
Meta'nın 12 Aralık 2025'te reply_to.story alanına eklediği alan; yanıtlanan Story'nin link çıkartması URL'sini tutar.
Bir Story'nin ne kadar yaşadığı; süresi dolduğunda ya da silindiğinde mention URL'si görüntülenmeyi durdurur.
Story mention'larının geldiği hesaplar; özel bir hesabın mention'ı yalnızca profesyonel hesabı takip ediyorsa gelir.
Meta'nın Instagram Messaging rehberine göre webhook'un desteklemediği Story yanıtları.
Bir Story mention'ı nasıl gelir?
DM olarak. Bir kişi profesyonel hesabı Story'sinde mention ettiğinde Instagram, bu Story'ye atıfta bulunan bir mesajı hesabın gelen kutusuna koyar ve Meta bunun için bir messages olayı gönderir. sender.id kişinin Instagram'a özgü ID'sidir; message.attachments alanı ise payload.url alanında Story'nin CDN URL'sini taşıyan story_mention türünde tek bir öğe içerir. Meta'nın örneklerinde metin yoktur, bu yüzden eki okuyun:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}Bir Story yanıtı nasıl gelir?
Yine DM olarak; kişinin mesajı ve hesabın Story'sine işaret eden bir reply_to nesnesiyle. reply_to.story, Story'nin CDN url'sini ve id'sini taşır. Meta'nın webhook referansı burada link çıkartması olan Story'lere yanıtlar için Aralık 2025'te eklenen link_sticker_url alanını da listeler; Meta bunu bağlantıya göre otomasyonları yönlendirmek için önerir. Önceki bir mesaja satır içi yanıt ise bunun yerine reply_to.mid kullanır.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Her alan ne anlama gelir?
Meta'nın bu iki olay için belgelediği alanlar, dıştan içe doğru:
- entry[].id ve recipient.id: profesyonel hesap. sender.id: kişinin Instagram'a özgü ID'si; yanıt bu ID'ye gider.
- timestamp: mesajın gönderildiği zaman; Meta'nın örneklerinde milisaniye cinsindendir. entry[].time ise Meta'nın bildirimi gönderdiği andır.
- message.mid: mesaj ID'si; yeniden denemeleri tekilleştirmek ve
reply_to.mid ile yanıt vermek için. - attachments[].type
story_mentionve payload.url: bir mention ve bunu yapan Story'nin CDN URL'si. reply_to.story.url vereply_to.story.id: kişinin yanıtladığı hesabın Story'si.reply_to.story.link_sticker_url: o Story'deki link çıkartmasının URL'si.- message.text: yanıtın kelimeleri; mesaj metin içerdiğinde yer alır.
URL ne kadar çalışır?
Story ne kadar yaşıyorsa o kadar. Bir Story 24 saat sonra ya da yazarı silerse kaybolur; Meta'nın story mention rehberi, o zaman URL'nin görüntülenmeyi durduracağını söyler. Genel bakışı ise Instagram'ın CDN URL'lerinin gizlilik odaklı olduğunu ve silinmiş ya da süresi dolmuş içerik için hiçbir şey döndürmediğini ekler. Aynı rehber CDN URL'sini tutmaya izin verir ama medyayı tutmaya izin vermez: bir uygulama Story'nin içeriğini sunucularında saklamamalı ya da önbelleğe almamalı, Story kaldırıldıktan sonra bir yer tutucu göstermelidir.
İki olaydan hiçbiri ne zaman tetiklenmez?
Meta'nın rehberleri, Story olayı bekleyen bir işleyicinin hiçbir şey alamayacağı bu durumları adlandırır:
- Profesyonel hesabı takip etmeyen özel bir hesabın Story mention'ı.
- Normal bir gönderideki etiket: Meta, messages webhook'unu yalnızca Story mention'larının tetiklediğini, gönderilerdeki etiketlemelerin tetiklemediğini söyler.
- Bir GIF ya da çıkartmayla yapılan Story yanıtı; webhook bunu desteklemez.
- Mention API'si üzerinden Story'ler: GET /<
IG_ID>/tags ve POST /<IG_ID>/mentions bunları desteklemez, bu yüzden bir Story mention'ı DM olarak gelir.
Story mention'ları ve yanıtları mesajlaşma penceresini açar mı?
Yanıt, kişiden gelen bir mesajdır; Meta, Story mention'larını bir kişinin konuşma başlattığı kanallar arasında sayar. Eylemin açtığı pencere çoğu eylem için 24 saat sürer; bu yüzden hesap, pencere açıkken POST /<IG_ID>/messages ile ve recipient.id olarak olayın sender.id değerini vererek yanıt verebilir. Hesabın yanıtı, is_echo değeri true olarak messages üzerinde bir echo olarak geri gelir.
easyCoexistence bunları nasıl iletir?
Her bağlı Instagram hesabının abone olduğu messages alanı üzerinden. Böylece Story mention'ları ve Story yanıtları, hesabın diğer DM'leriyle birlikte uç noktanıza ulaşır: her entry, platform, account_id, external_id ve entry alanlarından oluşan bir zarfın içindedir ve hesabın sırrıyla X-EC-Signature içinde imzalanır, bir kez gönderilir ve hiçbir kopya tutulmaz. send_social_dm, kişiye olayın sender.id değerini recipient_id olarak kullanarak 24 saatlik pencere içinde yanıt verir.
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": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}Yaygın hatalar
- Story'nin medyasını saklamak. Meta'nın story mention rehberi CDN URL'sini tutmaya izin verir, içeriği değil; içerik sunucularınızda saklanmamalı ya da önbelleğe alınmamalıdır.
- Yalnızca message.text okumak. Bir Story mention'ı story_mention türünde bir ek taşır ve Meta'nın örneklerinde metin yoktur; bu yüzden yalnızca metne bakan bir işleyici boş bir mesaj görür.
- Story URL'sini günler sonra göstermek. Story 24 saat sonra süresi dolunca ya da silinince URL çalışmaz; o andan itibaren bir yer tutucu gösterin.
- Story mention'larını yorum alanında ya da mention API'sinde aramak. Meta bunları messages üzerinde DM olarak iletir.
send_social_dm, kişiye 24 saatlik pencere içinde Claude, ChatGPT ya da kendi kodunuzdan yanıt verir. Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında, bağlantı eklendikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Instagram Story mention olayı metin içerir mi?
Meta'nın örneklerinde içermez. Story mention'ı, Story'nin CDN URL'sini taşıyan story_mention türünde bir ek taşır; bu yüzden yalnızca message.text alanını okuyan bir işleyici boş bir mesaj görür.
link_sticker_url nedir?
Yanıtlanan Story'deki link çıkartmasının URL'sidir ve reply_to.story.link_sticker_url alanında yer alır. Meta bunu 12 Aralık 2025'te ekledi ve bağlantıya göre otomasyonları yönlendirmek için önerir.
Bir GIF ya da çıkartmayla verilen Story yanıtları webhook'u tetikler mi?
Hayır. Meta'nın Instagram Messaging rehberi, webhook'un GIF ya da çıkartmayla yapılan Story yanıtlarını desteklemediğini söyler.
Özel hesaplar Story mention webhook'larını tetikler mi?
Yalnızca özel hesap profesyonel hesabı takip ediyorsa. Herkese açık hesaplardan gelen mention'lar gerçekleştikleri anda 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