Instagram
Meta Graph API üzerinden OAuth 2.0. Sosyabot, Facebook konektörüyle aynı Facebook uygulamasını kullanır (requireFacebookCreds()); Instagram Business / Creator hesapları /me/accounts → instagram_business_account üzerinden keşfedilir.
Kimlik bir bakışta
| Alan | Değer |
|---|---|
| Kimlik modeli | OAuth 2.0 |
| Gerekli ENV | FACEBOOK_APP_ID, FACEBOOK_APP_SECRET |
| Callback URL | ${BASE_URL}/api/v1/auth/instagram/callback |
| Scope'lar / izinler | instagram_basic, instagram_content_publish, instagram_manage_insights, pages_show_list, pages_read_engagement |
| Otomatik token yenileme | Hayır — süresi dolduğunda manuel reconnect |
ENV detayları
Facebook konektörüyle aynı kimlik bilgileri — Meta uygulamaları FB / IG / Threads ürün ailesi arasında paylaşılır.
Nasıl bağlanılır
- Bağlantılar → Instagram → Bağlan'ı aç.
- Facebook'a giriş yap ve istenen scope'ları onayla.
- Bağlantı sonrası ekranda bağlı Page → Instagram Business Account'u seç.
Token yenileme
Bağlantı anında uzun ömürlü token'lar talep edilir ve otomatik yenilenmez. Bir token geçersiz kılınırsa manuel olarak yeniden bağlan.
Notlar
- Kişisel Instagram hesapları Meta'nın yayın API'si tarafından desteklenmez — hesap Business veya Creator olmalı ve bir Facebook Page'e bağlı olmalıdır.
- Token payload'u hem page access token'ı hem
pageId'yi saklar; yayın çağrıları Page-kapsamlı Instagram endpoint'lerine gider. - Kullanıcının birden fazla bağlı Page'i varsa, Sosyabot keşfedilen her Instagram Business Account için bir Sosyabot kanalı oluşturur.
Sorun giderme
Kanal needs_reconnect gösteriyorsa, access token Instagram tarafından reddedilmiştir. Yaygın sebepler:
- Kullanıcı Sosyabot'un yetkilendirmesini platform üzerinden iptal etmiştir.
- Platform token'ı geçersiz kılmıştır (şifre değişikliği, güvenlik olayı).
- OAuth uygulama kimlik bilgileriniz değişmiştir ve mevcut token'lar artık eşleşmiyordur.
Yukarıdaki bağlantı akışını yeniden çalıştır. Çalışma alanı genelinde checklist için Sorun Giderme'ye bak.