
Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
2026'da Page access token'lar, Sayfa görevleri, pages_* izinleri ve App Review; ayrıca bir SaaS uygulamasının, kullanıcılarının yönettiği Sayfaları nasıl bağlayabileceği.
graph.facebook.com/me/accounts?fields=id,name,tasks,access_token access_token: {PAGE_ACCESS_TOKEN_1}
access_token: {PAGE_ACCESS_TOKEN_2}
Her Sayfa, yönetici ve uygulama için bir Page token
Facebook Page API (Meta buna Facebook Pages API diyor), bir Facebook Sayfasını yönetmeye yarayan Graph API endpoint'lerinden oluşur: gönderi yayınlama ve okuma, yorum moderasyonu, istatistikleri okuma ve Sayfa konuşmalarını yönetme. Her çağrı, Sayfada görev yapabilen bir kişiden alınmış bir Page access token gerektirir. Uygulamanızda rolü olan kişilerin yönettiği kendi Sayfalarınız için App Review gerekmez; müşterilerinizin Sayfalarına hizmet vermek ise App Review'dan geçmiş bir uygulama gerektirir.
Çok sayıda müşteriye hizmet veren bir SaaS için ikinci bir model daha var: kullanıcılar Facebook hesaplarını Unipile üzerinden bağlar ve Sayfaları da bu bağlantıyla birlikte gelir.
Kullanıcılarınızın Sayfaları, yönetilecek bir Page token olmadan
Bağlayın. Kullanıcınız Facebook hesabını Hosted Auth üzerinden bağlar, Sayfaları da onunla birlikte gelir. Meta uygulaması yok, App Review yok.
Sayfaları listeleyin. X-API-KEY anahtarınızla GET /v2/{ACCOUNT_ID}/inboxes çağırın: her Sayfa bir PAGE_<page_id>_INBOX inbox'ıdır.
Sayfa olarak işlem yapın. POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send ile yanıtlayın veya post_as ile Sayfa olarak yayınlayın.
Graph API'nin Page node'u etrafında kurulan bölümüdür: bir Sayfayı, gönderilerini, yorumlarını ve metriklerini okuyan ve değiştiren endpoint'ler. Mesajlaşma Messenger Platform'da, reklamlar ise Marketing API'de çalışır; ikisi de aynı Page access token'ı kullanır.
Adına rağmen Graph API, GraphQL değildir. graph.facebook.com adresinde çalışan, sürümlenmiş bir HTTP API'sidir ve node, edge ve field'lar şeklinde düzenlenmiştir. Daha geniş bir bakış (Login, Messenger, sürümler, rate limit) için Facebook API'lerinin birbirine nasıl bağlandığına göz atın.
GET / POST /{page-id}pages_manage_metadata · MANAGEPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENTGET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATEGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZEGET /{page-id}/conversationspages_messaging · MESSAGINGPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_listBir Page access token ile yapılan çağrılar, Sayfa başına hesaplanan Meta'nın Business Use Case limitlerine tabidir: 24 saatte 4.800 çağrı çarpı etkileşimli kullanıcı sayısı; etkileşimli kullanıcılar, bu süre içinde Sayfayla etkileşime giren kişilerdir. Her yanıt, mevcut kullanımınızı gösteren bir X-Business-Use-Case-Usage header'ı taşır. Diğer Facebook API'lerinin limitleri Facebook API rehberimizde yer alıyor.
Kaynaklar: Meta'nın Pages API genel bakışı, Manage a Page, Page Insights, Webhooks for Pages, Posts, Comments, Page conversations, subscribed_apps, rate limiting ve izin referansı. Son doğrulama: 17 Kasım 2026.
Facebook Page API anahtarı diye bir şey yoktur. Bir Sayfa yöneticisi Facebook Login for Business ile Meta uygulamanıza giriş yapar ve size bir user access token verilir. Ardından GET /me/accounts, kişinin yönettiği tüm Sayfaları görevleriyle ve her biri için bir Page access token ile döndürür.
Meta for Developers'ta, "Manage everything on your Page" kullanım senaryosuyla.
App ID + App Secretpages_show_list iznini ve özelliklerinizin gerektirdiklerini talep edin.
Kısa ömürlüdür; sunucu tarafında (fb_exchange_token) uzun ömürlü bir token ile değiştirin.
Her Sayfa kendi ID'sini, görevlerini ve token'ını döndürür.
GET /me/accountsMeta'ya göre Page access token'lar her Sayfa, yönetici ve uygulama kombinasyonuna özgüdür. On müşteri Sayfası, saklanması ve izlenmesi gereken on token demektir.
Değiştirme çağrısı ve /me/accounts isteği, aşağıdaki kod bloğunun "Meta token exchange" sekmesinde kopyalamaya hazır. User, app ve system user token'ları Facebook API access token rehberimizde ele alınıyor.
Yönettiğiniz bir Sayfada kod yazmadan test etmek için:
pages_show_list ile test etmek istediğiniz izinleri ekleyin.Başlangıçtaki user token'a bağlıdır. Kısa ömürlü bir user token ile alınan Page token yaklaşık bir saat geçerlidir. Önce user token'ı uzun ömürlü bir token ile değiştirin, /me/accounts'u yeniden çağırın: Meta'ya göre elde ettiğiniz Page token'ın bir son kullanma tarihi yoktur, ancak yine de geçersiz kılınabilir.
Kaynaklar: Meta'nın Access Tokens, Long-Lived Access Tokens ve Get a Page Access Token sayfaları; Graph API Explorer adımları kendi rehberinden. Meta ayrıca bu sürelerin aynı kalacağına güvenilmemesi gerektiğini belirtiyor. Son doğrulama: 17 Kasım 2026.
Evet. Uzun ömürlü bir user token ile /me/accounts çağrılarak elde edilen uzun ömürlü bir Page access token'ın son kullanma tarihi yoktur. Meta'nın ifadesiyle, uzun ömürlü Page access token'ların süresi yalnızca belirli koşullar altında dolar veya geçersiz kılınır. Çoğu rehberin bahsettiği "kalıcı" Page token budur. Yine de sonsuz değildir: aşağıdaki olaylar onu hâlâ geçersiz kılar; bu yüzden saklayın, hataları izleyin ve bir yeniden bağlanma akışı planlayın. Kendi işletmenize ait Sayfalar için diğer seçenek bir system user token'dır.
Meta bu durumları 190 hatası olarak bildirir. Alt kodları ve bir token'ın debug_token ile nasıl kontrol edileceği Facebook API access token rehberimizde ayrıntılı olarak anlatılıyor; bir Page token için çözüm her zaman aynıdır: yöneticiden yeniden bağlanmasını isteyin.
Bir çağrı ancak token'ın arkasındaki kişi Sayfada ilgili görevi yerine getirebiliyorsa ve uygulamanız ilgili izne, uygulamanızın dışındaki kişiler için de Advanced Access'e sahipse başarılı olur.
Görevler, bir kişinin Sayfada yapabildikleridir. /me/accounts bunları Sayfa bazında listeler; bir yönetici hepsini yerine getirebilir.
İzinler, uygulamanızın yapabildikleridir. "Manage everything on your Page" kullanım senaryosuyla oluşturulan bir Meta uygulaması pages_show_list, business_management ve public_profile ile başlar. Yalnızca bir özelliğin kullandığı izinleri ekleyin: her izin ayrı ayrı incelenir.
pages_read_engagement ile birlikte Sayfa istatistiklerini okumaYönetmediğiniz Sayfaları okumak farklı bir durumdur: Meta'nın Sayfalardaki gönderileri ve etkileşimleri analiz etmek veya göstermekle sınırladığı Page Public Content Access özelliğini gerektirir ve kendi App Review ile Business Verification sürecine tabidir.
Kaynaklar: Meta'nın Pages API genel bakışı (görevler), Manage a Page (ayarlar için MANAGE), Page Insights, izin referansı (açıklamalar, özetlenmiştir) ve Page Public Content Access. Son doğrulama: 17 Kasım 2026.
Uygulamanız Standard Access ile başlar ve Meta'ya göre Standard Access'e sahip izinler yalnızca uygulamada rolü olan kullanıcılardan talep edilebilir. Prototipiniz kendi Sayfanızda çalışır, bir müşteri giriş yaptığında ise başarısız olur. Müşterilerin Sayfalarına hizmet vermek için, App Review üzerinden izin bazında verilen Advanced Access gerekir.
İzin verebilen tek kişiler, uygulamada rolü olanlardır.
İzin başına bir talep ve doğrulanmış bir işletme.
Her Sayfa yöneticisi onaylanan izinleri verebilir.
Yayına alındıktan sonra her müşteri Sayfası kendi başına küçük bir entegrasyondur: bir yönetici girişi, saklanan bir token, o yöneticinin görevleri, bir sağlık kontrolü ve bir yeniden bağlanma akışı. Facebook Page API'de bunları tenant'lar arasında sizin yerinize takip eden hiçbir şey yoktur. Meta'nın başvuru rehberi şunları istiyor:
Meta ayrıca Business Verification şartı koyuyor: Advanced Access almak için işletme doğrulaması zorunludur.
Kaynaklar: Meta'nın erişim seviyeleri, App Review başvuru rehberi ve Pages API genel bakışı (Sayfa ile ilgili tüm izinler ve özellikler App Review onayı gerektirir). Son doğrulama: 17 Kasım 2026.
Sayfa konuşmaları Pages API'nin bir parçası değildir. Aynı Page access token, pages_messaging izni ve MESSAGING göreviyle Messenger Platform üzerinde çalışırlar.
Kişiler Page-scoped ID (PSID) ile tanımlanır, ilk mesajı onlar yazar ve Sayfa, son mesajlarından sonraki 24 saat boyunca yanıt verebilir. Bir SaaS uygulamasının bu konuşmaları nasıl okuyup yanıtladığını Facebook Messenger API sayfamızda anlatıyoruz. Kişisel bir profildeki konuşmalar için kişisel hesaplar için Facebook Messenger API yazımıza, Meta'nın neyi ücretlendirdiğini görmek için Facebook Messenger API fiyatlandırması yazımıza göz atın.
Unipile ile kullanıcınız Facebook hesabını Hosted Auth üzerinden bir kez bağlar. Yönettiği Sayfalar varsayılan olarak aynı account_id üzerinde etkinleştirilir. Sizin tarafınızda Meta uygulaması, App Review veya Page token yoktur.
Bir Sayfadaki sorun kişisel gelen kutusunu veya diğer Sayfaları etkilemez.
api.unipile.com/v2/{ACCOUNT_ID}/inboxes
200 OK
PAGE_<page_id>_INBOX gelen kutusu olarak görünürpost_as parametresiyle Sayfa olarak gönderi yayınlama (Facebook gönderi API'si)501 api/not_implemented)Her Sayfa kendi durumunu metadata.products_connection_status altında bildirir (anahtar page_<page_id>). Aynı bağlantı yöneticinin kişisel mesajlarını da taşır; aynı API LinkedIn, WhatsApp, Instagram, Telegram, e-posta ve takvimleri de kapsar.
Sayfaları listeleyin, ardından bir Sayfa konuşmasını yanıtlayın. "Meta Graph API" sekmesi bir Page token kullanır, "Meta token exchange" sekmesi süresi dolmayan bir Page token'ın nasıl alınacağını gösterir, "Unipile" sekmesi ise bağlı hesabı kullanır.
# 1. List the Pages a person manages, with tasks and Page tokens
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={USER_ACCESS_TOKEN}"
# Response (abridged)
{ "data": [ {
"id": "{PAGE_ID}",
"name": "Northwind Bakery",
"tasks": ["CREATE_CONTENT", "MODERATE", "MESSAGING", "ANALYZE"],
"access_token": "{PAGE_ACCESS_TOKEN}"
} ] }
# 2. Store one token per Page, then call Page endpoints with it
curl "https://graph.facebook.com/{PAGE_ID}/conversations?platform=messenger&access_token={PAGE_ACCESS_TOKEN}"
# 1. Server side: exchange the short lived user token for a long lived one
curl "https://graph.facebook.com/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_LIVED_USER_TOKEN}"
# Response
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "token_type": "bearer", "expires_in": 5183944 }
# 2. Call /me/accounts with the long lived user token:
# the Page tokens it returns have no expiration date
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={LONG_LIVED_USER_TOKEN}"
# 1. List the inboxes of the connected account: one per managed Page,
# with the ID PAGE_{PAGE_ID}_INBOX
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 2. List the chats of one Page inbox
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes/PAGE_{PAGE_ID}_INBOX/chats" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 3. Reply in a Page chat (chat ID PAGE_{PAGE_ID}_{THREAD_KEY})
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": "Yes, we open at 9am on Sunday." }'
Meta çağrıları 17 Kasım 2026'da Long-Lived Access Tokens ile kontrol edildi. Etkinleştirme, gelen kutusu ID'leri ve post_as, Facebook Pages dokümantasyonunda ayrıntılı olarak anlatılıyor.
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ış her kullanıcı adına bağlanır ve her kullanıcı Meta'nın koşullarına bağlı kalır. Kullanıcılarınızın yönettiği Sayfalardaki müşteri konuşmaları için kullanın.
Meta'nın Pages API'si, kendi Sayfalarını yöneten veya istatistiklere ve reklamlara ihtiyaç duyan bir ekibe uyar. Bağlı hesap ise kullanıcılarının kendi Sayfalarını getirdiği bir SaaS'a uyar.
| Soru | Meta Pages API | Unipile bağlı hesap |
|---|---|---|
| Sayfayı kim bağlar | Bir Sayfa yöneticisi, Meta uygulamanızdaki Facebook Login for Business ile | Kullanıcınız, Hosted Auth ile |
| Meta uygulaması ve App Review | Zorunlu; ayrıca Advanced Access ve Business Verification | Sizin tarafınızda gerekmez |
| Yönetilecek token'lar | Her Sayfa, yönetici ve uygulama için bir Page token | Hiç: bir account_id ve API anahtarınız |
| Sayfa mesajları | Messenger Platform, pages_messaging, 24 saatlik pencere | Okuma ve yanıtlama; Sayfa konuşma başlatamaz |
| Sayfa olarak yayınlama | pages_manage_posts | posts endpoint'inde post_as |
| Yöneticinin kişisel hesabı | Mesajlaşma için kullanılamaz | Aynı bağlantı: kişisel sohbetler, gönderiler ve profil |
| Sayfa bazında durum | Her token'ı kendiniz kontrol edersiniz | products_connection_status içinde page_<page_id> |
account_id ve API anahtarınızpages_messaging, 24 saatlik pencerepages_manage_postspost_asproducts_connection_status içinde page_<page_id>Login, Messenger, Marketing API ve Pages arasında hâlâ seçim mi yapıyorsunuz? Karar tablomuz, her ürün türü için hangi Facebook API'ye ihtiyacınız olduğunu gösteriyor.
Sayfaları token altyapısı kurmadan bağlayın
Her kullanıcının Facebook hesabını bir kez bağlamasını sağlayın ve Sayfa gelen kutularıyla gönderileriyle, LinkedIn, WhatsApp ve e-posta hesaplarıyla aynı API üzerinden çalışın. 7 gün ücretsiz deneme, kredi kartı gerekmez.
Her kullanıcı kendi hesabını bağlar, profil depolama yok. Unipile bir Meta İş Ortağı değildir. Daha fazla bilgi edinin
Tüm Facebook API endpoint'leri tek bir yerde
Sayfalar resmin yalnızca bir parçası. Unipile ile kullanılabilen tüm Facebook endpoint'lerine (mesajlar, gönderiler, yorumlar, profiller, webhook'lar) göz atın veya eksiksiz Facebook API rehberimizi okuyun.
Facebook Page access token, geçerlilik süresi, App Review ve izinler hakkında hızlı yanıtlar.
Bir Sayfa yöneticisinin, pages_show_list iznini talep ederek Facebook Login for Business ile Meta uygulamanıza giriş yapmasını sağlayın. User token'ı sunucunuzda grant_type=fb_exchange_token kullanarak uzun ömürlü bir token ile değiştirin, ardından GET /me/accounts çağrısını yapın: her Sayfa kendi access_token'ı ve yöneticinin yapabileceği görevlerle döner.
Arkasındaki user token'a bağlıdır. Meta'ya göre kısa ömürlü bir user token ile alınan Page token 1 saat geçerlidir. Uzun ömürlü bir user token'dan (yaklaşık 60 gün) alırsanız Page token'ın son kullanma tarihi olmaz; yine de çıkış yapılması, şifre değişikliği veya uygulamanın kaldırılması onu geçersiz kılar.
Evet. Uzun ömürlü bir user token ile /me/accounts çağrısını yaptığınızda dönen Page token'ların son kullanma tarihi yoktur. Ancak her durumda kalıcı değildir: yönetici Sayfadaki rolünü kaybederse, şifresini değiştirirse veya uygulamanızı kaldırırsa token çalışmayı bırakır ve yöneticinin yeniden bağlanması gerekir.
Uygulamanız yalnızca Standard Access'e sahip; bu yüzden ona izin verebilen tek kişiler uygulamada rolü olanlar. Müşteri Sayfalarına hizmet vermek için her iznin Advanced Access'e sahip olması gerekir. Bu erişim, izin başına bir ekran kaydıyla App Review üzerinden verilir ve Meta bunun için Business Verification şartı koyar.
Neredeyse her entegrasyon pages_show_list ile başlar. Ardından yalnızca kullandıklarınızı ekleyin: içerik ve meta verileri okumak için pages_read_engagement, yayınlamak için pages_manage_posts, yorumlar için pages_manage_engagement, konuşmalar için pages_messaging, webhook'lar ve ayarlar için pages_manage_metadata, metrikler için read_insights.
Hayır. Unipile bağımsız bir şirkettir, Meta Partner değildir ve Meta tarafından desteklenmez, sponsorluğu yapılmaz veya onaylanmaz. Sayfaları Unipile üzerinden bağlamak ürününüzü bir Meta uygulaması da yapmaz. Facebook ve Messenger, Meta Platforms, Inc.'in ticari markalarıdır.
Hayır. Page access token toplayan bir Meta uygulaması yerine, kullanıcılarınız Facebook hesaplarını Unipile'ın hosted authentication akışı üzerinden bir kez bağlar ve yönettikleri Sayfalar bu bağlantıyla birlikte gelir. Sizin tarafınızda tamamlanacak bir App Review, Advanced Access veya Business Verification yoktur.
Digital Markets Act'in ruhuna uygun olarak geliştirilmiştir: her Sayfa yöneticisi kendi hesabını bağlar, Unipile zaten yönettikleri Sayfalar için onlar adına hareket eder ve kullanıcı profillerini saklamaz. Ayrıntılar Digital Markets Act sayfamızda.
Evet. Unipile üzerinden bağlanan bir Sayfa, Meta'nın Hizmet Koşullarına ve Sayfa politikalarına tabi olmaya devam eder. Sayfa gelen kutusunda müşterilere yanıt vermek, Sayfanın kendi içeriğini yayınlamak veya konuşmaları bir CRM ile senkronize etmek gibi meşru kullanımlarla sınırlı kalın; spam ve izinsiz otomasyon hesabın veya Sayfanın kısıtlanmasına yol açabilir.
Hâlâ sorularınız mı var? Ekibimiz yardıma hazır.
Bir uzmanla görüşün