Bu rehberde: Facebook Sayfanızı bağlarsınız. Platform yöneticisi Meta for Developers'ta bir uygulama oluşturur; siz Bağla deyip sayfanızı seçersiniz. Aynı uygulama Messenger için de kullanılır; Instagram aynı uygulamaya eklenen Instagram ürünüyle ama kendi Instagram app ID'siyle bağlanır.
⏱ 25 dakika (uygulama oluşturma dahil)
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | FACEBOOK |
| Kategori | Sosyal medya |
| Kimlik doğrulama | İzin ekranı (Meta OAuth) |
| 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?
Facebook Sayfanıza metin, görsel, carousel ve video yayınlar; sayfa içgörülerini okur; yorumları çekip yanıtlar. Messenger aynı Meta uygulamasını kullanır. Instagram Business, Facebook Sayfası gerektirmeyen Instagram Login ile bağlanır (Instagram).
Ön koşullar
- Yönetici olduğunuz bir Facebook Sayfası.
- Bir Meta Business Portfolio ve Meta for Developers hesabı.
- Platform yöneticisinin
META_APP_IDveMETA_APP_SECRETtanımlamış olması. - Canlı kullanım için Meta App Review ve Business verification.
Adım adım kurulum
A) Meta for Developers (platform yöneticisi, bir kez)
- developers.facebook.com → My Apps → Create App. ① Kullanım senaryosu Other, ② tür Business, işletme portföyünü seçin, ③ Create app.
- Add products → Facebook Login for Business → Set up.
- Facebook Login for Business → Settings: ① Client OAuth login ve Web OAuth login ikisi de Yes. ② Valid OAuth Redirect URIs:
https://api.orqlabs.com/api/v1/integrations/oauth/facebook/callback. Messenger için…/oauth/messenger/callbackadresini de ekleyin. Instagram'ın adresi burada değil, Instagram ürününün Business login settings bölümünde tanımlanır. ③ Save changes.
- App settings → Basic: ① App ID ve ② App secret (Show) değerlerini kopyalayın. ③ Privacy Policy URL, Terms of Service URL ve App domains alanlarını doldurun (App Review için zorunlu).
- Use cases (veya App Review → Permissions and Features) → ① şu izinleri ekleyin:
pages_manage_posts,pages_read_engagement,pages_show_list,pages_manage_engagement. Geliştirmede Standard Access yeterlidir. - Test kullanıcıları: App roles → Roles → ekibinizi Tester olarak ekleyin.
- Yönetici değerleri
META_APP_IDveMETA_APP_SECRETolarak tanımlar.
B) OrqLabs'ta bağlama
- Entegrasyonlar sayfasında Facebook Page kartında Bağla düğmesine basın.
- ① Proje seçin; ② Bağla.
- Meta izin ekranında giriş yapın. Hangi sayfaların bağlanacağını seçin (yalnızca OrqLabs'ın yöneteceği sayfayı işaretleyin). İzinleri onaylayın.
- Geri dönüşte OrqLabs sayfa listesini gösterir; bu bağlantı için sayfayı seçin. Proje başına bir sayfa önerilir.
- Kart Bağlı olur. Bağlantıyı test et ile sayfa adını doğrulayın.
OrqLabs kullanıcı iznini uzun ömürlü sayfa iznine çevirir; siz izinleri kaldırmadıkça süresiz geçerlidir.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
pages_manage_posts | Sayfaya gönderi, fotoğraf ve video yayınlama |
pages_read_engagement | Gönderi içgörüleri, beğeni/yorum/paylaşım metrikleri |
pages_show_list | Yönettiğiniz sayfaları listeleme |
pages_manage_engagement | Yorumları okuma, yanıtlama, gizleme |
Uygulama incelemesi
- Development mode: yalnızca uygulama rollerindeki kişiler bağlanabilir; içerik gerçek sayfaya yayınlanır. Kendi sayfalarınız için yeterli olabilir.
- Live mode + Advanced Access: başka işletmelerin sayfalarını bağlayacaksanız dört izin için App Review gerekir: ekran kaydı, kullanım açıklaması, gizlilik politikası. Business verification zorunludur. Süre 3-10 iş günü.
- Red nedenleri: ekran kaydında izin kullanımının görünmemesi, test kullanıcısının çalışmaması, gizlilik politikası eksikliği.
- Data Use Checkup: Meta yıllık onay ister; onaylanmazsa izinler düşer.
Limitler
| Konu | Sınır |
|---|---|
| Sayfa hız sınırı | 24 saatte 4.800 çağrı × etkileşen kullanıcı |
| Metin | 63.206 karakter; en iyi etkileşim 80 karakter altı |
| Hashtag | 5 (OrqLabs doğrulaması) |
| Medya | Görsel JPEG/PNG 4 MB; video 10 GB'a kadar |
| Carousel | 2-10 görsel |
| Zamanlama | OrqLabs tarafında bekletilir |
Bağlantıyı test etme
② Bağlantıyı test et sayfa adı, takipçi sayısı ve iznin geçerliliğini döndürür. İlk yayın için test modunda Yayınla kutusunu çalıştırın; sonra kısa bir gönderiyi gerçek yayınlayıp sayfada görün.
Kimlik bilgilerini yenileme
- Sayfa izni şu durumlarda geçersiz olur: parola değişikliği, güvenlik olayı, izinlerin kaldırılması (Facebook Ayarlar → Business Integrations), sayfa rolünün düşmesi. Yeniden yetkilendir aynı kaydı korur.
- App secret sıfırlanırsa tüm izinler geçersiz olur; yönetici
.env'i günceller, kullanıcılar yeniden yetkilendirir.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "platformda yapılandırılmamış" | META_APP_ID/META_APP_SECRET yok | Yönetici ekler |
| "URL blocked: This redirect failed" | Adres eşleşmiyor | Valid OAuth Redirect URIs listesine tam adresi ekleyin |
| "App not active" / "Feature unavailable" | Development modda ve kullanıcı rolde değil | Tester yapın veya Live moda alın |
| Sayfa listesi boş | pages_show_list verilmedi veya sayfada yetki yok | İzin ekranında sayfayı seçin |
AUTH – kod 190 | İzin geçersiz | Yeniden yetkilendir |
INVALID – kod 200 "Permissions error" | Advanced Access yok | App Review; Data Use Checkup |
INVALID – kod 100 | Medya adresi erişilemez | Herkese açık adres |
RATE_LIMIT – kod 4 / 32 / 613 | Hız sınırı | Otomatik bekleme; sıklığı azaltın |
| Yorumlar gelmiyor | pages_manage_engagement eksik | İzni ekleyip yeniden yetkilendirin |
| Video zaman aşımı | Büyük dosya | Kutu zaman aşımını 600000 yapın |
Sık sorulan sorular
Kişisel profilime yayın yapar mı? Hayır. Meta API'si yalnızca Sayfalara yayın izni verir.
Instagram için ayrı uygulama gerekir mi?
Hayır. Aynı uygulamaya Instagram ürününü ekleyin; ancak bağlantı bu ürünün ürettiği Instagram app ID / secret (INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET) ile çalışır ve Facebook Sayfası gerektirmez. Bkz. Instagram.
App Review şart mı? Yalnızca kendi sayfalarınızı yönetiyorsanız ve tüm kullanıcılar uygulama rolündeyse Development mode yeterli olabilir.