
Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
Facebook Messenger API için bir kişisel hesap seçeneği mi arıyorsunuz? Meta'nın Messenger Platform'u yalnızca Facebook Sayfalarına hizmet eder. Nedenini ve kullanıcılarınızın kendi hesaplarını uygulamanıza nasıl bağlayabileceğini burada bulabilirsiniz.
api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
Resmi Facebook Messenger API kişisel hesapları desteklemez. Meta'nın Messenger Platform'u, kişilere bir Facebook Sayfasının veya Instagram profesyonel hesabının yanıt vermesini sağlar, kişisel bir profilin asla. Kişisel bir Facebook hesabıyla çalışmak için hesap sahibi, hesabını Unipile gibi üçüncü taraf bir API üzerinden uygulamanıza bağlar.
messenger.com'u bir tarayıcıdan yöneten açık kaynak projeler resmi değildir, çoğunlukla bakımı yapılmaz ve arayüz her değiştiğinde bozulur. Bağlı bir hesap ise webhook'lar sunan, bakımı yapılan bir API üzerinden çalışır.
Meta'nın API'lerine daha geniş bir bakış için Facebook API'lerinin birbirine nasıl bağlandığına göz atın.
Kişisel bir Facebook hesabından üç adımda mesajlaşma
Bağlayın. Kullanıcınız kendi Facebook hesabını Hosted Auth üzerinden bağlar. Meta uygulaması yok, App Review yok.
Gönderin. V2 API'yi X-API-KEY header'ınızla çağırın:POST/v2/
Alın. Gelen mesajlar webhook'unuza message.new event'leri olarak ulaşır.
Ayrıntılar aşağıdaki bağlantı akışı ve kod örneklerinde veya Facebook quickstart rehberinde.
7 günlük ücretsiz denemenizi başlatınResmi olanı çalışmaz. Meta, Messenger Platform'u işletmeler için tasarladı: bir Facebook Sayfasının veya Instagram profesyonel hesabının kendisine yazan kişileri yanıtlamasını sağlar. Kişisel bir Facebook hesabı uygulamanıza ancak sahibi onu, kendi adına hareket eden üçüncü taraf bir API üzerinden bağladığında ulaşabilir.
Kaynak: Meta'nın Messenger Platform genel bakışı. Son doğrulama: Kasım 2026.
Messenger Platform bir kişi etrafında değil, bir Sayfa etrafında tasarlanmıştır. Her çağrı, bir Page access token ve pages_messaging izniyle bir Facebook Sayfası adına yapılır; dolayısıyla kişisel bir inbox'ı temsil eden bir token yoktur.
Meta for Developers üzerinde Messenger kullanım senaryosuyla bir uygulama kaydedersiniz.
Bir Sayfa yöneticisi pages_messaging gibi izinler verir.
Uygulamanız Send API'yi yalnızca o Sayfa adına çağırır.
Sayfa mesajları alır ve standart mesajlaşma penceresi içinde yanıtlar.
İzinler Facebook Login for Business üzerinden istenir ve business_management, pages_messaging için bir bağımlılıktır. Yalnızca kendi Sayfanız için mesaj gönderip alıyorsanız App Review gerekmez; başka işletmelerin Sayfalarına hizmet vermek içinse gerekir. Yanıtların çoğu, kişinin son mesajından itibaren 24 saat içinde gönderilmelidir; HUMAN_AGENT mesaj etiketi, App Review sonrasında manuel yanıtlar için bu süreyi 7 güne uzatır. Bu Graph API adımlarının hiçbiri kişisel bir profili hedefleyemez; resmi API üzerine kurulu araçların yalnızca Sayfaları bağlamasının nedeni budur. Bu kurulumun maliyeti, Facebook Messenger API fiyatlandırması rehberimizde ayrıntılı olarak anlatılıyor.
Kaynaklar: Meta'nın Messenger Platform genel bakışı ve Send API referansı. Son doğrulama: Kasım 2026.
Meta, eski Facebook Chat API'yi (XMPP, chat.facebook.com) 2015'te, Graph API v1.0'ın ve xmpp_login izninin sona ermesiyle birlikte kapattı. Kişisel bir Facebook gelen kutusu için resmi bir API yoktur: işletme mesajlaşmasında onun yerini alan Messenger Platform yalnızca Sayfalar adına çalışır. O tarihten bu yana npm'de yayımlanan resmi olmayan kütüphaneler, kullanıcının kendi oturumuyla messenger.com'a giriş yapar. Bunlar Meta tarafından desteklenmez ve orijinal açık kaynak proje bakım modunda olduğunu belirtir.
Yönettiğiniz bir Sayfadan mesaj göndermek için Messenger Platform'u kullanın ve API ile bir Messenger mesajı gönderin. Kullanıcının kendi hesabı için bakımı yapılan bir API kullanın: kullanıcı Hosted Auth üzerinden bağlanır, böylece uygulamanız şifresini hiç işlemez; siz de bir account_id, webhook'lar ve bir destek ekibi edinirsiniz (bkz. kişisel bir hesap nasıl bağlanır). Meta'nın Koşulları bu hesap için geçerli olmaya devam eder.
Hesabı sahibi kendisi bağlar. Uygulamanız bir Unipile Hosted Auth sayfası (veya Custom Auth ile kendi ekranınızı) açar, kullanıcı Facebook'ta oturum açıp iki faktörlü kimlik doğrulamayı onaylar ve uygulamanız API'yi çağırmak için bir account_id alır.
Kullanıcı "Facebook'u bağla" düğmesine tıklar ve Hosted Auth sayfasına gelir.
Kullanıcı adı, e-posta veya telefon ile şifre, tarayıcı çerezleri ya da UniLogin eklentisi; ardından SMS, kimlik doğrulama uygulaması, WhatsApp, uygulama içi onay veya tek kullanımlık kodla 2FA.
Bağlı hesap dashboard'unuzda görünür ve her çağrı onun account_id değerini kullanır.
Bu akışta Meta OAuth ekranı ve QR kod yoktur; sizin tarafınızda Meta uygulaması oluşturmanız veya App Review sürecinden geçmeniz gerekmez. Sağlayıcıya göre yöntemler sağlayıcı özellikleri tablosunda listelenir; ürüne genel bakış ise Facebook Messenger API sayfasında yer alır.
Her kullanıcı kendi hesabını bağlar
Unipile bir Meta ürünü değildir. Meta Partner değildir ve Meta tarafından onaylanmaz. Her kullanıcı kendi hesabını bağlar, Unipile kimliği doğrulanmış bu kullanıcı adına hareket eder ve kullanıcı Meta'nın Koşullarına bağlı kalır.
Pratikte bir Facebook Messenger API kişisel hesap entegrasyonu, kullanıcının kendi Messenger inbox'ını Unipile API üzerinden sunar: sohbetler, mesajlar, ekler, tepkiler ve okundu bilgileri, ayrıca gerçek zamanlı webhook'lar. Aşağıda resmi Sayfa modeliyle karşılaştırılıyor.
| Konu | Messenger Platform ile Sayfa | Unipile ile kişisel hesap |
|---|---|---|
| Hesap | Bir Facebook Sayfası veya Instagram profesyonel hesabı | Kullanıcının kendi kişisel Facebook hesabı |
| Kim bağlar | Bir Sayfa yöneticisi, Facebook Login for Business üzerinden | Hesap sahibi, Hosted Auth veya Custom Auth üzerinden |
| Uygulamanızda tutulan | Bir Page access token | Unipile API anahtarınız ve kullanıcının account_id |
| Meta uygulaması ve App Review | Bir Meta uygulaması, ayrıca sahibi olmadığınız Sayfalar için App Review | Sizin tarafınızda Meta uygulaması da App Review da yok |
| İlk kim yazar | Kişi Sayfaya mesaj atar | Kullanıcı yanıt verebilir veya yeni bir konuşma başlatabilir |
| Gerçek zamanlı olaylar | Meta uygulamanızdaki Messenger webhook'ları | Yeni, düzenlenmiş ve silinmiş mesajlar, okundu ve iletildi bilgileri, tepkiler, sohbet güncellemeleri |
account_idAynı bağlı hesap gönderilerini, yorumlarını ve tepkilerini de sunar. Bu endpoint'lerin özeti Facebook API rehberinde yer alır.
Temel döngü için iki çağrı yeterlidir: bağlı hesabın sohbetlerini listeleyin, ardından bunlardan birinde mesaj gönderin. İstekler, API anahtarınız X-API-KEY başlığında olacak şekilde https://api.unipile.com adresine gönderilir.
# 1. List the chats of the connected personal account
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 2. Send a message in one of those chats
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": "Thursday 10am works for me." }'
const base = "https://api.unipile.com/v2/{ACCOUNT_ID}";
const headers = { "X-API-KEY": process.env.UNIPILE_API_KEY };
// 1. List the chats of the connected personal account
const chats = await (await fetch(`${base}/chats`, { headers })).json();
// 2. Send a message in one of those chats
await fetch(`${base}/chats/{CHAT_ID}/messages/send`, {
method: "POST",
headers: { ...headers, "content-type": "application/json" },
body: JSON.stringify({ text: "Thursday 10am works for me." }),
});
import os, requests
base = "https://api.unipile.com/v2/{ACCOUNT_ID}"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. List the chats of the connected personal account
chats = requests.get(f"{base}/chats", headers=headers).json()
# 2. Send a message in one of those chats
requests.post(
f"{base}/chats/{{CHAT_ID}}/messages/send",
headers=headers,
json={"text": "Thursday 10am works for me."},
)
Gelen mesajlar webhook'unuza message.new olayları olarak ulaşır, bu yüzden polling yapmanız gerekmez. Node.js SDK aynı çağrıları getChatsList ve sendMessage olarak sunar. Kurulumun tamamı Facebook quickstart rehberinde. Diğer diller, ekler ve Sayfa yanıtları için Facebook Messenger API ile mesaj gönderme rehberine bakın.
Bağlı bir kişisel hesap, bir profesyonelin kendi hesabından kendi kişileriyle konuştuğu ürünlere uygundur: CRM'ler, helpdesk'ler, kullanıcının onayladığı yanıt taslaklarını hazırlayan yapay zeka asistanları ve danışman araçları. Soğuk outreach veya tamamen otomatik botlar için tasarlanmamıştır.
Bir satış temsilcisi Messenger konuşmalarını, e-postaların ve aramaların yanında, doğru kişi kaydında bulur. CRM entegrasyonunu görün.
Messenger; LinkedIn, WhatsApp, Instagram ve Telegram ile aynı inbox'ta, tek bir veri modeliyle yer alır.
Bir ajan konuşma geçmişinden bir yanıt taslağı hazırlar, kullanıcı da gönderilmeden önce onu inceler.
Bir danışman veya temsilci, Messenger'da zaten konuştuğu müşterileri takip eder.
Bağlı bir hesap Meta'nın Hizmet Koşullarına bağlı kalır. Kullanıcının zaten yapacağı konuşmalar için geliştirin: istenmeyen mesajlar ve yetkisiz otomasyon, Meta'nın hesabı kısıtlamasına yol açabilir.
Ağlar arasında tek bir inbox mı geliştiriyorsunuz? Bir birleşik mesajlaşma API'sinin nasıl çalıştığını görün.
Meta'nın Graph API'si üzerinden bir Facebook API kişisel hesap entegrasyonu oldukça dardır. Kişiyi tanımlayabilir ve birkaç profil alanını okuyabilir, ancak Messenger gelen kutusunu açamaz veya onun adına yayın yapamaz.
Kimlik hâlâ çalışıyor. Facebook Login ile kişi uygulamanıza bir user access token verir. public_profile izni varsayılan herkese açık profil alanlarını, email ise birincil e-posta adresini okur. Kullanıcının zaman akışında paylaştığı gönderiler için user_posts gibi diğer kullanıcı izinleri, Meta tarafından kısa bir onaylı kullanım listesiyle sınırlandırılmıştır. Hiçbir kullanıcı izni kişinin Messenger konuşmalarına erişim sağlamaz. Bu token'ların nasıl verildiği Facebook API access token rehberimizde anlatılıyor.
Profilde yayın yapmak 2018'de sona erdi. Meta, publish_actions iznini 24 Nisan 2018'de kaldırdı; bu izin için zaten onaylanmış uygulamalar onu 1 Ağustos 2018'e kadar kullanmaya devam edebildi. O tarihten beri Graph API üzerine kurulu uygulamalar yalnızca Sayfalarda yayın yapıyor; planlama araçlarının kişisel profilleri sunmayı bırakmasının nedeni de bu.
Bağlı bir hesap her iki tarafı da kapsar. Hesap sahibi kişisel hesabını Unipile üzerinden bağladığında uygulamanız Messenger mesajlarını okur ve gönderir; gönderilerini, yorumlarını ve tepkilerini oluşturur, düzenler ve siler. Yayın tarafı Facebook gönderi API rehberimizde ayrıntılı olarak anlatılıyor.
| İşlem | User access token ile Graph API | Unipile ile bağlanan kişisel hesap |
|---|---|---|
| Kullanıcının Messenger mesajlarını okuma | Hayır, gelen kutusunu kapsayan bir kullanıcı izni yok | Evet, sohbetler, mesajlar ve ekler |
| Kullanıcının profilinde yayın yapma | Hayır, publish_actions 2018'de kaldırıldı | Evet, gönderi oluşturma, düzenleme ve silme |
| Mesajlara yanıt verme | Hayır, Messenger Platform Sayfalara hizmet verir | Evet, yanıt verme veya konuşma başlatma |
publish_actions 2018'de kaldırıldıKaynaklar: Meta'nın izinler referansı ve 24 Nisan 2018 tarihli Graph API changelog'u. Son doğrulama: 17 Kasım 2026.
Kişisel Facebook hesaplarını ürününüze bağlayın
Meta'nın Messenger Platform'u, kendi Sayfasında kişilere yanıt veren bir işletme için doğru araç olmaya devam ediyor. Ürününüz kişisel hesaplar dahil bir Facebook Messenger API'ye ihtiyaç duyduğunda, kullanıcılarınızın kendi Facebook hesaplarını bağlamasına izin verin ve Facebook ile diğer kanallarınız için tek bir API kullanın.
Her kullanıcı kendi hesabını bağlar, profil depolama yok. Unipile bir Meta İş Ortağı değildir. Digital Markets Act sayfamızı okuyun
Tüm Facebook API endpoint'leri tek bir yerde
Mesajlar resmin yalnızca bir parçası. Sohbetlerden gönderilere kadar Unipile ile kullanılabilen tüm Facebook endpoint'lerine göz atın veya Meta'nın resmi API'lerini bağlı hesaplarla karşılaştırmak için eksiksiz Facebook API rehberimizi okuyun.
Profiller, mesaj geçmişi, ilk mesajlar, tepkiler, Sayfalar, chatbot'lar, Graph API ve resmi olmayan kütüphaneler hakkında hızlı yanıtlar.
Meta'nın Messenger Platform'u çalışmaz: Facebook Sayfalarına ve Instagram profesyonel hesaplarına hizmet eder. Kişisel bir profil, sahibi onu Unipile'ın barındırılan kimlik doğrulaması üzerinden uygulamanıza bağladığında kullanılabilir ve sahibi Meta'nın Koşullarına bağlı kalır.
Evet, hesap bağlandıktan sonra. API, grup konuşmaları ve ekler dahil bağlı kişisel hesabın sohbetlerini ve mesajlarını listeler; webhook'lar da yeni, düzenlenmiş ve silinmiş mesajları uygulamanıza iletir.
Evet. Bağlı bir kişisel hesap yanıt vermenin yanı sıra yeni bir konuşma da başlatabilir. Bunu kullanıcının tanıdığı veya birlikte çalıştığı kişilerle sınırlı tutun: istenmeyen mesajlar Meta'nın Koşullarına aykırıdır ve hesabın kısıtlanmasına yol açabilir.
Evet. Mesajlardaki tepkileri listeleyebilir, ekleyebilir ve kaldırabilirsiniz; yeni tepkiler uygulamanıza message.reaction.new webhook olayıyla ulaşır.
Evet, bağlı kullanıcının yönettiği Sayfalar için. Uygulamanız Sayfanın mesajlarını okuyup yanıtlayabilir ve Sayfa adına yayın yapabilir. Bir Sayfa konuşma başlatamaz veya mesajlarını silemez; bu nedenle Sayfa konuşmaları her zaman önce kişinin yazmasıyla başlar.
Meta'nın Messenger Platform'u ve ona dayanan chatbot oluşturucular yalnızca Sayfalarla çalışır. Bağlı bir kişisel hesapta süreçte mutlaka bir insan bulunsun: yapay zeka bir yanıt taslağı hazırlar, kullanıcı onaylar. Tamamen otomatik veya istenmeyen mesajlaşma hesabın kısıtlanmasına yol açabilir.
Kısmen. Meta'nın Graph API'si Facebook Login ve birkaç okuma izni için kişisel bir profili hâlâ kabul eder, ancak kişinin Messenger gelen kutusunu açamaz ve publish_actions 2018'de kaldırıldığından beri profillerde yayın yapmaz. Mesajları ve gönderileri kapsayan bir Facebook API kişisel hesap kurulumu için hesap sahibi hesabını Unipile üzerinden bağlar ve uygulamanız tek bir REST API ile çalışır.
Evet. Kullanıcının kendi oturumuyla messenger.com'a giriş yapan açık kaynak kütüphaneler mevcuttur, ancak bunlar resmi değildir ve Meta tarafından desteklenmez. Facebook arayüzünü değiştirdiğinde çalışmayı bırakabilirler ve bunları kullanan hesap Meta'nın Koşulları kapsamında kısıtlanabilir. Üretimdeki bir uygulama için yönettiğiniz Sayfalarda Messenger Platform'u ya da kullanıcının kendi hesabını bağladığı ve Meta'nın Koşullarına bağlı kaldığı, bakımı yapılan bir API'yi kullanın.
Facebook Messenger entegrasyonları üzerinden gönderemez: bu entegrasyonlar yalnızca Sayfalara hizmet veren Meta'nın Messenger Platform'una dayanır. Unipile üzerinden bağlanmış kişisel bir hesapla mesaj kendi iş akışınızdan gönderilir; örneğin bu hesap için mesaj gönderme endpoint'ini çağıran bir HTTP adımıyla.
Hayır. Unipile bağımsız bir şirkettir: Meta Partner değildir ve Meta tarafından desteklenmez, sponsorluğu yapılmaz veya onaylanmaz. Kişisel bir Messenger hesabını Unipile üzerinden bağlamak resmi bir Messenger Platform entegrasyonu değildir. Facebook ve Messenger, Meta Platforms, Inc.'in ticari markalarıdır.
Hayır. Hesap sahibi Unipile'ın hosted authentication akışı üzerinden giriş yapar; böylece sizin tarafınızda bir Meta uygulaması kaydetmeniz, pages_messaging izni istemeniz veya App Review sürecinden geçmeniz gerekmez. Aynı durum bu kullanıcının yönettiği Sayfalar için de geçerlidir.
Unipile, Digital Markets Act'in ruhuna uygun olarak tasarlanmıştır. Her kişi kendi Facebook hesabını bağlar, mesajlar onun adına okunur ve gönderilir ve Unipile kullanıcı profillerini saklamaz. Ayrıntılar Digital Markets Act sayfamızda.
Evet. Bağlı bir kişisel hesap, Meta'nın Koşullarına tabi bir Facebook hesabı olmaya devam eder. Müşterilere yanıt vermek, konuşmaları bir CRM ile senkronize etmek veya bir kullanıcının kendi gelen kutusunu yönetmesine yardımcı olmak gibi meşru kullanımlarla sınırlı kalın; toplu veya istenmeyen mesajlaşma hesabı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