İçeriğe atla
OrqLabs

Instagram Business

Instagram profesyonel hesabını (İşletme veya İçerik üreticisi) Instagram Login ile bağlama: Meta uygulamasına Instagram ürünü, Instagram app ID/secret, test kullanıcısı, yayın limitleri. Facebook Sayfası gerekmez.

15 dk Son güncelleme:
Bu sayfada
  1. Kimlik kartı
  2. Ne işe yarar?
  3. Ön koşullar
  4. Adım adım kurulum
  5. A) Meta for Developers (platform yöneticisi, bir kez)
  6. B) OrqLabs'ta bağlama
  7. İzinler ve kapsamlar
  8. Uygulama incelemesi
  9. Limitler
  10. Bağlantıyı test etme
  11. Kimlik bilgilerini yenileme
  12. Sık karşılaşılan hatalar
  13. Sık sorulan sorular
  14. Sonraki adım

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ı

AlanDeğer
Sağlayıcı anahtarıINSTAGRAM
KategoriSosyal medya
Kimlik doğrulamaİzin ekranı (Instagram API with Instagram Login)
KapsamProje bazlı
WebhookHayır
YeteneklerGönderi ve video yayınlama, metrik okuma, yorum okuma, yorum yanıtlama
Kullanan kutularYayınla, Zamanla, Metrik al, Yorumları al, Yanıtla
Kullanan ajanlarContent 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_ID ve INSTAGRAM_APP_SECRET tanı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)

Meta – Instagram ürününü ekleme: ① Instagram → Set up. (Temsili görsel)
Meta – Instagram ürününü ekleme: ① Instagram → Set up. (Temsili görsel)
  1. developers.facebook.com → My Apps → Facebook Page rehberindeki Business uygulamasını açın (yoksa Create App → Business ile oluşturun).
  2. ① Add product → Instagram → Set up. Açılan sayfada API setup with Instagram login bölümünü seçin.
Meta – API setup with Instagram login: ① Instagram app ID, ② Instagram app secret, ③ Meta App ID ile karıştırmayın. (Temsili görsel)
Meta – API setup with Instagram login: ① Instagram app ID, ② Instagram app secret, ③ Meta App ID ile karıştırmayın. (Temsili görsel)
  1. Aynı sayfada ① Instagram app ID ve ② Instagram app secret değerlerini kopyalayın (Show ile görüntüleyin). Yönetici bunları INSTAGRAM_APP_ID ve INSTAGRAM_APP_SECRET olarak tanımlar ve API'yi yeniden başlatır.
  2. ③ 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.
Meta – Business login settings: ① OAuth redirect URIs, ② Deauthorize / Data deletion adresleri, ③ Save. (Temsili görsel)
Meta – Business login settings: ① OAuth redirect URIs, ② Deauthorize / Data deletion adresleri, ③ Save. (Temsili görsel)
  1. 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.
Meta – Test hesabı ve izinler: ① Instagram Testers, ② 4 izin, ③ App Review. (Temsili görsel)
Meta – Test hesabı ve izinler: ① Instagram Testers, ② 4 izin, ③ App Review. (Temsili görsel)
  1. 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.
  2. Daveti Instagram'da kabul edin: Instagram uygulaması (veya instagram.com) → Ayarlar → Uygulamalar ve web siteleri → Test davetleri → Kabul et.
  3. ② İzinler: OrqLabs instagram_business_basic, instagram_business_content_publish, instagram_business_manage_comments ve instagram_business_manage_insights ister. Development modunda test hesapları için ek onay gerekmez.

B) OrqLabs'ta bağlama

Bağlantı penceresi (OAuth): ① proje seçimi, ② Bağla düğmesi.
Bağlantı penceresi (OAuth): ① proje seçimi, ② Bağla düğmesi.
  1. Instagram hesabının profesyonel hesap olduğundan emin olun (Ön koşullar).
  2. Entegrasyonlar → Instagram Business kartında Bağla.
  3. ① Proje seçin; ② Bağla.
  4. 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.
  5. OrqLabs kısa ömürlü izni (1 saat) 60 günlük izne çevirir ve süresi dolmadan otomatik yeniler. Kartta @kullaniciadi görünür.
  6. Bağlantıyı test et: kullanıcı adı, hesap türü, takipçi ve medya sayısı görünmelidir.

İzinler ve kapsamlar

KapsamNeden gerekli
instagram_business_basicHesap bilgisi (kullanıcı adı, hesap türü) ve medya listesi
instagram_business_content_publishGörsel, carousel ve Reels yayınlama
instagram_business_manage_commentsYorumları okuma ve yanıtlama
instagram_business_manage_insightsGö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_publish için OrqLabs'ın onay adımını gösterin.
  • Uygulama Live moda alınmadan test kullanıcısı olmayan hesaplar bağlanamaz.

Limitler

KonuSınır
Yayın kotasıHesap başına 24 saatte 100 API gönderisi (carousel tek sayılır)
Metin2.200 karakter; ilk 125 görünür
Hashtag30
GörselJPEG zorunlu (PNG desteklenmez), en fazla 8 MB, en boy 4:5 – 1.91:1, önerilen 1080 px
Video / ReelsMP4/MOV, 3 sn – 15 dk, 9:16 önerilir, en fazla 1 GB
Carousel2-10 medya
Medya kaynağıHerkese açık adres zorunlu
İçgörüBazı metrikler 100+ takipçi gerektirir
İzin süresi60 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

Entegrasyon ayrıntı paneli: ① durum, ② Bağlantıyı test et, ⑤ Bağlantıyı kes.
Entegrasyon ayrıntı paneli: ① durum, ② Bağlantıyı test et, ⑤ Bağlantıyı kes.

② 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

HataOlası 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ğilBağlantı penceresinden kopyalayıp birebir ekleyin
"Insufficient developer role" / giriş reddedildiHesap test kullanıcısı değil veya davet kabul edilmediInstagram 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üyorHesap kişiselProfesyonel hesaba geçin
INVALID – kod 9004Medya adresi erişilemez veya PNGHerkese 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 bitmediZaman aşımını artırın
RATE_LIMIT – kod 9Günlük kota24 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 yokApp Review
İçgörü boşYeterli takipçi yok100+ takipçi; birkaç saat bekleyin
Görsel boş yayın hatasıInstagram görsel isterGö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.

Sonraki adım

OrqLabs ile başlayın

İlk iş akışınızı bugün kurun

Ücretsiz planla başlayın: hesaplarınızı bağlayın, bir şablon seçin, onay adımlarıyla kontrol sizde kalsın. Kredi kartı gerekmez.