TR
Geliştirici rehberi

Facebook API Rehberi: Graph API, Erişim, Sınırlar ve Bağlı Hesaplar

Meta'nın Facebook API'leri 2026'da neleri kapsıyor, access token ve App Review onayı nasıl alınır, resmi API artık nelere izin vermiyor ve bir SaaS uygulaması bunun yerine kullanıcılarının kendi Facebook hesaplarını nasıl bağlayabilir?

Uygulamanız Canlı
FacebookAnna LeeKişisel FacebookNorthwind BakerySayfa
Gönderi
Northwind BakerySayfa olarak · Az önce

Sonbahar menümüz pazartesi başlıyor.

243
Julia NashBalkabaklı ekmek geri döndü!
Mesajlar
Maya RossNorthwind Bakery'ye
Pazar günleri teslimat yapıyor musunuz?
Evet, 9'dan 12'ye kadar.
Görüldü
Webhook'lar Yeni mesaj Yeni tepki
GETchats POSTmessages/send POSTposts 200 OK
Kısa cevap

Evet, Facebook'un bir API'si var: Graph API, Meta'nın Facebook verilerini okumak ve yazmak için sunduğu HTTP arayüzüdür. Pages API, Messenger Platform ve Marketing API gibi ürünler bunun üzerine kuruludur. Erişim; bir Meta uygulaması, kullanıcıların veya Sayfaların verdiği access token'lar ve App Review'da onaylanan izinlerle sağlanır.

Bu rehber her Facebook API'sini hizmet ettiği hesap türüyle eşleştirir, erişimi ve sınırları açıklar, Meta'nın kaldırdıklarını listeler ve ardından SaaS uygulamaları için başka bir model sunar: her kullanıcının kendi Facebook hesabını Unipile'ın Facebook Messenger API'si üzerinden bağlaması.

Tanım

Facebook API Var mı?

Evet. Meta, Facebook verilerini geliştiricilere sürümlenmiş bir HTTP API olan Graph API üzerinden sunar. Sayfa yönetiminden Messenger'a ve reklamlara kadar diğer tüm Facebook geliştirici ürünleri, kendi izinleri ve inceleme süreci olan Graph API endpoint'lerinden oluşur.

Tek bir API anahtarı yoktur. Neye erişeceğiniz, kimin verisine dokunduğunuza bağlıdır: uygulamanıza giriş yapan bir kişi, bu kişinin yönettiği bir Facebook Sayfası veya bir reklam hesabı. Her birinin kendi token türü ve Meta tarafından yapılan kendi incelemesi vardır.

Facebook Kimin verisini okuyorsunuz?
Bir kullanıcıFacebook Login'den alınan user access token; kişinin verdiği izinlerle sınırlıdır.
Bir SayfaO Sayfada görevi olan biri için Page access token.
Bir reklam hesabıBir işletme ve onun system user'ları üzerinden Marketing API erişimi.
Graph API

Facebook Graph API Nedir?

Graph API, her Facebook entegrasyonunun arkasındaki HTTP API'dir. Tüm istekler graph.facebook.com adresine gider ve neredeyse her endpoint bir access token gerektirir. Veriler node, edge ve field'lardan oluşan bir grafik olarak düzenlenir.

Nodes

Nesneler

Kimliği (ID) olan tek bir nesne: bir kullanıcı, bir Sayfa, bir gönderi, bir yorum, bir fotoğraf. Örnek: GET /{page-id}.

Edges

Bağlantılar

Bir node'a bağlı koleksiyonlar; örneğin bir Sayfanın gönderileri veya bir gönderinin yorumları. Örnek: GET /{page-id}/feed.

Fields

Özellikler

Bir node üzerinde istediğiniz veriler; fields parametresiyle seçilir. Örnek: ?fields=id,message,created_time.

Sürümler ve Graph API Explorer

Her istek, yolunda 4 Kasım 2026'da yayınlanan /v27.0/ gibi bir sürüm belirtebilir. Meta yılda birkaç sürüm yayınlar ve her birini en az iki yıl destekler; bu yüzden yükseltmeleri planlayın: changelog, her sürümün hangi tarihe kadar kullanılabileceğini belirtir. Graph API Explorer, kod yazmadan önce çağrıları test etmenizi sağlar; aşağıdaki kod örneğinin Meta Graph API sekmesi de ilk isteği gösterir: bir Sayfa akışını okumak.

Kaynak: Meta'nın Graph API changelog sayfası; en son sürüm olarak v27.0 (4 Kasım 2026'da kullanıma sunuldu) listeleniyordu. Son doğrulama: 17 Kasım 2026.

Harita

Bir Bakışta Facebook API'leri

Her Facebook API'si tek bir hesap türüne hizmet eder. Doğru olanı seçmek basit bir soruyla başlar: bir kişi, bir Sayfa veya bir reklamveren adına mı işlem yapıyorsunuz?

APINe yaparHizmet ettiği hesapGereken erişim
Graph APIFacebook nesnelerini okur ve yazarKullanıcılar, Sayfalar, işletmelerMeta uygulaması, access token, izinler
Pages APIGönderi yayınlar, yorumları denetler, Sayfa verilerini okur. Rehber: Facebook gönderi APIFacebook SayfalarıPage access token, Sayfa görevleri, App Review
Messenger PlatformSayfa konuşmalarını gönderir ve alırFacebook Sayfaları ve Instagram profesyonel hesaplarıPage token, mesajlaşma izni, App Review
Marketing APIReklam oluşturur ve reklam performansını okurReklam hesaplarıİşletme doğrulaması, reklam izinleri
Conversions APIReklamlar için web ve çevrimdışı olaylar gönderirReklam yayınlayan işletmelerPixel veya veri kümesi, system user token
Facebook LoginKişilerin uygulamanıza giriş yapmasını sağlarFacebook kullanıcılarıFacebook Login içeren Meta uygulaması
Graph API
Ne yaparFacebook nesnelerini okur ve yazar
HesapKullanıcılar, Sayfalar, işletmeler
ErişimMeta uygulaması, access token, izinler
Pages API
Ne yaparGönderi yayınlar, yorumları denetler, Sayfa verilerini okur. Rehber: Facebook gönderi API
HesapFacebook Sayfaları
ErişimPage access token, Sayfa görevleri, App Review
Messenger Platform
Ne yaparSayfa konuşmalarını gönderir ve alır
HesapFacebook Sayfaları ve Instagram profesyonel hesapları
ErişimPage token, mesajlaşma izni, App Review
Marketing API
Ne yaparReklam oluşturur ve reklam performansını okur
HesapReklam hesapları
Erişimİşletme doğrulaması, reklam izinleri
Conversions API
Ne yaparReklamlar için web ve çevrimdışı olaylar gönderir
HesapReklam yayınlayan işletmeler
ErişimPixel veya veri kümesi, system user token
Facebook Login
Ne yaparKişilerin uygulamanıza giriş yapmasını sağlar
HesapFacebook kullanıcıları
ErişimFacebook Login içeren Meta uygulaması

Instagram'daki mesajlaşma da aynı Messenger Platform üzerinden yürür: Instagram için Messenger API rehberimize göz atın. WhatsApp'ın ise kendi platformu vardır ve WhatsApp API rehberimizde ele alınır.

Karar

Hangi Facebook API'sine İhtiyacınız Var?

API listesinden değil, ürününüzün ne yaptığından yola çıkın. Aşağıdaki her durum bir API'ye ve onun erişim gereksinimlerine işaret eder.

Kendi Sayfanızda yayın yapıyorsunuz

Pages API

Bir Sayfa yöneticisinden Page access token, Sayfa görevleri, App Review. Facebook Page API rehberi.

Sayfanıza mesaj atan kişileri yanıtlıyorsunuz

Messenger Platform

Page token, pages_messaging, 24 saatlik mesajlaşma penceresi.

Reklam yayınlıyor veya ölçüyorsunuz

Marketing API ve Conversions API

Reklam hesabı erişimi, işletme doğrulaması, system user'lar.

Kişilerin Facebook ile giriş yapmasını sağlıyorsunuz

Facebook Login

Facebook Login yapılandırılmış bir Meta uygulaması.

Kullanıcılarınız kendi hesaplarını SaaS'ınıza bağlıyor

Unipile API

Kişisel hesaplar ve yönettikleri Sayfalar, hosted authentication üzerinden.

Erişim

Facebook API Erişimi Nasıl Alınır

Bağımsız bir API anahtarı yoktur. Bir Meta uygulaması oluşturursunuz, kişiler Facebook Login üzerinden uygulamanıza access token verir ve Meta, uygulamanız herkese hizmet vermeden önce talep ettiği izinleri inceler.

1

Bir Meta geliştirici hesabı oluşturun

Facebook hesabınızla Meta for Developers'a kaydolun.

2

Bir Meta uygulaması oluşturun

Uygulama türünü ve kullanım senaryosunu seçin, ardından App ID ile App Secret'ı not edin.

3

Facebook Login for Business ekleyin

Kullanıcılar ve Sayfa yöneticileri giriş yapar ve uygulamanıza izin verir.

4

İzinleri talep edin

Örneğin pages_show_list, pages_manage_posts veya pages_messaging.

5

App Review'dan geçin

Uygulamanızda rolü olmayan kişilerin kullanabilmesi için Advanced Access gerekir.

Access token'lar: user, Page, app ve system user

TokenKimin adınaTipik kullanım
User access tokenUygulamanıza giriş yapan bir kişi adınaVarsayılan olarak kısa ömürlüdür, uzun ömürlü bir token ile değiştirilebilir
Page access tokenBir Sayfa adına, /me/accounts üzerinden alınırPages API ve Messenger endpoint'lerinin çoğu için gerekir
App access tokenUygulamanın kendisi adınaUygulama ayarları ve bazı herkese açık veriler
System user tokenBir kişi olmadan, bir işletme adınaSunucudan sunucuya işler, işletmeye ait reklamlar ve Sayfalar
User access token
Kimin adınaUygulamanıza giriş yapan bir kişi adına
Tipik kullanımVarsayılan olarak kısa ömürlüdür, uzun ömürlü bir token ile değiştirilebilir
Page access token
Kimin adınaBir Sayfa adına, /me/accounts üzerinden alınır
Tipik kullanımPages API ve Messenger endpoint'lerinin çoğu için gerekir
App access token
Kimin adınaUygulamanın kendisi adına
Tipik kullanımUygulama ayarları ve bazı herkese açık veriler
System user token
Kimin adınaBir kişi olmadan, bir işletme adına
Tipik kullanımSunucudan sunucuya işler, işletmeye ait reklamlar ve Sayfalar

Ömürler türe göre değişir. Meta'ya göre kısa ömürlü user token'lar genellikle bir ila iki saat, uzun ömürlü olanlar ise yaklaşık 60 gün geçerlidir; system user token'lar ise zamana bağlı olarak sona ermeyecek şekilde ayarlanabilir. Meta, bu sürelerin önceden haber verilmeden değişebileceği konusunda uyarır. Token oluşturmaktan değiştirmeye ve hata ayıklamaya kadar tüm adımlar Facebook API access token rehberimizde; Facebook Page access token ise Page API rehberinde ele alınıyor.

İzinler, Sayfa görevleri ve App Review

Pages API endpoint'lerinin çoğu, Sayfada CREATE_CONTENT veya MODERATE gibi bir görevi yerine getirebilen bir kişiden alınmış Page access token gerektirir. Geliştirme modunda uygulamanızı yalnızca uygulamada rolü olan kişiler kullanabilir. Diğer kullanıcılara hizmet vermek için her iznin App Review sonrasında verilen Advanced Access'e sahip olması gerekir; işletme uygulamaları için çoğu zaman işletme doğrulaması da istenir.

Kaynaklar: Meta'nın access token rehberi ve Pages API genel bakışı. Son doğrulama: 17 Kasım 2026.

Gerçek zamanlı

Facebook API Webhook'ları: Olayları Gerçek Zamanlı Alın

Polling yerine Meta, olayları size ait bir HTTPS endpoint'ine iletir: yeni Sayfa mesajları, okundu bilgileri ve tepkiler. Kurulum dört adımda tamamlanır.

1

Endpoint'inizi doğrulayın

Meta, hub.mode, hub.verify_token ve hub.challenge içeren bir GET isteği gönderir. Token'ı kontrol edin ve challenge değerini döndürün.

2

Sayfayı abone edin

Bir Page access token ve ihtiyacınız olan field'larla (örneğin messages) POST /{page-id}/subscribed_apps çağrısı yapın.

3

Her payload'ı doğrulayın

Her olay, App Secret'ınızla oluşturulmuş bir SHA256 imzası olan X-Hub-Signature-256 header'ını taşır.

4

Hızlı yanıt verin

Hızlıca 200 OK döndürün. Messenger için Meta 5 saniye içinde yanıt bekler ve bir saat süren hatalardan sonra aboneliği devre dışı bırakır.

Facebook Messenger webhook field'ları
messagesBir kişi Sayfaya mesaj gönderir
message_readsKişi mesajınızı okudu
message_deliveriesMesajınız iletildi
message_reactionsKişi bir mesaja tepki verdi
messaging_postbacksKişi bir butona veya menü öğesine dokundu
POST /{page-id}/subscribed_apps success

Unipile ile tek bir webhook URL'si kaydedersiniz ve bağlı her Facebook hesabı için yeni, düzenlenmiş ve silinmiş mesajları, okundu bilgilerini ve tepkileri diğer kanallarınızla aynı formatta alırsınız.

Kaynaklar: Meta'nın Webhooks başlangıç rehberi ve Messenger webhook'ları. Son doğrulama: Kasım 2026.

Sınırlar

Resmi Facebook API'nin İzin Vermedikleri

Bir Facebook API'sinden beklenen bazı özellikler kaldırıldı ya da üçüncü taraf uygulamalara hiç sunulmadı. Bunları erkenden bilmek haftalarca tasarım çalışmasından tasarruf sağlar.

  • Kişisel profilde paylaşım yapmak. publish_actions izni 24 Nisan 2018'de kullanımdan kaldırıldı ve uygulamalar bu izni 1 Ağustos 2018'de kaybetti. Uygulamalar Sayfalarda yayın yapabilir, ancak bir kişinin kendi zaman tünelinde yapamaz.
  • Facebook Gruplarını kullanmak. Meta, 23 Ocak 2024'te Graph API v19.0 ile Groups API'yi publish_to_groups izni dahil kullanımdan kaldırdı.
  • Kişisel bir hesaptan mesaj göndermek. Messenger Platform, bir Facebook Sayfasının veya Instagram profesyonel hesabının kişilere yanıt vermesini sağlar. Standart mesajlaşma penceresi, kişinin son mesajından sonraki 24 saattir. Kişisel hesaplar için Facebook Messenger API ile nasıl çalıştığını görün.

Kaynaklar: Meta'nın Facebook Login changelog, Graph API v19.0 duyurusu ve Messenger Platform genel bakışı. Son doğrulama: Kasım 2026.

Kullanıcılarınızın kendi konuşmalarına mı ihtiyacınız var?

Uygulamanız, kullanıcılarınızın kendi bağladığı hesaplardaki Messenger konuşmalarına, gönderilere ve yorumlara ihtiyaç duyuyorsa Unipile'ın Facebook Messenger API'sine göz atın.

Rate limit

Facebook API Rate Limit ve Sürümleme

Graph API, kullandığınız token'a bağlı olarak çağrıları iki ayrı sistemde sayar.

Platform rate limit 200 x kullanıcı çağrı / saat User veya app token ile yapılan çağrılar; uygulamanızın kullanıcı sayısına göre hesaplanır.
Business Use Case, Sayfalar 4.800 x etkileşimli kullanıcı çağrı / 24 saat Page veya system user token ile Pages endpoint'lerine yapılan çağrılar.

Meta'nın her yanıtla döndürdüğü kullanım header'larını okuyun, sınıra ulaşmadan yavaşlayın ve çağırdığınız Graph API sürümü kullanımdan kalkmadan önce yükseltin.

Kaynak: Meta'nın rate limiting rehberi. Son doğrulama: Kasım 2026.

Hatalar

Sık Görülen Facebook API Hataları ve Çözümleri

Graph API hataları bir code, çoğu zaman bir error_subcode ve Meta destek ekibiyle paylaşmanız için bir fbtrace_id ile döner. Yeniden denemeden önce kodu okuyun: hataların yalnızca bir kısmı zamanla kendiliğinden düzelir.

KodAnlamıNe yapmalı
190Access token süresi dolmuş veya geçersiz (alt kodlar 463, 467)Yeni bir token alın; kullanıcıdan yeniden giriş yapmasını isteyin. Facebook API access token rehberine bakın
10, 200 ile 299 arasıİzin verilmemiş veya kaldırılmışİzni yeniden talep edin, App Review durumunu kontrol edin
4, 17, 613Uygulama veya kullanıcı için çok fazla çağrıDurun, ardından backoff ile yeniden deneyin
100Geçersiz parametre veya IDGönderdiğiniz ID'yi ve token'ı kontrol edin
368Politika ihlalleri nedeniyle geçici olarak engellendiBekleyin, ardından gönderilenleri gözden geçirin
506Yinelenen gönderiYeniden paylaşmadan önce içeriği değiştirin
10 / 2018278Mesaj izin verilen pencerenin dışında gönderildiYalnızca mesajlaşma penceresi açıkken yanıt verin
Kod 190
AnlamıAccess token süresi dolmuş veya geçersiz (alt kodlar 463, 467)
Ne yapmalıYeni bir token alın; kullanıcıdan yeniden giriş yapmasını isteyin. Facebook API access token rehberine bakın
Kod 10, 200 ile 299 arası
Anlamıİzin verilmemiş veya kaldırılmış
Ne yapmalıİzni yeniden talep edin, App Review durumunu kontrol edin
Kod 4, 17, 613
AnlamıUygulama veya kullanıcı için çok fazla çağrı
Ne yapmalıDurun, ardından backoff ile yeniden deneyin
Kod 100
AnlamıGeçersiz parametre veya ID
Ne yapmalıGönderdiğiniz ID'yi ve token'ı kontrol edin
Kod 368
AnlamıPolitika ihlalleri nedeniyle geçici olarak engellendi
Ne yapmalıBekleyin, ardından gönderilenleri gözden geçirin
Kod 506
AnlamıYinelenen gönderi
Ne yapmalıYeniden paylaşmadan önce içeriği değiştirin
Kod 10 / 2018278
AnlamıMesaj izin verilen pencerenin dışında gönderildi
Ne yapmalıYalnızca mesajlaşma penceresi açıkken yanıt verin

Kaynaklar: Meta'nın Graph API hata yönetimi ve Messenger hata kodları. Son doğrulama: Kasım 2026.

Fiyatlandırma

Facebook API Ücretsiz mi?

Büyük ölçüde evet. Meta, Graph API erişimini satmaz. Para gerektiren şeyler reklamlar, bazı mesaj türleri ve bir entegrasyonu kurup çalışır durumda tutmak için harcanan mühendislik zamanıdır.

Graph API erişimiÜcret yokMeta, Graph API çağrıları için ücret almaz. Sizin maliyetiniz uygulama kurulumu, App Review ve bakımdır.
Messenger konuşmalarıKullanımı ücretsizMeta, Messenger Platform'u kullanımı ücretsiz olarak tanımlar; pazarlama mesajları reklam hesabınız üzerinden faturalandırılır.
ReklamlarReklam harcamanızMarketing API'yi çağırmak ücretsizdir, ancak oluşturduğu kampanyalar diğer reklamlar gibi ücretlidir.

Mesaj türüne göre maliyetler, 2026 faturalandırma değişiklikleri ve bir Meta uygulaması işletmenin gerçek maliyeti, Facebook API ücretsiz mi sorusunu ayrıntılı olarak yanıtlayan fiyatlandırma rehberimizde ele alınıyor. Kullanıcılarınız kendi hesaplarını Unipile üzerinden bağlarsa, bunun yerine Unipile'a bağlı hesap başına ödeme yaparsınız: API fiyatlandırmasına göz atın.

Dokümantasyon

Facebook API Dokümantasyonunu Nerede Bulabilirsiniz

Resmi kaynakların tamamı Meta for Developers'ta yer alır. Meta sayfalarını developers.facebook.com/documentation/ adresine taşıyor ve eski /docs/ bağlantılarının bir kısmı artık oraya yönlendiriliyor. Bu altı sayfa entegrasyon sorularının çoğunu yanıtlar; Instagram, WhatsApp, Threads, reklamlar ve yapay zekâ için Meta API rehberimize göz atın.

Unipile ile

Başka Bir Model: Kullanıcılarınızın Kendi Facebook Hesaplarını Bağlayın

CRM'ler, helpdesk'ler, yapay zeka ajanları ve çok kanallı inbox'lar, kullanıcılarının kendi konuşmalarına ve gönderilerine ihtiyaç duyar. Unipile ile her kullanıcı Facebook hesabını barındırılan bir kimlik doğrulama sayfası üzerinden bağlar ve uygulamanız, sizin tarafınızda Meta uygulaması veya App Review gerekmeden, kullanıcı adına tek bir REST API çağırır.

Uygulamanız Senkronize
Bağlı hesaplar
FacebookAnna LeeKişisel hesap
FacebookNorthwind BakerySayfa
Hesap bağla
Inbox 2SayfaKişisel
Leo MartinMağaza bugün açık mı?Sayfa
Sara KimFotoğraf gönderildiKişisel
Kitap kulübüTom: 7'de görüşürüzGrup
Omar HaddadGörüldüSayfa
Sayfa adına yayınlandı
Northwind BakeryAz önce

Sonbahar menümüz pazartesi başlıyor.

24 tepki2 yorum
Julia NashBalkabaklı ekmek geri döndü!
Ben TorresÖn sipariş alıyor musunuz?
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
AlanUnipile API'nin Facebook için kapsadıkları
BağlantıHosted Auth veya Custom Auth; kullanıcının kimlik bilgileri ve iki faktörlü kimlik doğrulama, tarayıcı çerezleri ya da UniLogin eklentisi ile
MesajlaşmaSohbetleri ve mesajları listeleme, sohbet başlatma, mesaj ve ek gönderme, düzenleme, silme, iletme, tepkiler, okundu bilgileri, grup sohbetleri
Gönderiler ve yorumlarGönderileri okuma, oluşturma, düzenleme ve silme; yorumları listeleme, ekleme, yanıtlama, düzenleme ve silme; gönderi ve yorumlara tepkiler
Kullanıcılar ve ilişkilerProfiller, takipçiler ve takip edilenler, arkadaşlık istekleri (gönderme, kabul etme, reddetme, iptal etme)
Webhook'larYeni, güncellenmiş ve silinmiş mesajlar, okundu ve iletildi bilgileri, yeni tepkiler, sohbet güncellemeleri
Facebook SayfalarıKullanıcının yönettiği bir Sayfanın mesajlarını okuma ve yanıtlama, Sayfa adına gönderi yayınlama. Bir Sayfa konuşma başlatamaz veya mesajlarını silemez
DesteklenmeyenlerHikayeler, sabitlenmiş mesajlar, kullanıcı engelleme
Bağlantı
Hosted Auth veya Custom Auth; kullanıcının kimlik bilgileri ve iki faktörlü kimlik doğrulama, tarayıcı çerezleri ya da UniLogin eklentisi ile
Mesajlaşma
Sohbetleri ve mesajları listeleme, sohbet başlatma, mesaj ve ek gönderme, düzenleme, silme, iletme, tepkiler, okundu bilgileri, grup sohbetleri
Gönderiler ve yorumlar
Gönderileri okuma, oluşturma, düzenleme ve silme; yorumları listeleme, ekleme, yanıtlama, düzenleme ve silme; gönderi ve yorumlara tepkiler
Kullanıcılar ve ilişkiler
Profiller, takipçiler ve takip edilenler, arkadaşlık istekleri (gönderme, kabul etme, reddetme, iptal etme)
Webhook'lar
Yeni, güncellenmiş ve silinmiş mesajlar, okundu ve iletildi bilgileri, yeni tepkiler, sohbet güncellemeleri
Facebook Sayfaları
Kullanıcının yönettiği bir Sayfanın mesajlarını okuma ve yanıtlama, Sayfa adına gönderi yayınlama. Bir Sayfa konuşma başlatamaz veya mesajlarını silemez
Desteklenmeyenler
Hikayeler, sabitlenmiş mesajlar, kullanıcı engelleme

Kullanıcılar kişisel bir Facebook hesabı bağlayabilir; yönettikleri Sayfalar da aynı endpoint'ler üzerinden erişilebilir olur. Aynı API LinkedIn, WhatsApp, Instagram, Telegram, e-posta ve takvimleri de kapsar. Tam listeyi sağlayıcı özellikleri tablosunda bulabilirsiniz.

Sohbetleri listeleyin ve mesaj gönderin

Bir kullanıcı hesabını bağladığında bir account_id alırsınız. Her çağrı, Unipile API anahtarınızı X-API-KEY header'ında kullanır. İkinci sekme, karşılaştırma için Meta'nın Graph API'sine yapılan ilk çağrıyı gösterir: bir Page access token ile bir Sayfanın en son gönderilerini okumak.

# 1. Bağlı bir hesabın Facebook sohbetlerini listeleyin
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. Bu sohbetlerden birinde yanıt verin
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Thanks for your message, your order ships today." }'
# Read the 3 latest posts of a Page (Graph API v27.0)
# Needs a Page access token with pages_read_engagement and pages_read_user_content
curl "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?fields=id,message,created_time&limit=3&access_token={PAGE_ACCESS_TOKEN}"

# Response (abridged)
{ "data": [ {
    "id": "{PAGE_ID}_{POST_ID}",
    "message": "Our autumn menu starts Monday.",
    "created_time": "2026-11-16T09:30:00+0000"
  } ],
  "paging": {
    "cursors": { "before": "{CURSOR}", "after": "{CURSOR}" },
    "next": "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?..."
  } }
200 OK · mesaj kullanıcının hesabından gönderildi
200 OK · tek bir Sayfanın gönderileri, Sayfa başına bir Page token

Adım adım kurulum için Facebook quickstart rehberine bakın. Graph API isteği, 17 Kasım 2026'da Meta'nın Page feed referansı ile kontrol edildi.

Uyumluluk

Her kullanıcı kendi hesabını bağlar

Unipile bağımsız bir şirkettir; resmi bir Meta uygulaması veya Meta Partner değildir. Kimliği doğrulanmış kullanıcılar adına hareket eder ve kullanıcılarınız Meta'nın koşullarına bağlı kalır. Müşteri desteği, CRM ve doğrudan konuşmalar gibi meşru senaryolar için kullanın.

API referansı

Unipile ile Facebook API Endpoint'leri

Kısa cevap

Unipile, Facebook'u tek bir REST API üzerinden sunar. V2 endpoint'leri Messenger sohbetlerini ve mesajlarını, gönderileri, yorumları, tepkileri, profilleri, arkadaşlık isteklerini, Facebook Sayfalarını ve webhook'ları kapsar. Her çağrı bağlı bir hesabı account_id değeriyle hedefler; böylece tek bir entegrasyon hem kişisel hesaba hem de yönettiği Sayfalara hizmet eder ve sizin tarafınızda bir Meta uygulaması gerekmez.

İşlemMetot ve yolKişisel / SayfaRehber
Mesajlaşma
Sohbetleri listeleGET/v2/{account_id}/chatsKişiselKişisel hesaplar için Messenger
Bir sohbetin mesajlarını listeleGET/v2/{account_id}/chats/{chat_id}/messagesKişisel + Sayfa
Bir eki indirGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Kişisel + Sayfa
Yeni bir sohbet başlatPOST/v2/{account_id}/chats/sendKişiselMessenger mesajı nasıl gönderilir
Mesaj gönder, metin veya ekPOST/v2/{account_id}/chats/{chat_id}/messages/sendKişisel + Sayfa
Mesaj tepkilerini listele, ekle veya kaldırGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsKişisel
Bir mesajı okundu olarak işaretlePOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readKişisel
Gönderiler
Bir kullanıcının veya Sayfanın gönderilerini listeleGET/v2/{account_id}/users/{user_id}/postsKişisel + SayfaFacebook gönderi API rehberi
Bir gönderiyi getirGET/v2/{account_id}/posts/{post_id}Kişisel + Sayfa
Gönderi oluşturPOST/v2/{account_id}/postsKişisel + Sayfa
Bir gönderiyi düzenle veya silPATCHDELETE/v2/{account_id}/posts/{post_id}Kişisel + Sayfa
Yorumlar
Bir gönderinin yorumlarını listeleGET/v2/{account_id}/posts/{post_id}/commentsKişiselYorumları okuyun ve yanıtlayın
Bir yoruma verilen yanıtları listeleGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesKişisel
Yorum eklePOST/v2/{account_id}/posts/{post_id}/commentsKişisel
Bir yoruma yanıt verPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Kişisel
Bir yorumu düzenle veya silPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Kişisel
Tepkiler
Gönderi tepkilerini listele, ekle veya kaldırGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsKişiselYorum rehberinde tepkiler
Yorum tepkilerini listele, ekle veya kaldırGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsKişisel
Profiller ve bağlantılar
Bir profili getirGET/v2/{account_id}/users/{user_id}KişiselKişileri CRM'inize senkronize edin
Arkadaşları listeleGET/v2/{account_id}/users/me/relationsKişisel
Takipçileri veya takip edilenleri listeleGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingKişisel
Arkadaşlık isteği gönder veya listelePOSTGET/v2/{account_id}/users/me/relation-requestsKişisel
Bir isteği kabul et, reddet veya iptal etPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelKişisel
Facebook Sayfaları
Hesabın Sayfalarını bulGET/v2/{account_id}/inboxesSayfaFacebook Sayfa API adım adım rehberi
Bir Sayfanın sohbetlerini listeleGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsSayfa
Sayfa adına yanıt verPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendSayfa
Sayfa adına gönderi yayınlaPOST/v2/{account_id}/posts, post_as ileSayfa
Webhook'lar
Bir webhook endpoint'i kaydetPOST/v2/webhooks/endpointsKişisel + SayfaWebhook'larla gerçek zamanlı CRM senkronizasyonu
Mesaj olaylarımessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newKişisel + Sayfa
Sohbet olaylarıchat.update, chat.deleteKişisel
Mesajlaşma
Sohbetleri listeleGET/v2/{account_id}/chatsKişisel
Bir sohbetin mesajlarını listeleGET/v2/{account_id}/chats/{chat_id}/messagesKişisel + Sayfa
Bir eki indirGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Kişisel + Sayfa
Yeni bir sohbet başlatPOST/v2/{account_id}/chats/sendKişisel
Mesaj gönder, metin veya ekPOST/v2/{account_id}/chats/{chat_id}/messages/sendKişisel + Sayfa
Mesaj tepkilerini listele, ekle veya kaldırGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsKişisel
Bir mesajı okundu olarak işaretlePOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readKişisel
Gönderiler
Bir kullanıcının veya Sayfanın gönderilerini listeleGET/v2/{account_id}/users/{user_id}/postsKişisel + Sayfa
Bir gönderiyi getirGET/v2/{account_id}/posts/{post_id}Kişisel + Sayfa
Gönderi oluşturPOST/v2/{account_id}/postsKişisel + Sayfa
Bir gönderiyi düzenle veya silPATCHDELETE/v2/{account_id}/posts/{post_id}Kişisel + Sayfa
Yorumlar
Bir gönderinin yorumlarını listeleGET/v2/{account_id}/posts/{post_id}/commentsKişisel
Bir yoruma verilen yanıtları listeleGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesKişisel
Yorum eklePOST/v2/{account_id}/posts/{post_id}/commentsKişisel
Bir yoruma yanıt verPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Kişisel
Bir yorumu düzenle veya silPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Kişisel
Tepkiler
Gönderi tepkilerini listele, ekle veya kaldırGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsKişisel
Yorum tepkilerini listele, ekle veya kaldırGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsKişisel
Profiller ve bağlantılar
Bir profili getirGET/v2/{account_id}/users/{user_id}Kişisel
Arkadaşları listeleGET/v2/{account_id}/users/me/relationsKişisel
Takipçileri veya takip edilenleri listeleGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingKişisel
Arkadaşlık isteği gönder veya listelePOSTGET/v2/{account_id}/users/me/relation-requestsKişisel
Bir isteği kabul et, reddet veya iptal etPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelKişisel
Facebook Sayfaları
Hesabın Sayfalarını bulGET/v2/{account_id}/inboxesSayfa
Bir Sayfanın sohbetlerini listeleGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsSayfa
Sayfa adına yanıt verPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendSayfa
Sayfa adına gönderi yayınlaPOST/v2/{account_id}/posts, post_as ileSayfa
Webhook'lar
Bir webhook endpoint'i kaydetPOST/v2/webhooks/endpointsKişisel + Sayfa
Mesaj olaylarımessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newKişisel + Sayfa
Sohbet olaylarıchat.update, chat.deleteKişisel

Kimlik doğrulama. Her istek, Unipile API anahtarınızı X-API-KEY başlığında taşır. Kullanıcılarınız kendi Facebook hesaplarını Hosted Auth ile bağlar; böylece hiçbir zaman Meta uygulaması oluşturmaz, App Review sürecinden geçmez veya Page token saklamazsınız. Bunu bir Facebook API access token ile karşılaştırın ve maliyetler için Messenger API fiyatlandırma dökümüne bakın.

Endpoint'ler Unipile V2 Facebook dokümantasyonundan ve sağlayıcı özellikleri tablosundan alınmıştır. Son kontrol: 17 Kasım 2026.

Kullanım senaryoları

Kullanım Senaryosuna Göre Facebook API

Facebook entegrasyonlarının çoğu bu ailelerden birine girer. Her birinin bir ürün içinde nasıl göründüğünü aşağıda bulabilirsiniz.

CRM'iniz
KişilerFırsatlar
KişiAşama
Julia ChenDemo hâlâ geçerli mi?NitelikliFacebook
Lucas MeyerTeklifi bana gönderinTeklifFacebook
Sofia Riveraİmzalandı, teşekkürler!KazanıldıFacebook
Daniel MoreauPazartesi konuşalımYeniFacebook

Facebook Messenger CRM entegrasyonu

Satış ve destek ekiplerinin CRM'den yanıt verebilmesi için konuşmaları kişi kayıtlarıyla senkronize edin. Facebook Messenger CRM entegrasyonunu görün.

Her konuşma, kopyala-yapıştır gerekmeden doğru kişiye kaydedilir.

Helpdesk'iniz
TaleplerMüşteriler
TalepDurum
Mia OwensSiparişim nerede? #4521AçıkFacebook
Elena Garciaİade alındı #4498ÇözüldüFacebook
Gabriel LopezFotoğraf eklendi #4530BeklemedeFacebook
Anna RossiGiriş yapamıyorum #4476AçıkFacebook

Facebook sohbet ve Messenger

Messenger Platform üzerinden bir Sayfaya mesaj atan kişilere veya bağlı bir hesabın kişilerine yanıt verin. Nasıl mesaj gönderileceğini görün.

Facebook talepleri alışılmış destek aracında yanıtlanır.

Sosyal Medya Aracınız
PaylaşanFacebookNorthwind BakeryFacebookAnna Lee
Her sabah 07.00'den itibaren taze ekşi mayalı ekmek.
Yayınla
Sonbahar menümüz pazartesi başlıyorSayfa · BugünYayınlandı
Harika 10 yıl için teşekkürler!Sayfa · 2 EkiDüzenlendi

Facebook gönderi API'si

Gönderi oluşturun, düzenleyin ve okuyun. Resmi API yalnızca Sayfalarda yayın yapar; bağlı bir hesap ise kendi kullanıcısı adına paylaşım yapabilir. Facebook post API rehberini okuyun.

Gönderiler doğrudan kendi ürününüzden yazılır, yayınlanır ve düzenlenir.

Topluluk Aracınız
Anna Lee adlı kişinin Sonbahar menümüz pazartesi başlıyor gönderisindeki yorumlar
YorumKonu
Ben TorresÖn sipariş alıyor musunuz?SoruFacebook
Julia NashBalkabaklı ekmek geri döndü!Geri bildirimFacebook
Kai OkaforGlutensiz mi?SoruFacebook
Priya Rao20 kişilik rezervasyon yapabilir miyiz?SatışFacebook

Facebook yorum API'si

Bir gönderideki yorumları listeleyin, ardından kullanıcının kendi bağlı hesabından yanıtlayın, düzenleyin veya silin. Yorumlar her zaman bu hesaptan gelir, asla bir Sayfadan gelmez: Sayfa olarak yorum yapmak Meta'nın Pages API'si üzerinden yapılır. Facebook yorum API rehberini okuyun.

Gönderi altındaki sorular tespit edilir ve doğru ekibe yönlendirilir.

Facebook Page API

Bir Page access token ve doğru Sayfa görevleriyle bir Facebook Sayfasının içeriğini yayınlayın ve denetleyin. Facebook Page API rehberini okuyun.

Facebook Messenger API fiyatlandırması

Meta, Messenger Platform'u kullanımı ücretsiz olarak tanımlar; pazarlama mesajları ise reklamlar üzerinden faturalandırılır. Asıl maliyet entegrasyon ve inceleme süresidir. Ayrıntılı analizi görün.

Ağlar arası tek bir inbox mı geliştiriyorsunuz?birleşik mesajlaşma API'sinin nasıl çalıştığını okuyun; diğer Meta ağı için de Instagram API rehberimize göz atın.

Ürününüz için doğru API'yi seçin

Uygulamanız kendi Sayfalarını veya reklamlarını yönetiyorsa Meta'nın Graph API'si doğru araçtır. Ürününüz her kullanıcının kendi hesabındaki konuşmalara ve gönderilere ihtiyaç duyuyorsa, bu hesapları Unipile üzerinden bağlayın ve Facebook ile diğer kanallarınız için tek bir API kullanın.

Avrupa Komisyonu
AB Düzenlemesi Digital Markets Act (DMA)

Her kullanıcı kendi hesabını bağlar, profil depolama yok. Unipile bir Meta İş Ortağı değildir. Digital Markets Act yaklaşımımız

Facebook API SSS

Anahtarlar, sürümler, erişim seviyeleri, Meta iş ortaklığı, uyumluluk ve Gruplar hakkında hızlı yanıtlar.

Geliştiriciler onu Facebook Sayfalarını yönetmek (gönderiler, yorumlar, istatistikler), Messenger Platform üzerinden Sayfa konuşmalarını yanıtlamak, reklam yayınlayıp ölçmek ve Facebook Login ile kişilerin giriş yapmasını sağlamak için kullanır. Her kullanım, kendi izinleri olan bir Graph API ürününe dayanır.

Tek bir anahtar yoktur. App ID ve App Secret almak için Meta for Developers'ta bir Meta uygulaması oluşturun, ardından access token'ları edinin: user token'ları Facebook Login üzerinden, Page token'ları /me/accounts üzerinden. Herkese açık kullanılan izinler, App Review sonrasında Advanced Access gerektirir.

Graph API; kullanıcılar, Sayfalar, gönderiler ve yorumlar gibi Facebook nesneleri için temel HTTP API'dir. Marketing API ise reklam hesapları, kampanyalar, hedef kitleler ve raporlama için kendi izinleri ve işletme gereksinimleri olan Graph API endpoint'lerinden oluşur.

Meta'nın resmi API'siyle hayır: uygulamalar publish_actions iznini 1 Ağustos 2018'de kaybetti ve yalnızca Sayfalarda yayın yapabilir. Unipile ile kendi Facebook hesabını bağlayan bir kullanıcı, Meta'nın koşulları çerçevesinde Posts endpoint'leri üzerinden bu hesaptan gönderi oluşturabilir.

Hayır. Meta, Ocak 2024'te Graph API v19.0 ile Groups API'yi publish_to_groups izni dahil kullanımdan kaldırdı. Unipile de Facebook Gruplarını kapsamaz.

Kasım 2026 itibarıyla Meta'nın changelog'u en son Graph API sürümü olarak v27.0'ı listeliyordu. Meta yılda birkaç sürüm yayınlar ve her birini en az iki yıl kullanılabilir tutar; bu nedenle bir sürüme sabitlemeden önce Graph API changelog sayfasını kontrol edin.

Hayır. Unipile, Meta için değil, Meta'nın Graph API'sinin yanında çalışan bağımsız bir şirkettir. Meta Partner veya resmi bir Meta uygulaması değildir ve Meta tarafından desteklenmez, sponsorluğu yapılmaz veya onaylanmaz. Facebook ve Messenger, Meta Platforms, Inc.'in ticari markalarıdır.

Hayır. Bu rehberde anlatılan Meta uygulaması, Facebook Login ve App Review adımları Meta'nın resmi API'si için geçerlidir. Unipile ile her kullanıcı kendi Facebook hesabını ve yönettiği Sayfaları barındırılan bir kimlik doğrulama sayfası üzerinden bağlar; böylece bu adımları kendi tarafınızda atlarsınız.

Digital Markets Act'in ruhuna uygun olarak tasarlanmıştır: tek bir uygulamanın çok sayıda hesabı okuması yerine her kullanıcı kendi hesabını bağlar ve Unipile, kullanıcı profillerini saklamadan onlar adına hareket eder. Ayrıntılar Digital Markets Act sayfamızda.

Evet. İster Graph API'yi ister Unipile'ı çağırın, Facebook hesapları Meta'nın Hizmet Koşullarına tabi kalır. Müşteri desteği, CRM ve kişilerin beklediği konuşmalar gibi meşru kullanımlarla sınırlı kalın; spam ve izinsiz otomasyon bir hesabın kısıtlanmasına yol açabilir.

Uygulamanız hâlâ üzerinde rolü olan kişilerle sınırlı. Standard Access ile izinler yalnızca uygulama yöneticilerinden, geliştiricilerden ve test kullanıcılarından istenebilir. Başka kişilerin Sayfalarına hizmet vermek için her iznin App Review ile onaylanan Advanced Access'e sahip olması gerekir ve Meta bunun için Business Verification şartı koyar.

Hâlâ sorularınız mı var? Ekibimiz yardıma hazır.

Bir uzmanla görüşün