Instagram API nedir, nasıl alınır? DM otomatik yanıt, yorumdan DM, token ve limitler

Instagram API ile işletme ya da içerik üretici hesabını kendi yazılımına (bot, CRM, n8n) bağlarsın; DM'lere yanıt verir, gönderiye yorum yapan kişiye DM'den tek bir özel mesaj atar, yorumları yönetir, gönderi ve reels yayımlarsın. Meta'nın resmî arayüzü. İlk DM'i işletme başlatamaz: kullanıcı yazınca 24 saat içinde yanıt verirsin. İki kurulum yolu var: Instagram Login (Facebook Sayfası gerekmez) ve Facebook Login (Sayfa şart). Belgelerde API için bir ücret yazmıyor; kendi hesabın için uygulama incelemesi de gerekmez.

Ne yapar: Instagram hesabını bota, CRM'e ya da n8n'e bağlar
Hesap türü: Yalnız işletme ya da üretici hesabı
Facebook Sayfası: Instagram Login'de gerekmez
İlk DM: İşletme başlatamaz
Yorumdan DM: Yorum başına 1 mesaj, 7 gün
Kodsuz mu: Hayır; n8n ya da kod gerekir
Ücret: Belgelerde ücret yok

Instagram API ne işe yarar?

Instagram uygulamasında elle yaptığın işleri programla yaptırırsın: gelen DM'ler ve yorumlar webhook ile (Meta'nın sunucuna gönderdiği anlık bildirim) yazılımına gelir; yazılım yanıtı API üzerinden geri yollar. Botlar, CRM ve e-ticaret paneli böyle Instagram'a bağlanır.

DM'lere otomatik yanıtNe alırsın: Otomatik DM yanıtıAyrı kurulum gerekir Yorum yapana DM'den özel yanıtNe alırsın: Özel yanıt (private reply)Ayrı kurulum gerekir Gönderi ve reels yayımlamakNe alırsın: Yayımlanmış gönderiAyrı kurulum gerekir

Özellik	Instagram Login	Facebook Login
Facebook Sayfası	Gerekmez	Gerekir
DM (mesajlaşma)	Var	Var (Messenger Platform üzerinden)
Yorum yönetimi, yayın, içgörü, bahsetmeler	Var	Var
Hashtag araması, ürün etiketleme, partnerlik reklamı	Yok	Var
Adres	graph.instagram.com	graph.facebook.com

Kime yarar: DM'lere hızlı yanıt, "fiyat" yazana otomatik bilgi, yorum moderasyonu ve zamanlanmış paylaşım isteyen işletmeler ve onlara kurulum yapan geliştiriciler. Kişisel (profesyonel olmayan) hesaplarla çalışmaz.

Instagram API nasıl alınır? Kurulum ve erişim jetonu

Hesabını profesyonel hesaba çevir. Instagram ayarlarından işletme ya da içerik üretici hesabı. Facebook Sayfası gerekmez.
Meta geliştirici hesabı aç, uygulama oluştur. developers.facebook.com/apps'te uygulamaya Instagram › "API setup with Instagram login" ürününü ekle; Instagram app ID ve secret burada görünür.
İzinleri iste. instagram_business_basic, instagram_business_manage_messages, instagram_business_manage_comments, gerekirse instagram_business_content_publish.
Jetonu al. Giriş akışı 1 saat geçerli bir kod verir; kod 1 saatlik kısa ömürlü jetona, o da 60 günlük uzun ömürlü jetona çevrilir. Yalnız kendi hesabın içinse giriş akışı kurmadan panodan uzun ömürlü jeton alabilirsin.
Webhook'u kur. Mesaj ve yorum bildirimleri için webhook adresini uygulamada tanımla ve gerekli alanlara abone ol.

Uygulama incelemesi (App Review) gerekir mi?

Yalnız kendi hesabın ya da yönettiğin hesaplar için Standard Access yeter; App Review gerekmez. Uygulamanı rolü olmayan başka işletmelerin hesaplarına açacaksan Advanced Access gerekir: App Review ve işletme doğrulaması. Test edenlerin uygulamada ve Instagram hesabında rolü olmalı.

Uzun ömürlü jeton 60 gün sonra dolar. Jeton en az 24 saatlikken ve süresi dolmadan yenilenir (refresh_access_token); yenileme 60 gün daha verir. Yenilemeyi takvime ya da otomasyona bağla, yoksa bot sessizce durur.

Instagram DM otomatik yanıt ve yorumdan DM'e geçiş nasıl kurulur?

Kullanıcı yazar ya da yorum yaparWebhook n8n'deki Webhook düğümüne ya da kendi sunucuna gelir.

Bot yanıtı hazırlarYapay zekâ ya da anahtar kelime kuralı; gerekirse insana aktarır.

Yanıt API'den giderDM'e 24 saat içinde; yoruma 7 gün içinde tek özel mesaj.

Yorumdan DM'de kişi yanıt vermezse ikinci mesaj gönderilemez.

Webhook düğümü ekle; adresini Meta uygulamasında Instagram webhook'u olarak kaydet ve doğrula.
Gelen olayı ayır: DM ise metni yapay zekâ düğümüne ver; yorum ise yorum kimliğini al.
Yanıtı HTTP Request düğümüyle /<IG_ID>/messages uç noktasına gönder: DM'de alıcı kullanıcı kimliği, yorumdan DM'de alıcı olarak yorum kimliği verilir.

Yorum yapan kişiye özel yanıt (private reply), Instagram Login yolunda:

Yoruma özel yanıt (örnek istek)

› curl -X POST "https://graph.instagram.com/<SURUM>/<IG_ID>/messages" -H "Authorization: Bearer <ERISIM_JETONU>" -H "Content-Type: application/json" -d '{"recipient":{"comment_id":"<YORUM_ID>"},"message":{"text":"Merhaba! Fiyat listesini buradan gönderiyorum."}}'

DM botu sistem talimatı (örnek)"Sen [Mağaza adı] Instagram hesabının mesaj asistanısın. Yalnız mağazanın ürünleri, stok, kargo süresi, iade koşulları ve sipariş durumu hakkında yanıt ver; diğer konularda "Bu konuda yardımcı olamıyorum" de. Ödeme sorunu, para iadesi, şikâyet, sağlık ya da hukuki soru gelirse yanıt verme; "Sizi ekibimize aktarıyorum" yaz ve sohbeti insana devret. Kart numarası isteme, kart bilgisi paylaşılırsa kullanma. Kendini otomatik asistan olarak tanıt. Fiyat ve stok uydurma; bilmiyorsan insana aktar. Kısa ve Türkçe yaz."Bu metin bir örnek. Meta politikası mesajda kart numarası istemeyi yasaklar ve otomatik sohbetlerde insana devir yolu ister.

Instagram mesaj kuralları: 24 saat, 7 gün ve yorumdan DM

Standart mesaj penceresi (24 saat)

İnsan temsilci penceresi (7 gün)

Yoruma özel yanıt (7 gün, tek mesaj)

Şema: kullanıcı yazınca 24 saatlik pencere açılır, bu sürede bot ya da temsilci yazabilir. İnsan temsilci human_agent etiketiyle 7 güne kadar yanıt verebilir. Yorum yapan kişiye yorumdan sonraki 7 gün içinde yalnız bir özel mesaj gider.

İlk DM'i işletme başlatamaz. Konuşma kullanıcı DM attığında, story'de bahsettiğinde ya da yorum yaptığında başlar.
Standart pencere: çoğu durumda 24 saat. Click-to-Direct reklamından gelen ilk mesajda 7 güne kadar.
Human Agent (7 gün): yalnız gerçek bir insanın yanıtı için (ör. hafta sonu kapalıyken). Bot yanıtı için kullanılmaz.
Yorumdan DM (private reply): yorum başına tek mesaj, 7 gün içinde; canlı yayında yalnız yayın sürerken. Kişi yanıt verirse 24 saat içinde konuşma sürer. Mesaj takip edenin gelen kutusuna, takip etmeyenin İstekler klasörüne düşer.
Hız: mesaj gönderme metin, bağlantı, tepki ve çıkartmada saniyede 100, ses ve videoda saniyede 10 çağrı (genel sınır saniyede 2); gönderi ve reels yorumlarına özel yanıt saatte 750.
Onay ve çıkış: Meta politikası yasaya uygun onay olmadan mesaj atmayı yasaklar ve sürekli bir çıkış (opt-out) yolu ister. Yasa gerektiriyorsa kullanıcıya bot olduğunu söylemelisin.

Instagram API ile gönderi ve reels paylaşımı

Medya kapsayıcısı oluştur. /<IG_ID>/media uç noktasına image_url ya da video_url ver. Meta dosyayı o adresten çeker; medya yayın anında herkese açık bir sunucuda olmalı.
Kapsayıcıyı yayımla. /<IG_ID>/media_publish ile.
Kalan hakkını kontrol et. /<IG_ID>/content_publishing_limit ile.

24 saatlik kayan sürede hesap başına en çok 100 API gönderisi; karusel tek gönderi sayılır.
Görsel yalnız JPEG. Karusel en çok 20 görsel ya da video.
Gerekli izin: instagram_business_content_publish (Facebook Login yolunda instagram_content_publish).

Instagram API ücretli mi?

Meta'nın Instagram Platform belgelerinde API çağrısı için bir ücret ya da fiyat sayfası yok; kullanım erişim düzeyi (Standard / Advanced) ve hız limitleriyle sınırlanıyor. Açık bir "ücretsiz" ifadesi de yazmıyor. Ücret çıkaran kısımlar genelde dışarıda: sunucu, n8n barındırma, yapay zekâ modeli ve varsa Click-to-Direct reklamı.

Kodsuz araçlar (Meta iş ortağı DM otomasyon araçları) kendi aboneliklerini alır; onlar da bu API'yi kullanır.

Türkiye'den kullanım ve Türkçe

Türkçe DM ve yanıtVar	Mesaj metnini Türkçe yazarsın; API dil kısıtı koymaz.
Türkçe geliştirici belgesiYok	Belgeler İngilizce.
Türkiye'ye özel kısıtNet değil	Resmî kaynakta Türkiye'ye özel bir kısıt yazmıyor.

Veriler, saklama ve KVKK

Ne kadar saklanır

Meta Platform Şartları: Platform Verisini meşru iş amacı için gerekmediğinde, kullanıcı silinmesini istediğinde ya da Meta istediğinde mümkün olan en kısa sürede silmelisin; kullanıcıya kolay bir silme talebi yolu sunmalısın.

Ne için kullanılır

Mesajlaşmada kişilerle ilgili veri (mesaj içeriği dışında) yalnız seçtiğin mesaj türünü desteklemek için kullanılabilir. Instagram verisini yalnız içerik göstermek, yedeklemek ya da takipçi yönetmek için izinsiz kullanamazsın.

Yasak içerik

Mesajda kart numarası ya da finansal hesap numarası istenmez; sağlık hizmeti sağlayıcısıyla hasta yazışması için kullanılmaz; dijital ürün satılmaz.

KVKK

DM'ler ve yorumlar Meta altyapısında ve senin sunucunda işlenir. Yurt dışına aktarım KVKK md. 9'a göre yeterlilik kararı ya da uygun güvence ister; aydınlatma metninde Instagram kanalını belirt. Hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Hesabım listede çıkmıyor	Hesap profesyonel (işletme ya da üretici) olmalı. Facebook Login kullanıyorsan hesap bir Facebook Sayfasına bağlı ve Sayfada görevin olmalı.
Bot birden çalışmayı bıraktı	Uzun ömürlü jeton 60 günde dolar. Süresi dolmadan refresh_access_token ile yenile.
Kullanıcıya ilk mesajı atamıyorum	Kural bu: konuşmayı kullanıcı başlatır. Yorum yaptıysa 7 gün içinde tek özel yanıt gönderebilirsin.
Yorumdan DM'de ikinci mesaj gitmiyor	Yorum başına tek özel mesaj hakkın var; kişi yanıt verirse 24 saat içinde devam edebilirsin.
Başka bir işletmenin hesabı bağlanmıyor	Rolü olmayan hesaplar için Advanced Access gerekir: App Review ve işletme doğrulaması.
Gönderi yayımlanmıyor	Medya adresi herkese açık olmalı, görsel JPEG olmalı; 24 saatte 100 gönderi sınırını content_publishing_limit ile kontrol et. Sayfa yayın yetkilendirmesi (PPA) bekleyen hesaba yayın yapılamaz.
Eski istek mesajları API'de görünmüyor	İstekler klasöründe 30 gün etkin olmayan konuşmalar API'de dönmez.

Kodsuz alternatifler

Kod yazmak istemiyorsan Meta'nın iş ortağı olan DM otomasyon araçları (ör. ManyChat) aynı API'yi arayüzle sunar; ayrıca abonelik ücretleri olur. Gelen kutusu araçları da Instagram DM'i bağlayabilir.

Sık sorulan sorular

Instagram API nedir?

Meta'nın işletme ve içerik üretici hesaplarını bir yazılıma bağlayan resmî arayüzü. DM'lere yanıt, yorum yönetimi, yorumdan DM, gönderi ve reels yayımlama ve içgörü okuma yapar.

Instagram API nasıl alınır?

Hesabını profesyonel hesaba çevirirsin, developers.facebook.com'da uygulama oluşturup Instagram ürününü eklersin, izinleri isteyip erişim jetonu alırsın. Kendi hesabın için uygulama incelemesi gerekmez.

Instagram API ücretli mi?

Meta'nın belgelerinde API için bir ücret ya da fiyat sayfası yok; kullanım erişim düzeyi ve limitlerle sınırlı. Sunucu, otomasyon aracı ve yapay zekâ modeli ayrıca ücret çıkarabilir.

Instagram API erişim jetonu ne kadar geçerli?

Kısa ömürlü jeton 1 saat, uzun ömürlü jeton 60 gün geçerli. Uzun ömürlü jeton en az 24 saatlikken ve süresi dolmadan yenilenirse 60 gün daha geçerli olur.

Instagram DM otomatik mesaj kurulabilir mi?

Evet. Kullanıcı yazdıktan sonra 24 saat içinde bot yanıt verebilir. İlk mesajı işletme başlatamaz ve otomatik sohbette insana devir yolu olmalı.

Yorum yapan herkese DM atılabilir mi?

Evet, yorum başına tek bir özel yanıt, yorumdan sonraki 7 gün içinde. Kişi yanıt verirse 24 saat içinde konuşma sürer; gönderi ve reels için saatte en çok 750 özel yanıt.

Instagram API için Facebook Sayfası gerekir mi?

Instagram Login yolunda gerekmez. Facebook Login yolunda profesyonel hesabın bir Facebook Sayfasına bağlı olması gerekir; hashtag araması ve ürün etiketleme yalnız bu yolda.

Kişisel Instagram hesabıyla API kullanılır mı?

Hayır. API yalnız işletme ya da içerik üretici (profesyonel) hesaplarla çalışır.

Instagram API ile günde kaç gönderi paylaşılır?

24 saatlik kayan sürede hesap başına en çok 100 gönderi; karusel tek gönderi sayılır. Medya herkese açık bir adreste olmalı.

Uygulama incelemesi (App Review) gerekir mi?

Yalnız kendi hesabın ya da yönettiğin hesaplar için gerekmez. Başka işletmelerin hesaplarına hizmet verecek uygulama Advanced Access için App Review ve işletme doğrulamasından geçer.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: API kullanımının ücretsiz olduğu açıkça yazmıyor (fiyat sayfası yok) · App Review süresi · Türkiye'ye özel kısıt · yayın sınırı için ikinci resmî sayfa. Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.