
Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
CRM veya SaaS geliştiren ekipler için: her kullanıcının Facebook hesabını ve Sayfalarını bağlayın, sohbetleri senkronize edin, kişileri eşleştirin, kayıttan yanıt verin.
api.unipile.com/v2/{ACCOUNT_ID}/chats
200 OK
Facebook Messenger CRM entegrasyonu, her kullanıcının Messenger sohbetlerini CRM'deki kişi kayıtlarına senkronize eder ve kullanıcıların CRM'den yanıt vermesini sağlar. Bu rehber, bu entegrasyonu kendi CRM veya SaaS ürününe ekleyen ekipler içindir; CRM seçen işletmeler için değildir.
Dört yapı taşı gerekir: kullanıcı başına bir bağlantı, geçmiş ve gerçek zamanlı senkronizasyon, kişi eşleştirme ve doğru kimlikle yanıt.
Unipile ile üç adımda kurun
Her kullanıcının Facebook hesabını ve Sayfalarını Hosted Auth üzerinden bağlayın. Meta uygulaması yok, App Review yok.
X-API-KEY header'ınızı göndererek GET /v2/{account_id}/chats ile sohbet geçmişlerini içe aktarın.
Yeni mesajları, düzenlemeleri ve tepkileri message.new ile başlayarak webhook üzerinden alın.
Facebook Messenger CRM entegrasyonu, Messenger sohbetlerini bir CRM'e bağlar: her mesaj doğru kişi kaydına düşer ve kullanıcılar CRM'den çıkmadan yanıt verir. Bir işletme için bu, etkinleştirdiği hazır bir bağlayıcıdır. Bir ürün ekibi için ise kendi CRM veya SaaS ürününe eklediği bir özelliktir: bu rehber ikinci durumu ele alır.
Her iki durumda da amaç aynı: okumak, bir kişiye bağlamak ve CRM'den yanıt vermek; gerçek zamanlı ve kullanıcı başına. Facebook API'lerinin birbirine nasıl bağlandığını anlatan genel bakışımız Meta'nın platformlarını ele alıyor.
{FACEBOOK_USER_ID}Geçmiş ve yeni mesajlar, kullanıcı başına.
Her sohbet tek bir kişiye.
Kayıttan, kullanıcı veya Sayfa olarak.
Polling değil, webhook'lar.
No-code bir bağlayıcı hızlıdır ama çoğunlukla tek yönlüdür. Meta'nın Messenger Platform'u çift yönlüdür ancak yalnızca Sayfalar içindir ve App Review gerektirir. Kullanıcı başına bağlantı sunan bir API ise Meta uygulaması olmadan kişisel hesapları ve Sayfaları kapsar.
| Soru | No-code bağlayıcı | Meta Messenger Platform | Kullanıcı başına bağlantı (Unipile) |
|---|---|---|---|
| Hesaplar | Genellikle tek bir Facebook Sayfası | Yalnızca Facebook Sayfaları (işletme Sayfaları) | Kişisel hesaplar ve yönettikleri Sayfalar |
| Yön | Çoğunlukla tek yönlü: mesajdan adaya | Çift yönlü, 24 saatlik pencere içinde | Çift yönlü senkronizasyon: okuma, yanıt, tepki |
| Gerçek zamanlılık | Çoğunlukla polling, bazı planlarda 15 dakikada bir | Meta webhook'ları | message.new gibi webhook'lar |
| Sizin yönettiğiniz | Kurulum başına bir iş akışı | Meta uygulaması, App Review, Sayfa başına bir token | Bir Hosted Auth bağlantısı, kullanıcı başına bir account_id |
| Geçmiş | Bağlayıcıya göre değişir | Sayfa sohbetleri | Kişisel sohbetler ve her Sayfa gelen kutusu |
| Diğer kanallar | Her biri için ayrı bağlayıcı | Meta ürünü başına bir entegrasyon | LinkedIn, WhatsApp, Instagram ve e-posta için aynı API |
message.new gibi webhook'laraccount_idZapier veya Make tek bir işletme ve tek bir Sayfa için uygundur; Meta Business Suite de o işletmeye kendi Sayfası için bir gelen kutusu sunar. Birden çok müşteriye hizmet veren bir ürünün ise entegrasyonu kendi kodunda barındırması gerekir.
Meta'nın yolunda her müşteri Sayfası, bir Page access token ve Meta tarafından incelenmiş izinler gerektirir; bunu Facebook Page API rehberimizde gösteriyoruz. Yanıtlar 24 saatlik pencereye ve mesaj etiketlerine tabidir; bu etiketlerin birçoğunu Meta 2026'da kaldırdı. Üstelik bu yol, satış temsilcilerinin ve danışmanların müşterileriyle kullandığı kişisel hesaplara asla ulaşamaz.
Kaynaklar: Meta'nın Messenger Platform ile mesaj gönderme sayfası, Unipile'ın sağlayıcı özellikleri. Son doğrulama: 17 Kasım 2026.
Her CRM kullanıcısı bir Hosted Auth bağlantısı açar ve iki faktörlü kimlik doğrulama dahil Facebook'a giriş yapar. CRM'iniz, kullanıcının kişisel hesabını ve yönettiği tüm Sayfaları kapsayan tek bir account_id alır; Sayfaların tamamı varsayılan olarak etkindir.
Backend'iniz bağlantıyı ister, kullanıcı açar.
Hosted AuthKimlik bilgileri, 2FA, ardından isteğe bağlı geçmiş kilidi açma.
ENCRYPTED_HISTORYCRM kullanıcısına kaydedin. Sayfaları da onunla gelir.
{ACCOUNT_ID}Sayfalar, bağlantı veya yeniden bağlanma sırasında page ürünüyle etkinleştirilir; etkinleştirilmemiş bir Sayfa 403 api/insufficient_permissions döndürür. Giriş adımlarını kişisel hesaplar için Facebook Messenger API rehberimizde ayrıntılı olarak anlatıyoruz.
Kaynak: Unipile Facebook Pages dokümantasyonu. Son doğrulama: 17 Kasım 2026.
Önce API üzerinden geçmişi aktarın: kişisel sohbetler, ardından her Sayfa gelen kutusu. Sonra webhook'lara geçin; böylece her yeni mesaj, düzenleme, okundu bilgisi veya tepki, Facebook Messenger API sayfamızda listelendiği gibi CRM'inize gerçek zamanlı ulaşır.
account_idGET /chats, sonra message.newHesabın sohbet listesi yalnızca kişisel sohbetleri içerir; her Sayfanın kendi gelen kutusu vardır: PAGE_<page_id>_INBOX. Listeler sayfa başına en fazla 100 öğe döndürür ve en yeni mesajlar önce gelir: CRM'inizin ihtiyacı kadar geriye doğru sayfalayın.
https://api.unipile.com · header X-API-KEYKişisel bire bir ve grup sohbetleri uçtan uca şifrelidir; Sayfa sohbetleri değildir. Geçmiş kişisel mesajlar, kullanıcının kurtarma kodu veya Messenger PIN'i ile açtığı şifreli bir yedekte durur; Hosted Auth bu adımı bağlantı sırasında gösterir. Bu adım olmadan yalnızca bağlantıdan sonraki mesajlara erişilebilir.
Tek bir webhook URL'si tüm bağlı hesaplara hizmet eder. Sayfa olayları Sayfaya özgü sohbet ID'sini taşır; bu yüzden onları PAGE_<page_id>_ önekine göre yönlendirin. Facebook için kullanılabilen olaylar:
Kaynaklar: Unipile sohbetleri ve mesajları alma, şifreli sohbetler, sağlayıcı özellikleri ve webhook yapılandırma. Son doğrulama: 17 Kasım 2026.
Bir Facebook hesabı bağlayın, deneme çalışma alanınızda
Bir hesap bağlayın, sohbetlerini listeleyin ve bir webhook'u servisinize yönlendirin. 7 günlük ücretsiz deneme, kredi kartı gerekmez.
Her sohbeti bir kişiye, görünen ad üzerinden değil, karşı tarafın Facebook ID'si üzerinden bağlayın. Sayfa ve kişisel sohbetleri, sohbet ID'sinin PAGE_<page_id>_ önekine göre yönlendirin.
| Tanımlayıcı | Nereye kaydedilir | Dikkat |
|---|---|---|
| Karşı tarafın Facebook ID'si | Kişiye: eşleştirme anahtarınız | Asla görünen ada göre eşleştirmeyin |
account_id | Facebook'u bağlayan CRM kullanıcısına | Kişisel hesabı ve Sayfaları kapsar |
| Kişisel sohbet ID'si | Sohbete | Kişi anahtarı değildir |
Sayfa sohbet ID'si PAGE_<page_id>_<thread_key> | Sohbete ve Sayfasına | Önek, Unipile'ın Sayfa adına hareket etmesini sağlar |
| Sayfa ID'si ve Sayfa profil ID'si | Sayfa ID'si, gelen kutusuna ve duruma | Sayfa yazarları profil ID'sini kullanır: ikisini asla karşılaştırmayın |
PAGE_<page_id>_<thread_key>)Bir tuzak: aynı sohbet için API'nin döndürdüğü sohbet ID'si, bir webhook olayındakinden farklı olabilir. İkisini de sohbete kaydedin ve kişinin Facebook ID'sini dayanak alarak CRM tarafında uzlaştırın. "Find Chats by User", bir kişinin mevcut sohbetlerini ya da boş bir liste döndürür.
readUnipileEvent, payload eşlemenizi temsil eder.
// One URL for every connected account
app.post("/webhooks/unipile", express.json(), async (req, res) => {
res.sendStatus(200); // acknowledge first, process after
// Your mapping of the payload documented in the webhook reference
const evt = readUnipileEvent(req.body);
if (evt.type !== "message.new") return;
// 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
const page = evt.chatId.match(/^PAGE_([^_]+)_/);
const inbox = page ? { kind: "page", pageId: page[1] } : { kind: "personal" };
// 2. Owner: the CRM user who connected this account_id
const owner = await crm.users.findByAccountId(evt.accountId);
// 3. Contact: the other person's Facebook ID, never the name
const contact =
(await crm.contacts.findByFacebookId(owner.tenantId, evt.counterpartId)) ??
(await crm.contacts.createForReview({ facebookId: evt.counterpartId, owner }));
// 4. Keep the webhook chat ID next to the one from the backfill
await crm.conversations.addChatId(contact.id, inbox, evt.chatId, "webhook");
// 5. Write the message once, keyed by its message ID
await crm.messages.upsert({
contactId: contact.id, inbox, messageId: evt.messageId,
direction: evt.fromOwner ? "out" : "in", text: evt.text,
});
});
import re
from flask import request
PAGE_PREFIX = re.compile(r"^PAGE_([^_]+)_")
# One URL for every connected account
@app.post("/webhooks/unipile")
def unipile_webhook():
# Your mapping of the payload documented in the webhook reference
evt = read_unipile_event(request.get_json())
if evt.type != "message.new":
return "", 200
# 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
page = PAGE_PREFIX.match(evt.chat_id)
inbox = {"kind": "page", "page_id": page.group(1)} if page else {"kind": "personal"}
# 2. Owner: the CRM user who connected this account_id
owner = crm.users.find_by_account_id(evt.account_id)
# 3. Contact: the other person's Facebook ID, never the name
contact = crm.contacts.find_by_facebook_id(owner.tenant_id, evt.counterpart_id) \
or crm.contacts.create_for_review(facebook_id=evt.counterpart_id, owner=owner)
# 4. Keep the webhook chat ID next to the one from the backfill
crm.conversations.add_chat_id(contact.id, inbox, evt.chat_id, source="webhook")
# 5. Write the message once, keyed by its message ID
crm.messages.upsert(
contact_id=contact.id, inbox=inbox, message_id=evt.message_id,
direction="out" if evt.from_owner else "in", text=evt.text,
)
return "", 200
Sohbet ID biçimleri Facebook Pages dokümantasyonundan, sohbet aramaları sohbetleri ve mesajları alma sayfasından alınmıştır.
Yanıtı sohbetin chat ID'sine gönderin. Bir Sayfa sohbet ID'si Sayfa olarak yanıt verir; kişisel bir sohbet ID'si kullanıcının kendi hesabından gönderir. Yanıt alanı hangi kimliğin geçerli olduğunu gösterir.
Bir Sayfa yalnızca kendisine yazan kişilere yanıt verir.
/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
501 api/not_implementedBir Sayfa için "Yeni sohbet" düğmesini devre dışı bırakın. İstek gövdesi, ekler ve hatalar için API ile Messenger mesajı gönderme rehberimize bakın.
Her bağlantının durumunu gösterin. Her Sayfa kendi durumunu bildirir; böylece bozulan bir Sayfa, kişisel mesajları veya diğer Sayfaları durdurmaz.
metadata.products_connection_status
Sayfa başına
Her Sayfanın metadata.products_connection_status içinde page_<page_id> adlı kendi anahtarı vardır. Bir Sayfa devre dışı kaldığında hesap partial veya degraded durumuna geçer. Yönetici rolünü kaybetmiş bir Sayfa, yeniden bağlanana kadar disconnected kalır: bunu gösterin ve yeniden bağlanmayı önerin.
Kişisel sohbetleri sahibine ve seçilen yöneticilere, Sayfa sohbetlerini ise Sayfa ekibine, atama ve etiketlerin bulunduğu birleşik bir gelen kutusunda gösterin. Bu, LinkedIn, WhatsApp ve e-postayı kapsayan CRM yazılımları için mesajlaşma API'si ile aynı modeldir ve birleşik mesajlaşma API'sinin yeni bir bağlayıcı olmadan Messenger eklemenize izin vermesinin nedenidir.
Her kullanıcı kendi hesabını bağlar
CRM, destek, danışmanlar veya taslaklarını bir kişinin onayladığı bir AI agent için. Toplu gönderim yok.
Messenger entegrasyonunuzu geliştirmeye başlayın
Bir Facebook Messenger CRM entegrasyonu; kullanıcı başına bir bağlantı, önce geçmiş aktarımı sonra webhook'lar, Facebook ID'leri üzerinden eşleştirilen kişiler ve doğru kimlikle verilen yanıtlardan oluşur. Aynı kod LinkedIn, WhatsApp ve e-postaya da hizmet eder. 7 günlük ücretsiz deneme, kredi kartı gerekmez.
Her kullanıcı kendi hesabını bağlar, profil depolama yok. Unipile bir Meta İş Ortağı değildir. Unipile ve DMA
Tüm Facebook API endpoint'leri tek bir yerde
Messenger resmin yalnızca bir parçası. Gönderilerden ve yorumlardan profillere kadar Unipile ile kullanılabilen tüm Facebook endpoint'lerine göz atın veya eksiksiz Facebook API rehberimizle başlayın.
CRM mesajlaşması, otomatik yanıtlar ve birden fazla Sayfa.
Sohbetler artık tek bir kişinin telefonunda kalmasın diye. Her mesaj kişi kaydına düşer, ekip tüm geçmişi görür; takipler, atama ve raporlama Messenger'da da e-postadaki gibi çalışır.
Bir CRM'in içinden Messenger, WhatsApp, LinkedIn veya e-posta üzerinden mesaj gönderip almak; her sohbet bir kişiye bağlıdır. Facebook Messenger CRM entegrasyonu tek bir kanalı kapsar; birleşik mesajlaşma API'si diğer kanalları aynı veri modeliyle getirir.
Süreçte bir insan bulunsun: bir AI agent, kişinin geçmişinden bir yanıt taslağı hazırlar ve bir kullanıcı göndermeden önce onaylar. Kullanıcılar Meta'nın koşullarına bağlı kalır: istenmeyen veya toplu mesaj yok.
Evet. Kullanıcının yönettiği her Sayfa, aynı account_id üzerinde varsayılan olarak etkindir; her birinin kendi gelen kutusu (PAGE_<page_id>_INBOX) ve kendi durumu vardır. Her Sayfayı CRM'inizde ayrı bir gelen kutusu olarak gösterin.
Hâlâ sorularınız mı var? Ekibimiz yardıma hazır.
Bir uzmanla görüşün