PL
Przewodnik po integracji z CRM

Integracja Facebook Messenger z CRM: jak wbudować ją w swój produkt

Dla zespołów budujących CRM lub SaaS: połącz konto Facebook i Strony każdego użytkownika, synchronizuj rozmowy, przypisuj kontakty i odpowiadaj prosto z karty klienta.

Twój CRM · Messenger Zsynchronizowano
Leo MartinCzy wysyłacie lnianą kurtkę do Lyonu?Przypisano · LeadCoveton Apparel
Sara KimDzięki, Anno, podpiszę jutro.Przypisano · SzansaPrywatne
Omar HaddadTy: Twoje zamówienie opuściło magazyn.Przypisano · KlientCoveton Apparel
Webhooki message.new message.receipt.read
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
Krótka odpowiedź

Integracja Facebook Messenger z CRM synchronizuje rozmowy każdego użytkownika z Messengera z kartami kontaktów w CRM i pozwala odpowiadać bezpośrednio z CRM. Ten przewodnik jest dla zespołów, które wbudowują taką integrację we własny CRM lub produkt SaaS, a nie dla firm wybierających CRM.

Składa się z czterech elementów: jednego połączenia na użytkownika, historii z synchronizacją w czasie rzeczywistym, przypisywania kontaktów i odpowiedzi z właściwej tożsamości.

Z Unipile

Zbuduj to z Unipile w trzech krokach

  1. 1

    Połącz konto Facebook i Strony każdego użytkownika przez Hosted Auth. Bez aplikacji Meta i bez App Review.

  2. 2

    Zaimportuj historię jego czatów przez GET /v2/{account_id}/chats, z nagłówkiem X-API-KEY.

  3. 3

    Odbieraj nowe wiadomości, edycje i reakcje przez webhook, zaczynając od message.new.

Definicja

Czym jest integracja Facebook Messenger z CRM?

Integracja Facebook Messenger z CRM łączy rozmowy z Messengera z systemem CRM: każda wiadomość trafia na właściwą kartę kontaktu, a użytkownicy odpowiadają bez wychodzenia z CRM. Dla firmy to konektor, który po prostu włącza. Dla zespołu produktowego to funkcja, którą wbudowuje we własny CRM lub SaaS: ten przewodnik dotyczy właśnie tego przypadku.

W obu przypadkach chodzi o to samo: odczyt, przypisanie do kontaktu, odpowiedź z CRM, w czasie rzeczywistym i osobno dla każdego użytkownika. Platformy Meta omawia nasz przegląd tego, jak współgrają ze sobą API Facebooka.

Twój CRM · Kontakt Na żywo
Leo MartinLead · Lyon
OpiekunAnna Rossi
KanałMessenger · Strona Coveton Apparel
Facebook ID{FACEBOOK_USER_ID}
AktywnośćE-mailMessenger 2Szanse
FacebookSkrzynka StronyCoveton Apparel
Dzień dobry, czy wysyłacie lnianą kurtkę do Lyonu?10:40
Tak, dostawa trwa 3 dni. Jakiego rozmiaru Pan potrzebuje?Coveton Apparel · 10:41
01

Odczyt

Historia i nowe wiadomości, dla każdego użytkownika.

02

Przypisanie

Każda rozmowa do jednego kontaktu.

03

Odpowiedź

Z karty kontaktu, jako użytkownik lub jako Strona.

04

Na żywo

Webhooki zamiast odpytywania.

Podejścia

Jak połączyć Facebook Messenger z CRM: trzy sposoby

Konektor no-code jest szybki, ale działa głównie w jedną stronę. Messenger Platform od Meta działa w obie strony, ale tylko dla Stron i po App Review. API z połączeniem per użytkownik obejmuje konta prywatne i Strony, bez aplikacji Meta.

KryteriumKonektor no-codeMeta Messenger PlatformPołączenie per użytkownik (Unipile)
KontaZwykle jedna Strona na FacebookuWyłącznie Strony na Facebooku (Business Pages)Konta prywatne i Strony, którymi zarządzają
KierunekGłównie w jedną stronę: z wiadomości do leadaW obie strony, w oknie 24 godzinSynchronizacja dwukierunkowa: odczyt, odpowiedź, reakcja
Czas rzeczywistyCzęsto odpytywanie, w niektórych planach co 15 minutWebhooki MetaWebhooki, np. message.new
Po Twojej stronieJeden workflow na konfiguracjęAplikacja Meta, App Review, token dla każdej StronyLink Hosted Auth, jedno account_id na użytkownika
HistoriaZależy od konektoraRozmowy StronyCzaty prywatne i skrzynka każdej Strony
Inne kanałyOsobny konektor dla każdegoOsobna integracja dla każdego produktu MetaTo samo API dla LinkedIn, WhatsApp, Instagrama i e-maila
Konta
No-codeZwykle jedna Strona na Facebooku
MetaWyłącznie Strony na Facebooku
UnipileKonta prywatne i Strony, którymi zarządzają
Kierunek
No-codeGłównie w jedną stronę: z wiadomości do leada
MetaW obie strony, w oknie 24 godzin
UnipileSynchronizacja dwukierunkowa: odczyt, odpowiedź, reakcja
Czas rzeczywisty
No-codeCzęsto odpytywanie, w niektórych planach co 15 minut
MetaWebhooki Meta
UnipileWebhooki, np. message.new
Po Twojej stronie
No-codeJeden workflow na konfigurację
MetaAplikacja Meta, App Review, token dla każdej Strony
UnipileLink Hosted Auth, jedno account_id na użytkownika
Historia
No-codeZależy od konektora
MetaRozmowy Strony
UnipileCzaty prywatne i skrzynka każdej Strony
Inne kanały
No-codeOsobny konektor dla każdego
MetaOsobna integracja dla każdego produktu Meta
UnipileTo samo API dla LinkedIn, WhatsApp, Instagrama i e-maila

Zapier czy Make sprawdzają się przy jednej firmie i jednej Stronie, a Meta Business Suite daje tej firmie skrzynkę dla jej własnej Strony. Produkt obsługujący wielu klientów potrzebuje integracji we własnym kodzie.

W podejściu Meta każda Strona klienta wymaga Page access token i uprawnień zatwierdzonych przez Meta, co pokazujemy w przewodniku po Facebook Page API. Odpowiedzi podlegają oknu 24 godzin i tagom wiadomości, z których kilka Meta wycofała w 2026 roku. Do tego ta droga nigdy nie obejmuje kont prywatnych, z których handlowcy i doradcy korzystają w kontakcie z klientami.

Źródła: dokumentacja Meta Messenger Platform send messages, funkcje providerów w Unipile. Ostatnia weryfikacja: 17 listopada 2026.

Połączenie

Połącz konto Facebook i Strony każdego użytkownika

Każdy użytkownik CRM otwiera link Hosted Auth i loguje się do Facebooka, łącznie z uwierzytelnianiem dwuskładnikowym. Twój CRM otrzymuje jedno account_id, które obejmuje jego konto prywatne i każdą Stronę, którą administruje, wszystkie aktywowane domyślnie.

1

Otwórz link Hosted Auth

Backend go generuje, użytkownik go otwiera.

Hosted Auth
2

Zaloguj się i odblokuj historię

Dane logowania, 2FA, potem opcjonalne odblokowanie historii.

ENCRYPTED_HISTORY
3

Zapisz account_id

Przypisz je do użytkownika CRM. Jego Strony są w pakiecie.

{ACCOUNT_ID}

Strony aktywuje się przez produkt page przy połączeniu lub ponownym połączeniu; nieaktywowana Strona zwraca 403 api/insufficient_permissions. Logowanie opisujemy szczegółowo w przewodniku po Facebook Messenger API dla kont prywatnych.

Źródło: dokumentacja Facebook Pages w Unipile. Ostatnia weryfikacja: 17 listopada 2026.

Synchronizacja

Synchronizuj historię rozmów i nowe wiadomości w czasie rzeczywistym

Najpierw pobierz historię przez API: czaty prywatne, a potem skrzynkę każdej Strony. Następnie przełącz się na webhooki, aby każda nowa wiadomość, edycja, potwierdzenie czy reakcja docierały do CRM w czasie rzeczywistym, zgodnie z listą na naszej stronie Facebook Messenger API.

FacebookŹródłoKonto prywatne + StronyJedno na użytkownika CRM
PołączenieUnipileJedno account_id
Dane wejścioweHistoria, potem webhookiGET /chats raz, potem message.new
Twój kodUsługa synchronizacjiKieruje, przypisuje, usuwa duplikaty
Twoje daneBaza CRMKontakty i wiadomości

Pobierz historię czatów prywatnych i skrzynek Stron

Lista czatów konta zawiera tylko rozmowy prywatne; każda Strona ma własną skrzynkę, PAGE_<page_id>_INBOX. Listy zwracają do 100 elementów na stronę, od najnowszych wiadomości: przechodź wstecz tak daleko, jak potrzebuje Twój CRM.

Bazowy URL https://api.unipile.com · nagłówek X-API-KEY
GET/v2/{account_id}/chatsCzaty prywatne połączonego konta
GET/v2/{account_id}/inboxes/{inbox_id}/chatsCzaty jednej skrzynki Strony
GET/v2/{account_id}/chats/{chat_id}/messagesWiadomości czatu, od najnowszych

Szyfrowane czaty i historia

Prywatne czaty 1:1 i grupowe są szyfrowane end-to-end; rozmowy Stron nie są. Wcześniejsze wiadomości prywatne znajdują się w zaszyfrowanej kopii zapasowej, którą użytkownik odblokowuje kodem odzyskiwania lub PIN-em Messengera, w kroku wyświetlanym przez Hosted Auth podczas połączenia. Bez tego dostępne są tylko wiadomości od momentu połączenia.

Webhooki

Jeden URL webhooka obsługuje wszystkie połączone konta. Zdarzenia Stron zawierają chat ID w zakresie Strony, więc kieruj je według prefiksu PAGE_<page_id>_. Zdarzenia dostępne dla Facebooka:

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

Źródła: Unipile pobieranie czatów i wiadomości, szyfrowane czaty, funkcje providerów i konfiguracja webhooka. Ostatnia weryfikacja: 17 listopada 2026.

Wypróbuj

Połącz konto Facebook w swoim workspace testowym

Połącz konto, pobierz listę jego czatów i skieruj webhook do swojej usługi. 7 dni za darmo, bez karty kredytowej.

Buduj teraz
Model danych

Przypisz rozmowy z Messengera do kontaktów w CRM

Przypisuj każdą rozmowę do kontaktu na podstawie Facebook ID rozmówcy, nigdy wyświetlanej nazwy. Rozmowy Stron i prywatne rozdzielaj według prefiksu PAGE_<page_id>_ w chat ID.

IdentyfikatorGdzie go zapisaćUwaga
Facebook ID rozmówcyNa kontakcie: Twój klucz dopasowaniaNigdy nie dopasowuj po wyświetlanej nazwie
account_idNa użytkowniku CRM, który połączył FacebookaObejmuje konto prywatne i Strony
Prywatny chat IDNa rozmowieTo nie jest klucz kontaktu
Chat ID Strony PAGE_<page_id>_<thread_key>Na rozmowie i jej StronieDzięki prefiksowi Unipile działa jako Strona
Page ID i ID profilu StronyPage ID na skrzynce i statusieAutorzy postów Strony używają ID profilu: nigdy ich nie porównuj
Facebook ID rozmówcy
Gdzie zapisaćNa kontakcie: Twój klucz dopasowania
UwagaNigdy nie dopasowuj po wyświetlanej nazwie
account_id
Gdzie zapisaćNa użytkowniku CRM, który połączył Facebooka
UwagaObejmuje konto prywatne i Strony
Prywatny chat ID
Gdzie zapisaćNa rozmowie
Chat ID Strony
Gdzie zapisaćNa rozmowie i jej Stronie (PAGE_<page_id>_<thread_key>)
UwagaDzięki prefiksowi Unipile działa jako Strona
Page ID i ID profilu Strony
Gdzie zapisaćPage ID na skrzynce i statusie
UwagaAutorzy postów Strony używają ID profilu: nigdy ich nie porównuj

Jedna pułapka: dla tej samej rozmowy chat ID zwrócony przez API może się różnić od tego w zdarzeniu webhook. Zapisz oba na rozmowie i uzgadniaj je po stronie CRM, opierając się na Facebook ID kontaktu. „Find Chats by User” zwraca istniejące czaty kontaktu albo pustą listę.

Handler message.new zapisujący dane na karcie kontaktu

readUnipileEvent oznacza Twoje mapowanie payloadu.

// 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 · jeden kontakt na Facebook ID, jeden wiersz na message ID
200 OK · jeden kontakt na Facebook ID, jeden wiersz na message ID

Formaty chat ID według dokumentacji Facebook Pages, wyszukiwanie czatów według pobierania czatów i wiadomości.

Odpowiedź

Odpowiadaj z karty kontaktu, jako użytkownik lub jako Strona

Wyślij odpowiedź na chat ID rozmowy. Chat ID Strony odpowiada jako Strona; prywatny chat ID wysyła wiadomość z własnego konta użytkownika. Edytor pokazuje, która tożsamość zostanie użyta.

Twój CRM · Leo Martin Rozmowa Strony
Rozmiar M poproszę. Zdąży dojść do piątku?10:42
Tak, jeśli zamówi Pan dziś przed 14:00.Coveton Apparel · 10:44
Świetnie, już zamawiam.10:46
Odpowiedz jakoAnna RossiFacebookStrona Coveton Apparel
Dziękujemy, Leo, zamówienie potwierdzone. Link do śledzenia prześlemy wkrótce.
Nowa rozmowaWyślij

Strona odpowiada tylko osobom, które do niej napisały.

POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Z czatu Strony
  • Odpowiedzi wychodzą jako Strona
  • Bez nowych rozmów: 501 api/not_implemented
  • Bez usuwania jej wiadomości: ten sam błąd
Z czatu prywatnego
  • Odpowiedzi wychodzą z konta użytkownika
  • Może rozpocząć rozmowę, gdy Facebook na to pozwala

Wyszarz przycisk „Nowa rozmowa” dla Strony. Treść żądania, załączniki i błędy: zobacz, jak wysłać wiadomość w Messengerze przez API.

Eksploatacja

Uruchom to dla każdego klienta: status, uprawnienia i zasady Meta

Pokazuj stan każdego połączenia. Każda Strona raportuje własny status, więc jedna niedziałająca Strona nie blokuje wiadomości prywatnych ani innych Stron.

Admin · Połączone konta Częściowo
PołączenieStatus
FacebookAnna RossiWiadomości · konto prywatnerunning
Strona Coveton Apparelpage_<page_id>running
Strona Coveton OutletRola administratora odebranadisconnectedPołącz ponownie
STATUS metadata.products_connection_status dla każdej Strony

Każda Strona ma własny klucz w metadata.products_connection_status, o nazwie page_<page_id>. Gdy Strona przestaje działać, konto przechodzi w stan partial lub degraded. Strona, której administrator stracił uprawnienia, pozostaje w stanie disconnected aż do ponownego połączenia: pokaż to i zaproponuj ponowne połączenie.

Zdecyduj, kto widzi które rozmowy

Rozmowy prywatne pokazuj ich właścicielowi i wybranym menedżerom, rozmowy Stron zespołowi Strony, w jednej skrzynce z przypisywaniem i tagami. To ten sam model co API do wiadomości dla oprogramowania CRM obejmujące LinkedIn, WhatsApp i e-mail, i powód, dla którego ujednolicone API do wiadomości pozwala dodać Messengera bez nowego konektora.

Zgodność

Każdy użytkownik łączy własne konto

Dla CRM, obsługi klienta, doradców lub agenta AI, którego szkice zatwierdza człowiek. Bez masowej wysyłki.

Aplikacja Meta lub App Review?Niepotrzebne: użytkownicy łączą się przez Hosted Auth.
Oficjalny partner Meta?Nie. Unipile nie jest ani oficjalną aplikacją Meta, ani partnerem Meta.
Warunki Meta?Każdy użytkownik nadal jest nimi związany.
Digital Markets Act?Bez przechowywania profili. Zobacz naszą stronę o Digital Markets Act.

Zacznij budować integrację z Messengerem

Integracja Facebook Messenger z CRM to jedno połączenie na użytkownika, pobranie historii, a potem webhooki, kontakty przypisane po Facebook ID i odpowiedzi z właściwej tożsamości. Ten sam kod obsługuje LinkedIn, WhatsApp i e-mail. 7 dni za darmo, bez karty kredytowej.

Komisja Europejska
Regulowane przez UE Digital Markets Act (DMA)

Każdy użytkownik łączy własne konto, bez przechowywania profili. Unipile nie jest partnerem Meta. Unipile i DMA

Wszystkie endpointy API Facebooka w jednym miejscu

Messenger to tylko część całości. Zobacz wszystkie endpointy Facebooka dostępne w Unipile, od postów i komentarzy po profile, albo zacznij od naszego kompletnego przewodnika po API Facebook.

FAQ: integracja Facebook Messenger z CRM

Wiadomości w CRM, automatyczne odpowiedzi i wiele Stron.

Żeby rozmowy nie zostawały w telefonie jednej osoby. Każda wiadomość trafia na kartę kontaktu, zespół widzi pełną historię, a follow-upy, przypisywanie i raportowanie działają w Messengerze tak samo jak w e-mailu.

To wysyłanie i odbieranie wiadomości w Messengerze, WhatsAppie, na LinkedIn czy przez e-mail bezpośrednio w CRM, z każdą rozmową przypisaną do kontaktu. Integracja Facebook Messenger z CRM obejmuje jeden kanał; ujednolicone API do wiadomości dodaje pozostałe w tym samym modelu danych.

Tak, ale z udziałem człowieka: agent AI przygotowuje szkic odpowiedzi na podstawie historii kontaktu, a użytkownik zatwierdza go przed wysłaniem. Użytkownicy nadal podlegają warunkom Meta: żadnych niezamówionych ani masowych wiadomości.

Tak. Każda Strona, którą administruje użytkownik, jest domyślnie aktywowana na tym samym account_id, z własną skrzynką (PAGE_<page_id>_INBOX) i własnym statusem. W CRM pokazuj każdą Stronę jako osobną skrzynkę.

Masz jeszcze pytania? Nasz zespół chętnie pomoże.

Porozmawiaj z ekspertem