Bu rehberde: Instagram profesyonel hesabınızı (İşletme veya İçerik üreticisi) Instagram ile giriş yaparak bağlarsınız. Facebook Sayfası gerekmez. Platform yöneticisi Meta uygulamasına Instagram ürününü ekler; siz Bağla deyip Instagram hesabınızla izin verirsiniz. Yayın kurallarını (görsel zorunlu, JPEG) ve günlük kotayı öğrenirsiniz.
⏱ 15 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | INSTAGRAM |
| Kategori | Sosyal medya |
| Kimlik doğrulama | İzin ekranı (Instagram API with Instagram Login) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Gönderi ve video yayınlama, metrik okuma, yorum okuma, yorum yanıtlama |
| Kullanan kutular | Yayınla, Zamanla, Metrik al, Yorumları al, Yanıtla |
| Kullanan ajanlar | Content Creator, Social Publisher, Community Manager |
Ne işe yarar?
Görsel, carousel ve Reels yayınlar; gönderi içgörülerini okur; yorumları çekip yanıtlar. Hikâye (Story) yayını desteklenmez.
Ön koşullar
- Instagram profesyonel hesabı: İşletme veya İçerik üreticisi. Kişisel hesap bağlanamaz. Instagram uygulaması → Ayarlar → Hesap türü ve araçlar → Profesyonel hesaba geç. Ücretsizdir.
- Facebook Sayfası gerekmez. Instagram hesabınızın bir Sayfaya bağlı olup olmaması fark etmez.
- Platform yöneticisinin
INSTAGRAM_APP_IDveINSTAGRAM_APP_SECRETtanımlamış olması. Bunlar Meta uygulamasının genel App ID'si (META_APP_ID) değildir; Instagram ürününün ürettiği ayrı kimliklerdir. - OrqLabs'ta Sahip veya Yönetici rolü.
Adım adım kurulum
A) Meta for Developers (platform yöneticisi, bir kez)
- developers.facebook.com → My Apps → Facebook Page rehberindeki Business uygulamasını açın (yoksa Create App → Business ile oluşturun).
- ① Add product → Instagram → Set up. Açılan sayfada API setup with Instagram login bölümünü seçin.
- Aynı sayfada ① Instagram app ID ve ② Instagram app secret değerlerini kopyalayın (Show ile görüntüleyin). Yönetici bunları
INSTAGRAM_APP_IDveINSTAGRAM_APP_SECRETolarak tanımlar ve API'yi yeniden başlatır. - ③ App settings → Basic'teki App ID / App secret Facebook ve Messenger içindir. Instagram'da bunları kullanırsanız izin ekranı "Invalid platform app" hatası verir.
- 3. Set up Instagram business login → Business login settings:
- ① OAuth redirect URIs:
https://api.orqlabs.com/api/v1/integrations/oauth/instagram/callback. Tam adresi bağlantı penceresinden kopyalayın; birebir aynı olmalıdır. - ② Deauthorize callback URL:
https://api.orqlabs.com/api/v1/meta/instagram/deauthorize, Data deletion request URL:https://api.orqlabs.com/api/v1/meta/instagram/data-deletion. Kullanıcı erişimi kaldırdığında OrqLabs bağlantıyı kapatır ve kayıtlı izinleri siler. - ③ Save.
- ① OAuth redirect URIs:
- Uygulama Development modundayken yalnızca test hesapları bağlanabilir. ① App roles → Roles → Add people → Instagram Tester ile bağlanacak Instagram hesabının kullanıcı adını ekleyin.
- Daveti Instagram'da kabul edin: Instagram uygulaması (veya instagram.com) → Ayarlar → Uygulamalar ve web siteleri → Test davetleri → Kabul et.
- ② İzinler: OrqLabs
instagram_business_basic,instagram_business_content_publish,instagram_business_manage_commentsveinstagram_business_manage_insightsister. Development modunda test hesapları için ek onay gerekmez.
B) OrqLabs'ta bağlama

- Instagram hesabının profesyonel hesap olduğundan emin olun (Ön koşullar).
- Entegrasyonlar → Instagram Business kartında Bağla.
- ① Proje seçin; ② Bağla.
- Instagram giriş ekranında bağlanacak hesapla oturum açın ve izinleri onaylayın. Tarayıcıda başka bir Instagram hesabı açıksa önce çıkış yapın.
- OrqLabs kısa ömürlü izni (1 saat) 60 günlük izne çevirir ve süresi dolmadan otomatik yeniler. Kartta
@kullaniciadigörünür. - Bağlantıyı test et: kullanıcı adı, hesap türü, takipçi ve medya sayısı görünmelidir.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
instagram_business_basic | Hesap bilgisi (kullanıcı adı, hesap türü) ve medya listesi |
instagram_business_content_publish | Görsel, carousel ve Reels yayınlama |
instagram_business_manage_comments | Yorumları okuma ve yanıtlama |
instagram_business_manage_insights | Gönderi içgörüleri (görüntülenme, erişim, kaydetme, paylaşım) |
Eski instagram_basic, instagram_content_publish, pages_show_list gibi Facebook Login izinleri artık istenmez.
Uygulama incelemesi
- Kendi hesabınız (veya ekibinizin hesapları) için App Review gerekmez: Development modu + Instagram Tester yeterlidir.
- Başka kişilerin/işletmelerin hesaplarını bağlamak için dört izne Advanced Access (App Review) ve Business verification gerekir. İnceleme videosunda bağlanma, yayın, içgörü ve yorum yanıtlama akışlarını gösterin;
instagram_business_content_publishiçin OrqLabs'ın onay adımını gösterin. - Uygulama Live moda alınmadan test kullanıcısı olmayan hesaplar bağlanamaz.
Limitler
| Konu | Sınır |
|---|---|
| Yayın kotası | Hesap başına 24 saatte 100 API gönderisi (carousel tek sayılır) |
| Metin | 2.200 karakter; ilk 125 görünür |
| Hashtag | 30 |
| Görsel | JPEG zorunlu (PNG desteklenmez), en fazla 8 MB, en boy 4:5 – 1.91:1, önerilen 1080 px |
| Video / Reels | MP4/MOV, 3 sn – 15 dk, 9:16 önerilir, en fazla 1 GB |
| Carousel | 2-10 medya |
| Medya kaynağı | Herkese açık adres zorunlu |
| İçgörü | Bazı metrikler 100+ takipçi gerektirir |
| İzin süresi | 60 gün; OrqLabs son 7 günde otomatik yeniler |
Yayın iki adımlıdır (kap oluştur → yayınla); OrqLabs bunu yönetir.
Bağlantıyı test etme

② Bağlantıyı test et hesap bilgisini okur. Ardından test modunda Yayınla kutusuyla medya doğrulamasını (JPEG, oran) yapın. Görsel üret kutusu ve İçerik sayfasındaki Görsel üret görselleri doğrudan JPEG olarak üretir.
Kimlik bilgilerini yenileme
- 60 günlük izin, kullanıldıkça son 7 gün içinde otomatik yenilenir. 60 gün hiç kullanılmazsa süresi dolar; Yeniden yetkilendir ile bağlayın.
- Instagram'da Ayarlar → Uygulamalar ve web siteleri bölümünden OrqLabs'ı kaldırırsanız izin anında geçersizleşir ve kart "Yeniden yetkilendirme gerekli" olur.
- Hesabı kişisel hesaba geri çevirirseniz yayın durur.
- Daha önce Facebook Sayfası üzerinden bağlanmış Instagram hesapları çalışmaya devam eder; Yeniden yetkilendir dediğinizde yeni Instagram Login yöntemine geçer.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "Invalid platform app" | INSTAGRAM_APP_ID yerine Meta App ID kullanılmış | Instagram → API setup with Instagram login'deki Instagram app ID / secret'ı tanımlayın |
| "Invalid redirect_uri" | Adres Business login settings'te kayıtlı değil | Bağlantı penceresinden kopyalayıp birebir ekleyin |
| "Insufficient developer role" / giriş reddedildi | Hesap test kullanıcısı değil veya davet kabul edilmedi | Instagram Tester ekleyin; daveti Instagram'da kabul edin |
| "Invalid scope" | Uygulamada Instagram ürünü (Instagram login) kurulmamış | A bölümündeki 1-5. adımları tamamlayın |
| Giriş sonrası hata / hesap görünmüyor | Hesap kişisel | Profesyonel hesaba geçin |
INVALID – kod 9004 | Medya adresi erişilemez veya PNG | Herkese açık JPEG adresi |
INVALID – kod 36003 "aspect ratio" | En boy oranı aralık dışı | 4:5 – 1.91:1 arasına kırpın |
INVALID – kod 9007 "media not ready" | Video işlenmesi bitmedi | Zaman aşımını artırın |
RATE_LIMIT – kod 9 | Günlük kota | 24 saat bekleyin |
AUTH – kod 190 | İzin geçersiz veya süresi dolmuş | Yeniden yetkilendir |
INVALID – kod 10 "Permission denied" | Başka birinin hesabı ve Advanced Access yok | App Review |
| İçgörü boş | Yeterli takipçi yok | 100+ takipçi; birkaç saat bekleyin |
| Görsel boş yayın hatası | Instagram görsel ister | Görsel üret kutusu ekleyin veya görsel adresi sağlayın |
Sık sorulan sorular
Kişisel Instagram hesabımı bağlayabilir miyim? Hayır. İşletme veya İçerik üreticisi hesabına geçmeniz gerekir; ücretsizdir. Facebook Sayfası gerekmez.
Facebook Sayfam var; yine de gerekli mi? Hayır. Instagram Login doğrudan Instagram hesabıyla çalışır. Facebook Sayfanızı ayrıca Facebook Page entegrasyonuyla bağlayabilirsiniz.
Hikâye paylaşabilir mi? Hayır. OrqLabs Instagram'da hikâye yayınlamaz.
Günde kaç gönderi? API üzerinden 24 saatte 100. Pratikte günde 1-3 gönderi idealdir.