
Konta prywatne
Facebook Messenger API a konto prywatne: na co pozwala Meta i jak je połączyć
Szukasz dostępu do API Facebook Messenger z konta prywatnego? Messenger Platform od Meta obsługuje wyłącznie Strony na Facebooku. Wyjaśniamy dlaczego i jak Twoi użytkownicy mogą połączyć własne konto z Twoją aplikacją.
Tom Reyes
Anna Lee, konto prywatne
Cześć Anna, możemy przełożyć rozmowę na czwartek?09:12
Webhook: message.new
Jasne, czwartek o 10:00 pasuje. Wyślę zaproszenie.09:14 · Wyświetlono
POST
api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
Spis treści
Krótka odpowiedź
Oficjalne Facebook Messenger API nie obsługuje kont prywatnych. Messenger Platform od Meta pozwala Stronie na Facebooku lub profesjonalnemu kontu Instagram odpowiadać ludziom, ale nigdy profilowi prywatnemu. Aby pracować z prywatnym kontem Facebook, jego właściciel łączy je z Twoją aplikacją przez zewnętrzne API, takie jak Unipile.
Projekty open source, które sterują messenger.com z przeglądarki, są nieoficjalne, w większości nieutrzymywane i psują się przy każdej zmianie interfejsu. Połączone konto korzysta z utrzymywanego API z webhookami.
Szerszy obraz API od Meta pokazuje, jak współgrają ze sobą API Facebooka.
Z Unipile
Wiadomości z prywatnego konta Facebook w trzech krokach
- 1
Połącz. Twój użytkownik łączy własne konto Facebook przez Hosted Auth. Bez aplikacji Meta i bez App Review.
- 2
Wysyłaj. Wywołaj API V2 z nagłówkiem
X-API-KEY:POST/v2/{ACCOUNT_ID}/ chats/ {CHAT_ID}/ messages/ send - 3
Odbieraj. Przychodzące wiadomości trafiają do Twojego webhooka jako zdarzenia
message.new.
Szczegóły znajdziesz poniżej w opisie procesu łączenia i przykładach kodu oraz w materiale Szybki start z Facebookiem.
Rozpocznij 7-dniowy darmowy okres próbny
Odpowiedź
Czy Facebook Messenger API działa z kontem prywatnym?
Oficjalne nie. Meta zbudowała Messenger Platform dla firm: pozwala Stronie na Facebooku lub profesjonalnemu kontu Instagram odpowiadać osobom, które do niej piszą. Prywatne konto Facebook trafia do Twojej aplikacji tylko wtedy, gdy połączy je jego właściciel, przez zewnętrzne API działające w jego imieniu.
Messenger Platform od Meta
Strona na Facebooku
- Twoja aplikacja Meta działa w imieniu Strony z Page access token.
- Strona odpowiada osobom, które napisały do niej pierwsze.
- Standardowe okno wiadomości: 24 godziny od ostatniej wiadomości danej osoby.
- App Review przed obsługą Stron, których nie jesteś właścicielem.
Konto połączone przez Unipile
Prywatne konto Facebook
- Każdy użytkownik łączy własne konto przez hostowane uwierzytelnianie.
- Twoja aplikacja odczytuje i wysyła wiadomości z tego konta.
- Jedno REST API i jeden format webhooków dla wszystkich kanałów.
- Użytkownik nadal podlega Warunkom Meta.
Źródło: Messenger Platform overview od Meta. Ostatnia weryfikacja: listopad 2026.
Model oficjalny
Dlaczego Messenger Platform od Meta ogranicza się do Stron na Facebooku
Messenger Platform jest zaprojektowana wokół Strony, nie osoby. Każde wywołanie działa w imieniu Strony na Facebooku, z Page access token i uprawnieniem pages_messaging, więc nie istnieje token reprezentujący prywatną skrzynkę odbiorczą.
1
Aplikacja Meta
Rejestrujesz aplikację w Meta for Developers z przypadkiem użycia Messenger.
2
Facebook Login for Business
Administrator Strony przyznaje uprawnienia takie jak pages_messaging.
3
Page access token
Twoja aplikacja wywołuje Send API wyłącznie w imieniu tej Strony.
4
Webhook i okno 24 godzin
Strona odbiera wiadomości i odpowiada w standardowym oknie wiadomości.
Uprawnienia przyznaje się przez Facebook Login for Business, a business_management jest zależnością pages_messaging. App Review nie jest wymagane, jeśli wysyłasz i odbierasz wiadomości tylko dla własnej Strony; obsługa Stron innych firm go wymaga. Większość odpowiedzi trzeba wysłać w ciągu 24 godzin od ostatniej wiadomości danej osoby; tag wiadomości HUMAN_AGENT wydłuża ręczne odpowiedzi do 7 dni, po App Review. Żaden z tych kroków Graph API nie może dotyczyć profilu prywatnego, dlatego narzędzia oparte na oficjalnym API łączą wyłącznie Strony. Koszty takiej konfiguracji opisujemy w przewodniku cennik API Facebook Messenger.
Źródła: Messenger Platform overview i Send API reference od Meta. Ostatnia weryfikacja: listopad 2026.
Co się stało z Facebook Chat API?
Meta wyłączyła dawne Facebook Chat API (XMPP, chat.facebook.com) w 2015 roku, wraz z końcem Graph API v1.0 i uprawnienia xmpp_login. Nie istnieje oficjalne API dla prywatnej skrzynki na Facebooku: Messenger Platform, która zastąpiła je w komunikacji biznesowej, działa wyłącznie w imieniu Stron. Nieoficjalne biblioteki publikowane od tamtej pory w npm logują się do messenger.com przy użyciu sesji samego użytkownika. Meta ich nie wspiera, a pierwotny projekt open source deklaruje, że jest w trybie utrzymania.
- Brak harmonogramu wydań. Przestają działać, gdy Facebook zmienia swój interfejs.
- Dane logowania w Twojej aplikacji. Twoja aplikacja przechowuje i ponownie wykorzystuje sesję lub hasło użytkownika.
- Ryzyko dla konta. Facebook może ograniczyć konto, którego użycie narusza jego Warunki, a to ryzyko spada na użytkownika końcowego.
Aby wysyłać wiadomości ze Strony, którą zarządzasz, użyj Messenger Platform i wyślij wiadomość w Messengerze przez API. Dla własnego konta użytkownika użyj utrzymywanego API: użytkownik łączy się przez Hosted Auth, więc Twoja aplikacja nigdy nie dotyka jego hasła, a Ty otrzymujesz account_id, webhooki i zespół wsparcia (zobacz, jak łączy się konto prywatne). Warunki Meta nadal obowiązują to konto.
Połączenie
Jak prywatne konto Facebook łączy się z Twoją aplikacją
Właściciel konta łączy je sam. Twoja aplikacja otwiera stronę Hosted Auth od Unipile (lub własny ekran z Custom Auth), użytkownik loguje się do Facebooka i potwierdza uwierzytelnianie dwuskładnikowe, a Twoja aplikacja otrzymuje account_id do wywołań API.
1Twoja aplikacja
Otwarcie Hosted Auth
Użytkownik klika „Połącz Facebook” i trafia do Hosted Auth.
2Użytkownik
Logowanie i potwierdzenie
Nazwa użytkownika, e-mail lub telefon z hasłem, ciasteczka przeglądarki albo rozszerzenie UniLogin, a potem 2FA przez SMS, aplikację uwierzytelniającą, WhatsApp, zatwierdzenie w aplikacji lub kod jednorazowy.
3Unipile
Otrzymanie account_id
Połączone konto pojawia się w Twoim panelu, a każde wywołanie używa jego account_id.
W tym procesie nie ma ekranu OAuth od Meta ani kodu QR, a Ty nie tworzysz aplikacji Meta i nie przechodzisz App Review po swojej stronie. Metody dla każdego dostawcy znajdziesz w tabeli funkcji dostawców, a przegląd produktu na stronie Facebook Messenger API.
Zgodność
Każdy użytkownik łączy własne konto
Unipile nie jest produktem Meta. Nie jest Partnerem Meta i nie jest przez Meta rekomendowane. Każdy użytkownik łączy własne konto, Unipile działa w imieniu tego uwierzytelnionego użytkownika, a użytkownik nadal podlega Warunkom Meta.
Zakres
API dla prywatnego konta Facebook: co może połączone konto
W praktyce integracja API Facebook Messenger z kontem prywatnym udostępnia własną skrzynkę Messengera użytkownika przez API Unipile: czaty, wiadomości, załączniki, reakcje i potwierdzenia, a także webhooki w czasie rzeczywistym. Poniżej porównanie z oficjalnym modelem Strony.
| Temat | Strona przez Messenger Platform | Konto prywatne przez Unipile |
|---|---|---|
| Konto | Strona na Facebooku lub profesjonalne konto Instagram | Własne prywatne konto Facebook użytkownika |
| Kto łączy | Administrator Strony, przez Facebook Login for Business | Właściciel konta, przez Hosted Auth lub Custom Auth |
| Co ma Twoja aplikacja | Page access token | Twój klucz API Unipile i account_id użytkownika |
| Aplikacja Meta i App Review | Aplikacja Meta oraz App Review, aby obsługiwać cudze Strony | Bez aplikacji Meta i bez App Review po Twojej stronie |
| Kto pisze pierwszy | Osoba pisze do Strony | Użytkownik może odpowiedzieć lub rozpocząć nową rozmowę |
| Zdarzenia w czasie rzeczywistym | Webhooki Messengera w Twojej aplikacji Meta | Nowe, edytowane i usunięte wiadomości, potwierdzenia odczytu i dostarczenia, reakcje, aktualizacje czatów |
Konto
StronaStrona na Facebooku lub profesjonalne konto Instagram
Konto prywatneWłasne prywatne konto Facebook użytkownika
Kto łączy
StronaAdministrator Strony, przez Facebook Login for Business
Konto prywatneWłaściciel konta, przez Hosted Auth lub Custom Auth
Co ma Twoja aplikacja
StronaPage access token
Konto prywatneTwój klucz API Unipile i
account_id użytkownikaAplikacja Meta i App Review
StronaAplikacja Meta oraz App Review, aby obsługiwać cudze Strony
Konto prywatneBez aplikacji Meta i bez App Review po Twojej stronie
Kto pisze pierwszy
StronaOsoba pisze do Strony
Konto prywatneUżytkownik może odpowiedzieć lub rozpocząć nową rozmowę
Zdarzenia w czasie rzeczywistym
StronaWebhooki Messengera w Twojej aplikacji Meta
Konto prywatneNowe, edytowane i usunięte wiadomości, potwierdzenia odczytu i dostarczenia, reakcje, aktualizacje czatów
Endpointy wiadomości
- Lista czatów i wiadomości, w tym rozmów grupowych
- Rozpoczynanie rozmowy, wysyłka wiadomości i załączników
- Edycja, usuwanie i przekazywanie wiadomości
- Dodawanie i usuwanie reakcji, oznaczanie jako przeczytane, potwierdzenia odczytu
- Wyciszanie i archiwizacja czatów
Nieobsługiwane
- Przypinanie wiadomości
- Relacje (Stories)
To samo połączone konto udostępnia też swoje posty, komentarze i reakcje. Te endpointy podsumowuje przewodnik po API Facebook.
Kod
Odczyt czatów i wysyłka wiadomości z konta prywatnego
Podstawową pętlę obsługują dwa wywołania: lista czatów połączonego konta, a następnie wysłanie wiadomości w jednym z nich. Żądania trafiają na https://api.unipile.com z Twoim kluczem API w nagłówku X-API-KEY.
# 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."},
)
200 OK · wiadomość wysłana z własnego konta użytkownika
Wiadomości przychodzące trafiają na Twój webhook jako zdarzenia message.new, więc nie musisz odpytywać API. Node.js SDK opakowuje te same wywołania jako getChatsList i sendMessage. Pełna konfiguracja w Facebook quickstart. Więcej języków, załączniki i odpowiedzi jako Strona w artykule wysyłanie wiadomości przez API Facebook Messenger.
Jak te dwa wywołania wyglądają w Twojej aplikacji
1Lista czatówGET/chats
Tom ReyesCześć Anno, możemy przenieść naszą rozmowę na czwartek?
Maya ChenDo zobaczenia w sobotę na targu
Sam PatelDzięki za zdjęcia
Wybrany czat
- chat_id
- {CHAT_ID}
- name
- Tom Reyes
- last message
- Cześć Anno, możemy przenieść…
- timestamp
- 09:12
2Wysłanie odpowiedziPOST/messages/send
Tom Reyes
Anna Lee, konto prywatne
Cześć Anno, możemy przenieść naszą rozmowę na czwartek?09:12
Czwartek o 10:00 mi pasuje.09:14 · Wyświetlono
Żądanie
- chat_id
- {CHAT_ID}
- text
- Czwartek o 10:00 mi…
- response
- 200 OK
Zastosowania
Uzasadnione zastosowania i zasady Meta, których Twoi użytkownicy nadal przestrzegają
Połączone konto prywatne pasuje do produktów, w których profesjonalista rozmawia z własnymi kontaktami z własnego konta: CRM, helpdeski, asystenci AI przygotowujący odpowiedzi zatwierdzane przez użytkownika oraz narzędzia dla doradców. Nie służy do cold outreachu ani w pełni zautomatyzowanych botów.
CRM
Handlowiec widzi swoje rozmowy z Messengera na właściwej karcie kontaktu, obok e-maili i połączeń. Zobacz integrację z CRM.
Helpdesk i wielokanałowa skrzynka
Messenger trafia do tej samej skrzynki co LinkedIn, WhatsApp, Instagram i Telegram, z jednym modelem danych.
Asystent AI
Agent przygotowuje odpowiedź na podstawie historii rozmowy, a użytkownik sprawdza ją przed wysłaniem.
Opieka doradcy nad klientem
Konsultant lub agent śledzi kontakt z klientami, z którymi już rozmawia na Messengerze.
Warunki Meta nadal obowiązują
Połączone konto nadal podlega Warunkom korzystania z usług Meta. Buduj z myślą o rozmowach, które użytkownik i tak by prowadził: niechciane wiadomości i nieautoryzowana automatyzacja mogą skłonić Meta do ograniczenia konta.
Budujesz jedną skrzynkę dla wielu sieci? Zobacz, jak działa ujednolicone API do wiadomości.
Graph API
API Facebook dla kont prywatnych: na co Graph API nadal pozwala
Integracja API Facebook z kontem prywatnym przez Graph API od Meta ma wąski zakres. Pozwala zidentyfikować osobę i odczytać kilka pól profilu, ale nie otwiera jej skrzynki Messengera ani nie publikuje w jej imieniu.
Identyfikacja nadal działa. Przez Facebook Login osoba przyznaje Twojej aplikacji user access token. Uprawnienie public_profile odczytuje domyślne publiczne pola profilu, a email jej główny adres e-mail. Inne uprawnienia użytkownika, takie jak user_posts dla postów opublikowanych przez użytkownika na jego osi czasu, Meta ogranicza do krótkiej listy zatwierdzonych zastosowań. Żadne uprawnienie użytkownika nie daje dostępu do jego rozmów w Messengerze. Sposób wydawania tych tokenów opisujemy w przewodniku token dostępu API Facebook.
Publikowanie na profilu skończyło się w 2018 roku. Meta usunęła uprawnienie publish_actions 24 kwietnia 2018 r., a aplikacje, które już je miały zatwierdzone, mogły z niego korzystać do 1 sierpnia 2018 r. Od tego czasu aplikacje oparte na Graph API publikują wyłącznie na Stronach, dlatego narzędzia do planowania postów przestały obsługiwać profile prywatne.
Połączone konto obsługuje obie strony. Gdy właściciel połączy swoje konto prywatne przez Unipile, Twoja aplikacja odczytuje i wysyła jego wiadomości w Messengerze oraz tworzy, edytuje i usuwa jego posty, komentarze i reakcje. Publikowanie opisujemy szczegółowo w przewodniku API postów Facebook.
| Działanie | Graph API z user access token | Konto prywatne połączone przez Unipile |
|---|---|---|
| Odczyt wiadomości użytkownika w Messengerze | Nie, żadne uprawnienie użytkownika nie obejmuje skrzynki | Tak, czaty, wiadomości i załączniki |
| Publikowanie na profilu użytkownika | Nie, publish_actions usunięto w 2018 roku | Tak, tworzenie, edycja i usuwanie postów |
| Odpowiadanie na wiadomości | Nie, Messenger Platform obsługuje Strony | Tak, odpowiedź lub rozpoczęcie rozmowy |
Odczyt wiadomości użytkownika w Messengerze
Graph APINie, żadne uprawnienie użytkownika nie obejmuje skrzynki
Połączone kontoTak, czaty, wiadomości i załączniki
Publikowanie na profilu użytkownika
Graph APINie,
publish_actions usunięto w 2018 rokuPołączone kontoTak, tworzenie, edycja i usuwanie postów
Odpowiadanie na wiadomości
Graph APINie, Messenger Platform obsługuje Strony
Połączone kontoTak, odpowiedź lub rozpoczęcie rozmowy
Źródła: Permissions reference i changelog Graph API z 24 kwietnia 2018 r. od Meta. Ostatnia weryfikacja: 17 listopada 2026.
Połącz prywatne konta Facebook ze swoim produktem
Messenger Platform od Meta pozostaje właściwym narzędziem dla firmy, która odpowiada ludziom na własnej Stronie. Gdy Twój produkt potrzebuje Facebook Messenger API, także dla kont prywatnych, pozwól użytkownikom połączyć własne konto Facebook i korzystaj z jednego API dla Facebooka i pozostałych kanałów.
Regulowane przez UE
Digital Markets Act (DMA)
Każdy użytkownik łączy własne konto, bez przechowywania profili. Unipile nie jest partnerem Meta. Przeczytaj naszą stronę o Digital Markets Act
Dokumentacja endpointów
Wszystkie endpointy API Facebooka w jednym miejscu
Wiadomości to tylko część całości. Przejrzyj wszystkie endpointy Facebooka dostępne w Unipile, od czatów po posty, lub przeczytaj kompletny przewodnik po API Facebook, aby porównać oficjalne API od Meta z połączonymi kontami.
API dla prywatnego konta Facebook: FAQ
Krótkie odpowiedzi o profilach, historii wiadomości, pierwszych wiadomościach, reakcjach, Stronach, chatbotach, Graph API i nieoficjalnych bibliotekach.
Messenger Platform od Meta nie: obsługuje Strony na Facebooku i profesjonalne konta Instagram. Z profilu prywatnego można korzystać, gdy jego właściciel połączy go z Twoją aplikacją przez hostowane uwierzytelnianie Unipile; właściciel nadal podlega Warunkom Meta.
Tak, po połączeniu konta. API zwraca czaty i wiadomości połączonego konta prywatnego, w tym rozmowy grupowe i załączniki, a webhooki przesyłają do Twojej aplikacji nowe, edytowane i usunięte wiadomości.
Tak. Połączone konto prywatne może zarówno odpowiadać, jak i rozpoczynać nowe rozmowy. Ogranicz się do osób, które użytkownik zna lub z którymi współpracuje: niechciane wiadomości naruszają Warunki Meta i mogą skończyć się ograniczeniem konta.
Tak. Możesz pobierać, dodawać i usuwać reakcje na wiadomości, a nowe reakcje trafiają do Twojej aplikacji przez zdarzenie webhook message.reaction.new.
Tak, w przypadku Stron, którymi zarządza połączony użytkownik. Twoja aplikacja może odczytywać wiadomości Strony, odpowiadać na nie i publikować jako Strona. Strona nie może rozpocząć rozmowy ani usuwać swoich wiadomości, więc wątki Strony zawsze zaczynają się od wiadomości drugiej osoby.
Messenger Platform od Meta i oparte na niej kreatory chatbotów działają wyłącznie ze Stronami. Przy połączonym koncie prywatnym zostaw człowieka w pętli: AI przygotowuje odpowiedź, a użytkownik ją zatwierdza. W pełni zautomatyzowane lub niechciane wiadomości mogą skończyć się ograniczeniem konta.
Częściowo. Graph API od Meta nadal akceptuje profil prywatny w Facebook Login i przy kilku uprawnieniach odczytu, ale nie otwiera skrzynki Messengera danej osoby i nie publikuje na profilach od czasu usunięcia publish_actions w 2018 roku. Aby integracja API Facebook z kontem prywatnym obejmowała wiadomości i posty, właściciel łączy konto przez Unipile, a Twoja aplikacja korzysta z jednego REST API.
Tak. Istnieją biblioteki open source, które logują się do messenger.com przy użyciu sesji samego użytkownika, ale są nieoficjalne i Meta ich nie wspiera. Mogą przestać działać, gdy Facebook zmieni swój interfejs, a konto, które z nich korzysta, może zostać ograniczone na mocy Warunków Meta. W aplikacji produkcyjnej używaj Messenger Platform dla Stron, którymi zarządzasz, albo utrzymywanego API, w którym użytkownik łączy własne konto i nadal podlega Warunkom Meta.
Nie przez ich integracje z Facebook Messenger: opierają się one na Messenger Platform od Meta, która obsługuje wyłącznie Strony. Przy koncie prywatnym połączonym przez Unipile wiadomość jest wysyłana z Twojego własnego workflow, na przykład z kroku HTTP, który wywołuje endpoint wysyłania wiadomości dla tego konta.
Nie. Unipile to niezależna firma: nie jest Meta Partner i nie jest wspierana, sponsorowana ani zatwierdzona przez Meta. Połączenie prywatnego konta Messengera przez Unipile nie jest oficjalną integracją Messenger Platform. Facebook i Messenger są znakami towarowymi Meta Platforms, Inc.
Nie. Właściciel konta loguje się przez hostowane uwierzytelnianie Unipile, więc po Twojej stronie nie rejestrujesz aplikacji Meta, nie wnioskujesz o pages_messaging i nie przechodzisz App Review. To samo dotyczy Stron, którymi ten użytkownik zarządza.
Unipile zostało zaprojektowane w duchu Digital Markets Act. Każda osoba łączy własne konto Facebook, wiadomości są odczytywane i wysyłane w jej imieniu, a Unipile nie przechowuje profili użytkowników. Szczegóły na naszej stronie o Digital Markets Act.
Tak. Połączone konto prywatne nadal jest kontem Facebook podlegającym Warunkom Meta. Trzymaj się uzasadnionych zastosowań, takich jak odpowiadanie klientom, synchronizacja rozmów z CRM czy pomoc użytkownikowi w zarządzaniu własną skrzynką; masowe lub niechciane wiadomości mogą skutkować ograniczeniem konta.
Masz jeszcze pytania? Nasz zespół chętnie pomoże.
Porozmawiaj z ekspertem
