
Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
Her token nasıl alınır, yaklaşık 60 güne nasıl uzatılır, debug_token ile nasıl kontrol edilir ve 190 hatası nasıl ele alınır; ayrıca bir SaaS uygulamasının token sürecini nasıl tamamen atlayabileceği.
graph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN} applicationUygulamanızis_validtrueexpires_at60 gün içindeuzun ömürlü user tokendata_access_expires_at90 gün içindekullanıcı aktif oldukça yenilenirscopesRefresh token yok: kontrol edin, sonra yeniden giriş
Facebook API access token, her Graph API çağrısının ihtiyaç duyduğu dizedir. User token'ı Facebook Login ile (testler için Graph API Explorer ile) alırsınız, sunucunuzda yaklaşık 60 gün geçerli uzun ömürlü bir token ile değiştirirsiniz, ardından Page token'ları için /me/accounts çağrısını yaparsınız. API anahtarı da refresh token da yoktur: token'ları debug_token ile izleyin ve 190 hatasını ele alın.
Çok sayıda müşteriye hizmet veren bir SaaS için ikinci bir model vardır: kullanıcılar Facebook hesaplarını Unipile üzerinden bağlar ve uygulamanız hiçbir Meta token'ı tutmaz.
Alınacak, uzatılacak veya hata ayıklanacak bir Meta token'ı yok
Hesabı bağlayın
Kullanıcınız Facebook hesabını veya Sayfasını Hosted Auth üzerinden bir kez bağlar. Meta uygulaması yok, App Review yok.
API anahtarınızla çağırın
Kullanıcının account_id değeriyle birlikte X-API-KEY gönderin: GET /v2/{ACCOUNT_ID}/chats.
Tek bir durumu izleyin
products_connection_status alanını kontrol edin; gerekirse kullanıcı Hosted Auth üzerinden yeniden bağlanır.
Meta, access token'ı "bir kullanıcıyı, uygulamayı veya Facebook Sayfasını tanımlayan opak bir dize" olarak tanımlar. Her Graph API isteği bir token taşır ve token'ın türü kimin adına işlem yaptığınızı belirler.
| Token | Kimin adına | Nasıl alınır | Süre ve kullanım |
|---|---|---|---|
| User | Giriş yapmış bir kişi | Facebook Login veya Graph API Explorer | 1 ile 2 saat ya da yaklaşık 60 gün |
| Page | Bir Facebook Sayfası | Bir yöneticinin user token'ı ile /me/accounts | Bağlı olduğu user token'ı izler |
| App | Meta uygulamanız | client_credentials çağrısı veya {APP_ID}|{APP_SECRET} | Yalnızca sunucudan sunucuya çağrılar |
| System user | İşletmeniz | Business Settings | Süresiz veya 60 gün |
| Client | İstemci kodundaki uygulamanız | App Dashboard | Gizli değildir |
/me/accountsclient_credentials çağrısı veya {APP_ID}|{APP_SECRET}Instagram'ın kendi akışı vardır: Instagram API token rehberimize bakın.
Kaynak: Meta'nın Access Tokens rehberi. Son doğrulama: 17 Kasım 2026.
Facebook API anahtarı diye bir şey yoktur: her çağrı bir access token kullanır. Testler için Graph API Explorer'da kendi hesabınıza bir token oluşturun. Üretimde kullanıcılar Facebook Login ile (Sayfalarına ihtiyacınız varsa Facebook Login for Business ile) Meta uygulamanıza giriş yapar ve sunucunuz dönen kodu bir user access token ile değiştirir.
developers.facebook.com/tools/explorer adresini açınclient_id, redirect_uri ve state ile /dialog/oauth adresine yönlendirincode alırsınızcode ve App Secret ile /oauth/access_token çağrısını yaparYanıt access_token, token_type ve expires_in alanlarını içerir. Başka kişiler ancak App Review uygulamanıza Advanced Access verdikten sonra izin verebilir. Erişim sürecinin tamamı Facebook API genel bakışımızda, Sayfa tarafı ise Facebook Page API rehberimizde yer alıyor.
Kaynak: Meta'nın Manually Build a Login Flow rehberi (Graph API v27.0). Son doğrulama: 17 Kasım 2026.
Kısa ömürlü user token'ı grant_type=fb_exchange_token, App ID'niz ve App Secret'ınızla birlikte GET /oauth/access_token adresine gönderin. Yanıt, uzun ömürlü bir token ve onun expires_in değerini, yani yaklaşık 60 günü içerir. Meta bu konuda açıktır: "Bu çağrıyı istemciden değil, sunucunuzdan yapın."
1 ile 3 arasındaki sekmeler Meta'nın Graph API'sini kullanır; 4. sekme Unipile'dır ve Meta token'ı gerektirmez.
# Server side only: this call carries your App Secret
curl -G "https://graph.facebook.com/oauth/access_token" \
-d "grant_type=fb_exchange_token" \
-d "client_id={APP_ID}" \
-d "client_secret={APP_SECRET}" \
-d "fb_exchange_token={USER_ACCESS_TOKEN}"
# Response (abridged)
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "expires_in": 5183944 }
# App access token, for server-to-server calls such as debug_token
curl -G "https://graph.facebook.com/oauth/access_token" \
-d "client_id={APP_ID}" \
-d "client_secret={APP_SECRET}" \
-d "grant_type=client_credentials"
# Or pass it directly, without the call
access_token={APP_ID}|{APP_SECRET}
# Check any token with your app token
curl -G "https://graph.facebook.com/debug_token" \
-d "input_token={LONG_LIVED_USER_TOKEN}" \
-d "access_token={APP_ID}|{APP_SECRET}"
# Response (abridged)
{ "data": {
"app_id": "{APP_ID}",
"is_valid": true,
"expires_at": 1800057600,
"data_access_expires_at": 1802649600,
"scopes": ["public_profile", "pages_show_list"]
} }
# No Meta token: your API key and the user's account_id
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
--header "X-API-KEY: {API_KEY}"
# List the chats of the connected account
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
--header "X-API-KEY: {API_KEY}"
İstekler Meta'nın Long-Lived Access Tokens ve Access Tokens rehberlerinden alınmıştır. Unipile: Facebook Pages dokümantasyonu.
Bir Sayfa yöneticisinin uzun ömürlü user token'ı ile GET /me/accounts, her Sayfayı kendi token'ıyla döndürür; bu token'ın "son kullanma tarihi yoktur ve yalnızca belirli koşullarda sona erer veya geçersiz hale gelir". Ayrıntılar Facebook Page API rehberimizde; bu token ile yayın yapmak için bir Sayfada kendi token'ıyla nasıl paylaşım yapılacağına bakın.
Meta'ya göre kısa ömürlü bir user token yaklaşık bir ile iki saat, uzun ömürlü bir token ise yaklaşık 60 gün geçerlidir. Uzun ömürlü bir token'dan alınan Page token'ların ve bazı system user token'larının son kullanma tarihi yoktur. Bundan bağımsız olarak, bir kullanıcının verilerine erişim 90 günlük hareketsizliğin ardından sona erer.
Meta, "veri erişiminin sona erme süresinin, kullanıcının son etkin olduğu zamana göre 90 gün" olduğunu belirtir. Kullanıcı oturumu açık kalır, ancak uygulamanız yeniden yetkilendirilene kadar onun verilerini okuyamaz.
Hiçbir token kalıcı değildir: "süresiz" bir token bile kullanıcı uygulamanızı kaldırdığında, şifresini değiştirdiğinde veya rolünü kaybettiğinde çalışmayı bırakır. Meta şu uyarıyı yapar: "Bu sürelerin aynı kalacağına güvenmeyin."
Kaynaklar: Meta'nın Access Tokens, Long-Lived Access Tokens, Authorization vs. data access ve system user token'ları rehberleri. Son doğrulama: 17 Kasım 2026.
Bir system user access token, bir kişiye değil, Business Manager'ınızdaki bir system user'a aittir. Meta'ya göre "uygulamanızın Ad nesneleri veya Sayfalar üzerinde programatik, otomatik işlemler yapmasını" sağlar. Business Settings'te oluşturulur.
Yenileme yok; token sızıntısının kabul edilebilir bir risk olduğu durumlar için.
set_token_expires_in_60_days=true değerini ayarlayın ve 60. günden önce fb_exchange_token ile yenileyin.
Kaynaklar: Meta'nın Install apps and generate tokens ve Access Tokens rehberleri. Son doğrulama: 17 Kasım 2026.
Bir app access token (veya uygulamanın bir geliştiricisinin user token'ı) ile GET /debug_token?input_token={TOKEN} çağrısını yapın. Yanıt geçerliliği, son kullanma tarihini, veri erişiminin bitiş tarihini ve verilen izinleri döndürür. Kod yazmadan kontrol için token'ı Access Token Debugger'a (developers.facebook.com/tools/debug/accesstoken) yapıştırın.
0 son kullanma tarihi olmadığı anlamına gelir.granular_scopes hedef ID'leri ekler.Üretimde bir Facebook access token'ın geçerli olup olmadığını kontrol etmek için yukarıdaki kod bloğunun 3. sekmesindeki isteği sunucunuzda düzenli olarak çalıştırın ve her iki tarihi her token ile birlikte saklayın. scopes içinde eksik bir izin, "bende çalışıyor, onlarda çalışmıyor" türündeki hataların çoğunu açıklar.
Kaynak: Meta'nın debug_token referansı (Graph API v27.0). Son doğrulama: 17 Kasım 2026.
190 hatası, Facebook access token'ın süresinin dolduğu veya geçersiz olduğu anlamına gelir. OAuthException olarak döner ve error_subcode değeri kullanıcıdan ne istemeniz gerektiğini söyler. Aynı token ile yeniden denemek sorunu asla çözmez.
{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }
error_subcode'u okuyun, Meta desteği için fbtrace_id'yi saklayın
| Subcode | Anlamı | Ne yapmalı |
|---|---|---|
| 458 | Uygulama yüklü değil | Kullanıcının yeniden giriş yapmasını sağlayın |
| 459 | Kullanıcı güvenlik kontrolünde | Kullanıcı facebook.com'a giriş yapar |
| 460 | Şifre değişti | Kullanıcının yeniden giriş yapmasını sağlayın |
| 463 | Token'ın süresi doldu | Yeniden giriş, ardından yeniden değişim |
| 464 | Onaylanmamış kullanıcı | Kullanıcı facebook.com'a giriş yapar |
| 467 | Geçersiz token | Kullanıcıyı yeniden bağlayın |
| 492 | Sayfada uygun rol yok | Mevcut bir yöneticiden yeni token |
Çok müşterili bir SaaS'ta 492 klasik durumdur: bir Sayfayı bağlayan yönetici ayrılır. Diğer kodlar Facebook API hataları tablomuzda.
Kaynak: Meta'nın Graph API error handling rehberi. Son doğrulama: 17 Kasım 2026.
Her Facebook access token'ı, ait olduğu hesabın şifresi gibi ele alın: App Secret'ı ve app token'ları sunucunuzda tutun, user ve Page token'larını depolamada şifreleyin, sunucu çağrılarını appsecret_proof ile imzalayın ve bir müşteri bağlantısını kestiği anda token'ları silin.
appsecret_proof ile imzalayın. Meta bunu "app secret'ı anahtar olarak kullanan, access token'ınızın bir sha256 hash'i" olarak tanımlar; uygulama panosunda Require App Secret seçeneğini etkinleştirin.expires_at değerini saklayın.Kaynaklar: Meta'nın Access Tokens ve Securing Requests rehberleri. Son doğrulama: 17 Kasım 2026.
Unipile ile her kullanıcı Facebook hesabını Hosted Auth üzerinden bir kez bağlar. Yönettikleri Sayfalar aynı account_id üzerinde gelir ve API'yi kendi anahtarınızla (X-API-KEY) çağırırsınız. Sizin tarafınızda Meta token'ı, Meta uygulaması ve App Review yoktur.
| Soru | Meta access token'ları | Unipile bağlı hesabı |
|---|---|---|
| Ne saklarsınız | Kullanıcı başına bir token, ayrıca Sayfa, yönetici ve uygulama başına birer token | Kullanıcı başına bir account_id ve tek bir API anahtarı |
| Neyi izlersiniz | Her token için expires_at ve data_access_expires_at | metadata.products_connection_status içinde Sayfa başına bir durum |
| Neyi yenilersiniz | 60. günden önce uzun ömürlü değişim veya yeniden giriş | Değiştirilecek Meta token'ı yok |
| 190 hatasında | Subcode'u okuyun, ardından kullanıcıdan yeniden giriş isteyin | Gerekirse kullanıcı Hosted Auth ile yeniden bağlanır |
account_id ve tek bir API anahtarıexpires_at ve data_access_expires_atmetadata.products_connection_status içinde Sayfa başına bir durumBağlı bir hesap mesajları, Sayfa gelen kutularını, gönderileri, yorumları ve tepkileri kapsar. Bir Sayfa konuşmalarını yanıtlayabilir ve gönderi yayınlayabilir, ancak bir konuşma başlatamaz. Yukarıdaki 4. sekmeye ve Facebook Messenger API sayfamıza bakın.
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 hareket eder ve her kullanıcı Meta'nın koşullarına bağlı kalır.
Token altyapısı kurmadan Facebook üzerinde geliştirin
Her kullanıcı Facebook hesabını bir kez bağlar; Facebook, LinkedIn, WhatsApp ve e-posta için tek bir API kullanırsınız. 7 gün ücretsiz deneme.
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
Hesap bağlandıktan sonra Unipile ile kullanılabilen tüm Facebook endpoint'lerine göz atın veya izinler, limitler ve hatalar için eksiksiz Facebook API rehberimizi okuyun.
Token süresi, yenileme, geçerlilik kontrolü, saklama ve 190 hatası hakkında hızlı yanıtlar.
Tam anlamıyla hayır. Uzun ömürlü bir user token yaklaşık 60 gün geçerlidir. Ondan türetilen Page token'ların ve bazı system user token'larının son kullanma tarihi yoktur, ancak kullanıcı uygulamanızı kaldırdığında, şifresini değiştirdiğinde veya rolünü kaybettiğinde yine de çalışmayı bırakırlar. Bir yeniden bağlanma akışı planlayın.
OAuth anlamında hayır: Meta, Facebook Login için herhangi bir refresh_token grant'i belgelemez. Geçerli bir kısa ömürlü token'ı fb_exchange_token ile değiştirirsiniz; bir token'ın süresi dolduğunda kullanıcı yeniden giriş yapar. Yerel mobil uygulamalarda Meta, kişi uygulamanızı kullandığında uzun ömürlü token'ları günde bir kez yeniler.
Çünkü 60 gün bir üst sınırdır, bir garanti değil. Kullanıcı şifresini değiştirdiğinde, uygulamanızı kaldırdığında, bir güvenlik kontrolüne takıldığında veya Sayfadaki rolünü kaybettiğinde token erken sona erer; Meta da sürelerin "uyarı yapılmadan değişebileceği veya erken sona erebileceği" konusunda uyarır. Hangi durumla karşılaştığınızı anlamak için 190 hatasının error_subcode değerini okuyun.
App access token'ınızla GET /debug_token?input_token={TOKEN} çağrısını yapın ve is_valid, expires_at, data_access_expires_at ile scopes alanlarını okuyun. Tek seferlik bir kontrol için token'ı Meta'nın Access Token Debugger aracına yapıştırın.
Evet, onlara şifre gibi davranırsanız: depolamada şifreleyin, log'lardan ve istemci kodundan uzak tutun, App Secret'ı ve app token'ları yalnızca sunucudan sunucuya çağrılarda kullanın. Sunucu çağrılarını appsecret_proof ile imzalayın.
492 subcode'lu 190 hatası geçersiz bir oturum anlamına gelir: bir Page access token'ın arkasındaki kullanıcının artık Sayfada uygun bir rolü yoktur. Mevcut bir yöneticiden yeni bir Page token alın.
Hayır. Unipile 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, Meta Platforms, Inc.'in ticari markasıdır.
Hayır. Unipile'ı API anahtarınız ve bağlı her kullanıcının account_id değeriyle çağırırsınız. Kullanıcılar Facebook hesaplarını ve yönettikleri Sayfaları Unipile'ın hosted authentication akışı üzerinden bağlar: sizin tarafınızda Meta uygulaması, App Secret veya App Review yoktur.
Digital Markets Act'e uygun olarak tasarlanmıştır: 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. Bağlı her hesap Meta'nın Hizmet Koşullarına tabi olmaya devam eder. API'yi müşteri desteği, CRM ve doğrudan konuşmalar gibi meşru senaryolar için kullanın; spam ve izinsiz otomasyon hesapları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