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

Twój CRM Połączono
Tom ReyesFacebookAnna 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
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. 1

    Połącz. Twój użytkownik łączy własne konto Facebook przez Hosted Auth. Bez aplikacji Meta i bez App Review.

  2. 2

    Wysyłaj. Wywołaj API V2 z nagłówkiem X-API-KEY:POST/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send

  3. 3

    Odbieraj. Przychodzące wiadomości trafiają do Twojego webhooka jako zdarzenia message.new.

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
Facebook

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
Facebook

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.

TematStrona przez Messenger PlatformKonto prywatne przez Unipile
KontoStrona na Facebooku lub profesjonalne konto InstagramWłasne prywatne konto Facebook użytkownika
Kto łączyAdministrator Strony, przez Facebook Login for BusinessWłaściciel konta, przez Hosted Auth lub Custom Auth
Co ma Twoja aplikacjaPage access tokenTwój klucz API Unipile i account_id użytkownika
Aplikacja Meta i App ReviewAplikacja Meta oraz App Review, aby obsługiwać cudze StronyBez aplikacji Meta i bez App Review po Twojej stronie
Kto pisze pierwszyOsoba pisze do StronyUżytkownik może odpowiedzieć lub rozpocząć nową rozmowę
Zdarzenia w czasie rzeczywistymWebhooki Messengera w Twojej aplikacji MetaNowe, 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żytkownika
Aplikacja 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
Twoja aplikacja Połączono
FacebookAnna Lee, konto prywatne
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
Twoja aplikacja Połączono
Tom ReyesFacebookAnna 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łanieGraph API z user access tokenKonto prywatne połączone przez Unipile
Odczyt wiadomości użytkownika w MessengerzeNie, żadne uprawnienie użytkownika nie obejmuje skrzynkiTak, czaty, wiadomości i załączniki
Publikowanie na profilu użytkownikaNie, publish_actions usunięto w 2018 rokuTak, tworzenie, edycja i usuwanie postów
Odpowiadanie na wiadomościNie, Messenger Platform obsługuje StronyTak, 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 roku
Połą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.

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