İçeriğe atla
OrqLabs
Switch to English: TREN

Entegrasyonlar

Facebook Messenger

Meta uygulamasına Messenger ürünü ekleme, sayfa mesajlaşma izinleri, webhook doğrulama, 24 saat penceresi ve App Review.

20 dk Son güncelleme:
Bu sayfada
  1. Kimlik kartı
  2. Ön koşullar
  3. Adım adım kurulum
  4. A) Meta for Developers
  5. B) OrqLabs'ta bağlama
  6. Webhook kurulumu
  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: Facebook Sayfanızın Messenger gelen kutusunu OrqLabs'a bağlarsınız. AI Chatbot yanıtlar; gerekirse insana devreder. Instagram DM'leri bu kapsamda değildir.

⏱ 20 dakika

Kimlik kartı

AlanDeğer
Sağlayıcı anahtarıMESSENGER
KategoriMesajlaşma
Kimlik doğrulamaİzin ekranı (Meta, sayfa izni)
KapsamProje bazlı
WebhookEvet (Meta doğrulaması + mesajlar)
YeteneklerMesaj gönderme, mesaj alma
Kullanan kutularMesaj geldi, Mesaj gönder, İnsana devret
Kullanan ajanlarAI Chatbot

Ön koşullar

  • Yönetici olduğunuz Facebook Sayfası ve Facebook Page rehberindeki Meta uygulaması (META_APP_ID, META_APP_SECRET).
  • Sayfa ayarlarında Mesajlaşma açık.
  • Herkese açık HTTPS adres.

Adım adım kurulum

A) Meta for Developers

Meta – Messenger ürününü ekleme: ① Messenger → Set up. (Temsili görsel)
Meta – Messenger ürününü ekleme: ① Messenger → Set up. (Temsili görsel)
  1. Uygulamanızda ① Add products → Messenger → Set up.
Meta – Redirect URI ve webhook: ① Redirect URI, ② Callback URL, ③ Verify token, ④ Webhook fields. (Temsili görsel)
Meta – Redirect URI ve webhook: ① Redirect URI, ② Callback URL, ③ Verify token, ④ Webhook fields. (Temsili görsel)
  1. Facebook Login for Business → Settings → Valid OAuth Redirect URIs → ① https://api.orqlabs.com/api/v1/integrations/oauth/messenger/callback.
Meta – Messenger izinleri: ① 3 izin, ② sayfa aboneliği, ③ App Review. (Temsili görsel)
Meta – Messenger izinleri: ① 3 izin, ② sayfa aboneliği, ③ App Review. (Temsili görsel)
  1. ① Use cases → Customize: pages_messaging, pages_manage_metadata, pages_show_list.
  2. Messenger → Messenger API Settings → Configure webhooks: ② Callback URL ve ③ Verify token (OrqLabs'tan; aşağıda) → Verify and save. ④ Webhook fields: messages, messaging_postbacks, messaging_optins; isteğe bağlı message_deliveries, message_reads.
Meta – App settings → Basic: ① App ID, ② App secret, ③ politika adresleri. (Temsili görsel)
Meta – App settings → Basic: ① App ID, ② App secret, ③ politika adresleri. (Temsili görsel)
  1. ① App ID ve ② App secret Facebook Page ile aynıdır. ③ Gizlilik politikası ve App domains dolu olsun.

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. Entegrasyonlar → Facebook Messenger → Bağla → ① Proje → ② Bağla.
  2. Meta izin ekranında Sayfayı seçip izinleri onaylayın.
  3. Geri dönüşte bu bağlantının sayfasını seçin. OrqLabs sayfa iznini alır ve sayfayı webhook'a abone eder.
  4. Webhook adresini Meta'ya girmediyseniz şimdi girin (aşağıda).
  5. Sayfanıza Messenger'dan mesaj gönderin; Gelen Kutusu'nda konuşma oluşmalı.

Webhook kurulumu

Entegrasyon ayrıntı paneli: ① durum, ② Bağlantıyı test et, ③ webhook adresi, ④ doğrulama token'ı, ⑤ Bağlantıyı kes.
Entegrasyon ayrıntı paneli: ① durum, ② Bağlantıyı test et, ③ webhook adresi, ④ doğrulama token'ı, ⑤ Bağlantıyı kes.
  • ③ Callback URL: https://api.orqlabs.com/api/v1/webhooks/messenger/<hesap kimliği>.
  • ④ Verify Token: panelde gösterilen değer.
  • Meta istekleri X-Hub-Signature-256 ile imzalar; OrqLabs META_APP_SECRET ile doğrular.
  • Aynı uygulamada WhatsApp da varsa her ürün kendi Callback URL'sini kullanır.

İzinler ve kapsamlar

KapsamNeden gerekli
pages_messagingSayfa adına mesaj gönderme ve alma
pages_manage_metadataWebhook aboneliği
pages_show_listSayfaları listeleme

Uygulama incelemesi

Dikkat: Development mode'da yalnızca uygulama rollerindeki kişilerin mesajları webhook'u tetikler. "Mesajlar düşmüyor" şikâyetinin en yaygın nedeni budur.

  • Live mode: pages_messaging için App Review ve Business verification.
  • 24 saat penceresi: kullanıcı mesajından sonra 24 saat serbest yanıt; sonrasında yalnızca özel etiketler (ayrıca izin gerekir). Pencere dışında Mesaj gönder INVALID (kod 10) döner.

Limitler

KonuSınır
Gönderim~250 mesaj/saniye; pratikte 20-40/dk
Metin2.000 karakter
MedyaGörsel 8 MB, video/dosya 25 MB
Kişi kimliğiSayfa başına farklıdır; aday eşleştirmesi e-posta/telefonla

Bağlantıyı test etme

② Bağlantıyı test et sayfa adını ve webhook aboneliğini doğrular. Sayfaya test mesajı gönderin; chatbot şablonunda Mesaj geldi kanallarına Messenger ekleyin.

Kimlik bilgilerini yenileme

Sayfa izni Facebook Page kurallarına tabidir → Yeniden yetkilendir. Webhook aboneliği otomatik yenilenir.

Sık karşılaşılan hatalar

HataOlası nedenÇözüm
Webhook "couldn't be validated"Adres erişilemez, token farklıHTTPS; token'ı panelden kopyalayın
Mesajlar düşmüyorDevelopment modda ve gönderen rolde değil; messages seçilmemişLive moda alın / Tester ekleyin
AUTH – kod 190İzin geçersizYeniden yetkilendir
INVALID – kod 1024 saat penceresi kapandıKullanıcının yazmasını bekleyin
INVALID – kod 200Advanced Access yokApp Review
INVALID – kod 551Kullanıcı engellediAdaya unreachable etiketi
RATE_LIMIT – kod 613 / 4Hız sınırıBekleme süresini artırın
İmza 401META_APP_SECRET yanlışYönetici düzeltir

Sık sorulan sorular

Instagram DM'leri de gelir mi? Hayır. Bu entegrasyon yalnızca Facebook Sayfası Messenger'ı kapsar.

Pazarlama mesajı gönderebilir miyim? Yalnızca 24 saat penceresi içinde. Pencere dışı pazarlama Meta politikasına aykırıdır.

Test ederken mesajım neden düşmedi? Uygulama Development modda ise yalnızca uygulama rollerindeki kişilerin mesajları gelir. Hesabınızı Tester olarak ekleyin.

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.

Ücretsiz başlaÜrünü tanıyın