TR
CRM entegrasyon rehberi

Facebook Messenger CRM Entegrasyonu: Ürününüze Nasıl Eklenir?

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.

CRM'iniz · Messenger Senkronize
Leo MartinKeten ceketi Lyon'a gönderiyor musunuz?Eşleşti · AdayCoveton Apparel
Sara KimTeşekkürler Anna, yarın imzalıyorum.Eşleşti · FırsatKişisel
Omar HaddadSiz: Siparişiniz depodan çıktı.Eşleşti · MüşteriCoveton Apparel
Webhook'lar message.new message.receipt.read
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
Kısa cevap

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

Unipile ile üç adımda kurun

  1. 1

    Her kullanıcının Facebook hesabını ve Sayfalarını Hosted Auth üzerinden bağlayın. Meta uygulaması yok, App Review yok.

  2. 2

    X-API-KEY header'ınızı göndererek GET /v2/{account_id}/chats ile sohbet geçmişlerini içe aktarın.

  3. 3

    Yeni mesajları, düzenlemeleri ve tepkileri message.new ile başlayarak webhook üzerinden alın.

Tanım

Facebook Messenger CRM Entegrasyonu Nedir?

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.

CRM'iniz · Kişi Canlı
Leo MartinAday · Lyon
SorumluAnna Rossi
KanalMessenger · Coveton Apparel sayfası
Facebook ID{FACEBOOK_USER_ID}
EtkinlikE-postaMessenger 2Fırsatlar
FacebookSayfa gelen kutusuCoveton Apparel
Merhaba, keten ceketi Lyon'a gönderiyor musunuz?10:40
Evet, teslimat 3 gün sürüyor. Hangi bedene ihtiyacınız var?Coveton Apparel · 10:41
01

Okuma

Geçmiş ve yeni mesajlar, kullanıcı başına.

02

Bağlama

Her sohbet tek bir kişiye.

03

Yanıtlama

Kayıttan, kullanıcı veya Sayfa olarak.

04

Canlı kalma

Polling değil, webhook'lar.

Yaklaşımlar

Facebook Messenger Bir CRM'e Nasıl Bağlanır: Üç Yol

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.

SoruNo-code bağlayıcıMeta Messenger PlatformKullanıcı başına bağlantı (Unipile)
HesaplarGenellikle 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 birMeta webhook'larımessage.new gibi webhook'lar
Sizin yönettiğinizKurulum başına bir iş akışıMeta uygulaması, App Review, Sayfa başına bir tokenBir Hosted Auth bağlantısı, kullanıcı başına bir account_id
GeçmişBağlayıcıya göre değişirSayfa sohbetleriKişisel sohbetler ve her Sayfa gelen kutusu
Diğer kanallarHer biri için ayrı bağlayıcıMeta ürünü başına bir entegrasyonLinkedIn, WhatsApp, Instagram ve e-posta için aynı API
Hesaplar
No-codeGenellikle tek bir Facebook Sayfası
MetaYalnızca Facebook Sayfaları
UnipileKişisel hesaplar ve yönettikleri Sayfalar
Yön
No-codeÇoğunlukla tek yönlü: mesajdan adaya
MetaÇift yönlü, 24 saatlik pencere içinde
UnipileÇift yönlü senkronizasyon: okuma, yanıt, tepki
Gerçek zamanlılık
No-codeÇoğunlukla polling, bazı planlarda 15 dakikada bir
MetaMeta webhook'ları
Unipilemessage.new gibi webhook'lar
Sizin yönettiğiniz
No-codeKurulum başına bir iş akışı
MetaMeta uygulaması, App Review, Sayfa başına bir token
UnipileBir Hosted Auth bağlantısı, kullanıcı başına bir account_id
Geçmiş
No-codeBağlayıcıya göre değişir
MetaSayfa sohbetleri
UnipileKişisel sohbetler ve her Sayfa gelen kutusu
Diğer kanallar
No-codeHer biri için ayrı bağlayıcı
MetaMeta ürünü başına bir entegrasyon
UnipileLinkedIn, WhatsApp, Instagram ve e-posta için aynı API

Zapier 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.

Bağlantı

Her Kullanıcının Facebook Hesabını ve Sayfalarını Bağlayın

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.

1

Hosted Auth bağlantısını açın

Backend'iniz bağlantıyı ister, kullanıcı açar.

Hosted Auth
2

Giriş yapın ve geçmişin kilidini açın

Kimlik bilgileri, 2FA, ardından isteğe bağlı geçmiş kilidi açma.

ENCRYPTED_HISTORY
3

account_id'yi saklayın

CRM 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.

Senkronizasyon

Sohbet Geçmişini ve Yeni Mesajları Gerçek Zamanlı Senkronize Edin

Ö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.

FacebookKaynakKişisel hesap + SayfalarCRM kullanıcısı başına bir
BağlantıUnipileTek bir account_id
Gelen veriGeçmiş aktarımı, ardından webhook'larBir kez GET /chats, sonra message.new
KodunuzSenkronizasyon servisiYönlendirir, eşleştirir, tekilleştirir
VerilerinizCRM veritabanıKişiler ve mesajlar

Kişisel sohbetlerin ve Sayfa gelen kutularının geçmişini aktarın

Hesabı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.

Temel URL https://api.unipile.com · header X-API-KEY
GET/v2/{account_id}/chatsBağlı hesabın kişisel sohbetleri
GET/v2/{account_id}/inboxes/{inbox_id}/chatsBir Sayfa gelen kutusunun sohbetleri
GET/v2/{account_id}/chats/{chat_id}/messagesBir sohbetin mesajları, en yeniden başlayarak

Şifreli sohbetler ve geçmiş

Kiş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.

Webhook'lar

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:

message.new message.update message.delete message.receipt.read message.receipt.delivery message.reaction.new chat.update chat.delete

Kaynaklar: Unipile sohbetleri ve mesajları alma, şifreli sohbetler, sağlayıcı özellikleri ve webhook yapılandırma. Son doğrulama: 17 Kasım 2026.

Deneyin

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.

Hemen başlayın
Veri modeli

Messenger Sohbetlerini CRM Kişileriyle Eşleştirin

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 kaydedilirDikkat
Karşı tarafın Facebook ID'siKişiye: eşleştirme anahtarınızAsla görünen ada göre eşleştirmeyin
account_idFacebook'u bağlayan CRM kullanıcısınaKişisel hesabı ve Sayfaları kapsar
Kişisel sohbet ID'siSohbeteKiş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'siSayfa ID'si, gelen kutusuna ve durumaSayfa yazarları profil ID'sini kullanır: ikisini asla karşılaştırmayın
Karşı tarafın Facebook ID'si
Nereye kaydedilirKişiye: eşleştirme anahtarınız
DikkatAsla görünen ada göre eşleştirmeyin
account_id
Nereye kaydedilirFacebook'u bağlayan CRM kullanıcısına
DikkatKişisel hesabı ve Sayfaları kapsar
Kişisel sohbet ID'si
Nereye kaydedilirSohbete
Sayfa sohbet ID'si
Nereye kaydedilirSohbete ve Sayfasına (PAGE_<page_id>_<thread_key>)
DikkatÖnek, Unipile'ın Sayfa adına hareket etmesini sağlar
Sayfa ID'si ve Sayfa profil ID'si
Nereye kaydedilirSayfa ID'si, gelen kutusuna ve duruma
DikkatSayfa yazarları profil ID'sini kullanır: ikisini asla karşılaştırmayın

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.

Kişi kaydına yazan bir message.new handler'ı

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
200 OK · Facebook ID başına bir kişi, mesaj ID'si başına bir satır
200 OK · Facebook ID başına bir kişi, mesaj ID'si başına bir satır

Sohbet ID biçimleri Facebook Pages dokümantasyonundan, sohbet aramaları sohbetleri ve mesajları alma sayfasından alınmıştır.

Yanıt

Kişi Kaydından Kullanıcı veya Sayfa Olarak Yanıt Verin

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.

CRM'iniz · Leo Martin Sayfa sohbeti
M beden lütfen. Cumaya kadar gelir mi?10:42
Evet, bugün saat 14:00'ten önce sipariş verirseniz.Coveton Apparel · 10:44
Harika, hemen sipariş veriyorum.10:46
Şu olarak yanıtlaAnna RossiFacebookCoveton Apparel sayfası
Teşekkürler Leo, siparişiniz onaylandı. Kargo takip bağlantısı birazdan gelecek.
Yeni sohbetGönder

Bir Sayfa yalnızca kendisine yazan kişilere yanıt verir.

POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Sayfa sohbetinden
  • Yanıtlar Sayfa adına gider
  • Yeni sohbet başlatılamaz: 501 api/not_implemented
  • Mesajları silinemez: aynı hata
Kişisel sohbetten
  • Yanıtlar kullanıcının hesabından gider
  • Facebook izin verdiğinde sohbet başlatılabilir

Bir 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.

İşletim

Her Müşteri İçin Çalıştırın: Durum, İzinler ve Meta'nın Kuralları

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.

Yönetici · Bağlı hesaplar Kısmi
BağlantıDurum
FacebookAnna RossiMesajlaşma · kişisel hesaprunning
Coveton Apparel sayfasıpage_<page_id>running
Coveton Outlet sayfasıYönetici rolü kaldırıldıdisconnectedYeniden bağlan
STATUS 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.

Kimin hangi sohbetleri göreceğine karar verin

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.

Uyumluluk

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.

Meta uygulaması veya App Review?Gerekmez: kullanıcılar Hosted Auth ile bağlanır.
Resmi Meta iş ortağı mı?Hayır. Unipile ne resmi bir Meta uygulaması ne de bir Meta İş Ortağıdır.
Meta'nın koşulları?Her kullanıcı bu koşullara bağlı kalır.
Digital Markets Act?Profil depolama yok. Digital Markets Act sayfamıza bakın.

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.

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. 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.

Facebook Messenger CRM Entegrasyonu SSS

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