
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.
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
Spis treści
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
Połącz konto Facebook i Strony każdego użytkownika przez Hosted Auth. Bez aplikacji Meta i bez App Review.
- 2
Zaimportuj historię jego czatów przez
GET /v2/{account_id}/chats, z nagłówkiemX-API-KEY. - 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.
Leo MartinLead · Lyon
OpiekunAnna Rossi
KanałMessenger · Strona Coveton Apparel
Facebook ID
{FACEBOOK_USER_ID}AktywnośćE-mailMessenger 2Szanse
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.
| Kryterium | Konektor no-code | Meta Messenger Platform | Połączenie per użytkownik (Unipile) |
|---|---|---|---|
| Konta | Zwykle jedna Strona na Facebooku | Wyłącznie Strony na Facebooku (Business Pages) | Konta prywatne i Strony, którymi zarządzają |
| Kierunek | Głównie w jedną stronę: z wiadomości do leada | W obie strony, w oknie 24 godzin | Synchronizacja dwukierunkowa: odczyt, odpowiedź, reakcja |
| Czas rzeczywisty | Często odpytywanie, w niektórych planach co 15 minut | Webhooki Meta | Webhooki, np. message.new |
| Po Twojej stronie | Jeden workflow na konfigurację | Aplikacja Meta, App Review, token dla każdej Strony | Link Hosted Auth, jedno account_id na użytkownika |
| Historia | Zależy od konektora | Rozmowy Strony | Czaty prywatne i skrzynka każdej Strony |
| Inne kanały | Osobny konektor dla każdego | Osobna integracja dla każdego produktu Meta | To 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.newPo Twojej stronie
No-codeJeden workflow na konfigurację
MetaAplikacja Meta, App Review, token dla każdej Strony
UnipileLink Hosted Auth, jedno
account_id na użytkownikaHistoria
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 Auth2
Zaloguj się i odblokuj historię
Dane logowania, 2FA, potem opcjonalne odblokowanie historii.
ENCRYPTED_HISTORY3
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.
PołączenieUnipileJedno
account_idDane wejścioweHistoria, potem webhooki
GET /chats raz, potem message.newTwó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-KEYGET/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
Buduj teraz
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.
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.
| Identyfikator | Gdzie go zapisać | Uwaga |
|---|---|---|
| Facebook ID rozmówcy | Na kontakcie: Twój klucz dopasowania | Nigdy nie dopasowuj po wyświetlanej nazwie |
account_id | Na użytkowniku CRM, który połączył Facebooka | Obejmuje konto prywatne i Strony |
| Prywatny chat ID | Na rozmowie | To nie jest klucz kontaktu |
Chat ID Strony PAGE_<page_id>_<thread_key> | Na rozmowie i jej Stronie | Dzięki prefiksowi Unipile działa jako Strona |
| Page ID i ID profilu Strony | Page ID na skrzynce i statusie | Autorzy 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.
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 Rossi
Strona 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.
PołączenieStatus
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.
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
