PL
Przewodnik dla programistów

Przewodnik po API Facebook: Graph API, dostęp, ograniczenia i połączone konta

Co obejmują API Facebooka od Meta w 2026 roku, jak uzyskać tokeny dostępu i przejść App Review, czego oficjalne API już nie pozwala robić oraz jak aplikacja SaaS może zamiast tego łączyć własne konta Facebook swoich użytkowników.

Twoja aplikacja Na żywo
FacebookAnna LeePrywatne FacebookNorthwind BakeryStrona
Post
Northwind BakeryJako Strona · Przed chwilą

Nasze jesienne menu startuje w poniedziałek.

243
Julia NashChleb dyniowy wrócił!
Wiadomości
Maya RossDo Northwind Bakery
Czy dowozicie w niedziele?
Tak, od 9 do 12.
Wyświetlono
Webhooki Nowa wiadomość Nowa reakcja
GETchats POSTmessages/send POSTposts 200 OK
Krótka odpowiedź

Tak, Facebook ma API: to Graph API, interfejs HTTP firmy Meta do odczytu i zapisu danych Facebooka. Na nim zbudowane są produkty takie jak Pages API, Messenger Platform i Marketing API. Dostęp uzyskuje się przez aplikację Meta, tokeny dostępu przyznane przez użytkowników lub Strony oraz uprawnienia zatwierdzone w App Review.

Ten przewodnik przypisuje każde API Facebooka do typu konta, którego dotyczy, wyjaśnia zasady dostępu i ograniczenia, wymienia funkcje usunięte przez Meta, a następnie pokazuje inny model dla aplikacji SaaS: każdy użytkownik łączy własne konto Facebook przez Facebook Messenger API od Unipile.

Definicja

Czy istnieje API Facebook?

Tak. Meta udostępnia dane Facebooka programistom przez Graph API, wersjonowane API HTTP. Każdy inny produkt deweloperski Facebooka, od zarządzania Stronami po Messengera i reklamy, to zestaw endpointów Graph API z własnymi uprawnieniami i własnym procesem weryfikacji.

Nie ma jednego klucza API. To, co otrzymujesz, zależy od tego, czyich danych dotyczysz: osoby, która loguje się do Twojej aplikacji, Strony na Facebooku, którą zarządza, lub konta reklamowego. Każdy przypadek ma własny typ tokena i własną weryfikację po stronie Meta.

Facebook Czyje dane odczytujesz?
UżytkownikUser access token z Facebook Login, ograniczony do uprawnień przyznanych przez daną osobę.
StronaPage access token dla osoby, która ma przypisane zadanie na tej Stronie.
Konto reklamoweDostęp do Marketing API przez firmę i jej użytkowników systemowych.
Graph API

Czym jest Facebook Graph API?

Graph API to API HTTP, na którym opiera się każda integracja z Facebookiem. Wszystkie żądania trafiają na graph.facebook.com, a niemal każdy endpoint wymaga tokena dostępu. Dane są zorganizowane w graf węzłów, krawędzi i pól.

Węzły

Obiekty

Pojedynczy obiekt z identyfikatorem: użytkownik, Strona, post, komentarz, zdjęcie. Przykład: GET /{page-id}.

Krawędzie

Powiązania

Kolekcje przypięte do węzła, na przykład posty Strony lub komentarze pod postem. Przykład: GET /{page-id}/feed.

Pola

Właściwości

Dane, o które prosisz dla węzła, wybierane parametrem fields. Przykład: ?fields=id,message,created_time.

Wersje i Graph API Explorer

Każde żądanie może wskazać wersję w ścieżce, na przykład /v27.0/, wydaną 4 listopada 2026. Meta publikuje kilka wersji rocznie i utrzymuje każdą przez co najmniej dwa lata, więc warto planować aktualizacje: changelog podaje datę, do której każda wersja pozostaje dostępna. Graph API Explorer pozwala przetestować wywołania przed napisaniem kodu, a karta Meta Graph API w przykładzie kodu poniżej pokazuje pierwsze żądanie: odczyt feedu Strony.

Źródło: changelog Graph API od Meta, w którym najnowszą wersją była v27.0 (wprowadzona 4 listopada 2026). Ostatnia weryfikacja: 17 listopada 2026.

Mapa

API Facebooka w skrócie

Każde API Facebooka obsługuje jeden rodzaj konta. Wybór właściwego zaczyna się od prostego pytania: działasz w imieniu osoby, Strony czy reklamodawcy?

APIDo czego służyObsługiwane kontoWymagany dostęp
Graph APIOdczyt i zapis obiektów FacebookaUżytkownicy, Strony, firmyAplikacja Meta, token dostępu, uprawnienia
Pages APIPublikowanie postów, moderowanie komentarzy, odczyt danych Strony. Przewodnik: API postów FacebookStrony na FacebookuPage access token, zadania na Stronie, App Review
Messenger PlatformWysyłanie i odbieranie rozmów StronyStrony na Facebooku i profesjonalne konta InstagramToken Strony, uprawnienie do wiadomości, App Review
Marketing APITworzenie reklam i odczyt ich wynikówKonta reklamoweWeryfikacja firmy, uprawnienia reklamowe
Conversions APIWysyłanie zdarzeń webowych i offline na potrzeby reklamFirmy prowadzące reklamyPiksel lub zbiór danych, token użytkownika systemowego
Facebook LoginLogowanie osób do Twojej aplikacjiUżytkownicy FacebookaAplikacja Meta ze skonfigurowanym Facebook Login
Graph API
Do czego służyOdczyt i zapis obiektów Facebooka
KontoUżytkownicy, Strony, firmy
DostępAplikacja Meta, token dostępu, uprawnienia
Pages API
Do czego służyPublikowanie postów, moderowanie komentarzy, odczyt danych Strony. Przewodnik: API postów Facebook
KontoStrony na Facebooku
DostępPage access token, zadania na Stronie, App Review
Messenger Platform
Do czego służyWysyłanie i odbieranie rozmów Strony
KontoStrony na Facebooku i profesjonalne konta Instagram
DostępToken Strony, uprawnienie do wiadomości, App Review
Marketing API
Do czego służyTworzenie reklam i odczyt ich wyników
KontoKonta reklamowe
DostępWeryfikacja firmy, uprawnienia reklamowe
Conversions API
Do czego służyWysyłanie zdarzeń webowych i offline na potrzeby reklam
KontoFirmy prowadzące reklamy
DostępPiksel lub zbiór danych, token użytkownika systemowego
Facebook Login
Do czego służyLogowanie osób do Twojej aplikacji
KontoUżytkownicy Facebooka
DostępAplikacja Meta ze skonfigurowanym Facebook Login

Wiadomości na Instagramie przechodzą przez tę samą Messenger Platform: zobacz nasz przewodnik po Messenger API dla Instagrama. WhatsApp ma własną platformę, opisaną w przewodniku po WhatsApp API.

Decyzja

Którego API Facebooka potrzebujesz?

Zacznij od tego, co robi Twój produkt, a nie od listy API. Każda poniższa sytuacja wskazuje jedno API i jego wymagania dostępowe.

Publikujesz na własnej Stronie

Pages API

Page access token od administratora Strony, zadania na Stronie, App Review. Przewodnik po API Stron na Facebooku.

Odpowiadasz osobom, które piszą do Twojej Strony

Messenger Platform

Token Strony, pages_messaging, 24-godzinne okno wiadomości.

Prowadzisz lub mierzysz reklamy

Marketing API i Conversions API

Dostęp do konta reklamowego, weryfikacja firmy, użytkownicy systemowi.

Pozwalasz logować się przez Facebooka

Facebook Login

Aplikacja Meta ze skonfigurowanym Facebook Login.

Użytkownicy łączą własne konta w Twoim SaaS

API Unipile

Konta osobiste i Strony, którymi zarządzają, przez hostowane uwierzytelnianie.

Dostęp

Jak uzyskać dostęp do API Facebook

Nie ma samodzielnego klucza API. Tworzysz aplikację Meta, użytkownicy przyznają jej tokeny dostępu przez Facebook Login, a Meta weryfikuje żądane uprawnienia, zanim aplikacja zacznie obsługiwać publiczność.

1

Załóż konto deweloperskie Meta

Zarejestruj się w Meta for Developers przy użyciu swojego konta Facebook.

2

Utwórz aplikację Meta

Wybierz typ aplikacji i przypadek użycia, a następnie zapisz App ID i App Secret.

3

Dodaj Facebook Login for Business

Użytkownicy i administratorzy Stron logują się i przyznają uprawnienia Twojej aplikacji.

4

Poproś o uprawnienia

Na przykład pages_show_list, pages_manage_posts lub pages_messaging.

5

Przejdź App Review

Advanced Access jest wymagany, zanim z aplikacji skorzystają osoby bez roli w niej.

Tokeny dostępu: użytkownika, Strony, aplikacji i użytkownika systemowego

TokenDziała w imieniuTypowe zastosowanie
User access tokenDziała w imieniu osoby zalogowanej do Twojej aplikacjiDomyślnie krótkotrwały, można go wymienić na token długoterminowy
Page access tokenDziała w imieniu Strony, pobierany z /me/accountsWymagany przez większość endpointów Pages API i Messengera
App access tokenDziała w imieniu samej aplikacjiUstawienia aplikacji i część danych publicznych
System user tokenDziała w imieniu firmy, bez udziału osobyZadania serwer-serwer, reklamy i Strony należące do firmy
User access token
Działa w imieniuDziała w imieniu osoby zalogowanej do Twojej aplikacji
Typowe zastosowanieDomyślnie krótkotrwały, można go wymienić na token długoterminowy
Page access token
Działa w imieniuDziała w imieniu Strony, pobierany z /me/accounts
Typowe zastosowanieWymagany przez większość endpointów Pages API i Messengera
App access token
Działa w imieniuDziała w imieniu samej aplikacji
Typowe zastosowanieUstawienia aplikacji i część danych publicznych
System user token
Działa w imieniuDziała w imieniu firmy, bez udziału osoby
Typowe zastosowanieZadania serwer-serwer, reklamy i Strony należące do firmy

Czas ważności zależy od typu. Według Meta krótkotrwałe tokeny użytkownika działają zwykle od jednej do dwóch godzin, a długoterminowe około 60 dni, natomiast tokeny użytkownika systemowego można ustawić tak, by nie wygasały z upływem czasu; Meta zastrzega, że te okresy mogą się zmienić bez uprzedzenia. Pełny opis, od wygenerowania tokenu po jego wymianę i debugowanie, znajdziesz w naszym przewodniku token dostępu API Facebook, a token dostępu do Strony na Facebooku omawia przewodnik po Page API.

Uprawnienia, zadania na Stronie i App Review

Większość endpointów Pages API wymaga Page access token od osoby, która może wykonywać zadanie na Stronie, na przykład CREATE_CONTENT lub MODERATE. W trybie deweloperskim z aplikacji mogą korzystać tylko osoby mające w niej rolę. Aby obsługiwać innych użytkowników, każde uprawnienie potrzebuje Advanced Access, przyznawanego po App Review, a aplikacje biznesowe często wymagają też weryfikacji firmy.

Źródła: przewodnik po tokenach dostępu i omówienie Pages API od Meta. Ostatnia weryfikacja: 17 listopada 2026.

Czas rzeczywisty

Webhooki API Facebook: zdarzenia w czasie rzeczywistym

Zamiast odpytywania Meta wysyła zdarzenia na Twój endpoint HTTPS: nowe wiadomości do Strony, potwierdzenia odczytu i reakcje. Konfiguracja zajmuje cztery kroki.

1

Zweryfikuj endpoint

Meta wysyła żądanie GET z parametrami hub.mode, hub.verify_token i hub.challenge. Sprawdź token i zwróć wartość challenge.

2

Zasubskrybuj Stronę

Wywołaj POST /{page-id}/subscribed_apps z Page access token i potrzebnymi polami, np. messages.

3

Weryfikuj każdy payload

Każde zdarzenie zawiera nagłówek X-Hub-Signature-256, czyli podpis SHA256 utworzony z użyciem Twojego App Secret.

4

Odpowiadaj szybko

Zwracaj 200 OK bez zwłoki. W przypadku Messengera Meta oczekuje odpowiedzi w ciągu 5 sekund i wyłącza subskrypcję po godzinie błędów.

Facebook Pola webhooka Messengera
messagesKtoś wysyła wiadomość do Strony
message_readsOdbiorca przeczytał Twoją wiadomość
message_deliveriesTwoja wiadomość została dostarczona
message_reactionsOdbiorca zareagował na wiadomość
messaging_postbacksOdbiorca kliknął przycisk lub pozycję menu
POST /{page-id}/subscribed_apps success

Z Unipile rejestrujesz jeden adres URL webhooka i otrzymujesz nowe, edytowane i usunięte wiadomości, potwierdzenia odczytu oraz reakcje dla każdego połączonego konta Facebook, w tym samym formacie co dla pozostałych kanałów.

Źródła: przewodnik Webhooks getting started i webhooki Messengera od Meta. Ostatnia weryfikacja: listopad 2026.

Ograniczenia

Czego oficjalne API Facebook nie pozwala robić

Kilka funkcji, których oczekuje się od API Facebooka, zostało usuniętych lub nigdy nie było dostępnych dla aplikacji zewnętrznych. Wiedza o nich na starcie oszczędza tygodnie pracy projektowej.

  • Publikowanie na profilu osobistym. Uprawnienie publish_actions zostało wycofane 24 kwietnia 2018 r., a aplikacje utraciły je 1 sierpnia 2018 r. Aplikacje mogą publikować na Stronach, ale nie na osobistej osi czasu użytkownika.
  • Korzystanie z Grup na Facebooku. Meta wycofała Groups API wraz z Graph API v19.0 23 stycznia 2024 r., łącznie z uprawnieniem publish_to_groups.
  • Wysyłanie wiadomości z konta osobistego. Messenger Platform pozwala odpowiadać ludziom Stronie na Facebooku lub profesjonalnemu kontu Instagram. Standardowe okno wiadomości trwa 24 godziny od ostatniej wiadomości danej osoby. Zobacz, jak to działa z API Facebook Messenger dla kont prywatnych.

Źródła: changelog Facebook Login, ogłoszenie Graph API v19.0 i omówienie Messenger Platform od Meta. Ostatnia weryfikacja: listopad 2026.

Potrzebujesz rozmów własnych użytkowników?

Jeśli Twoja aplikacja potrzebuje Messengera, postów i komentarzy z kont, które użytkownicy łączą samodzielnie, zobacz Facebook Messenger API od Unipile.

Rate limits

Rate limits i wersjonowanie API Facebook

Graph API zlicza wywołania w dwóch systemach, zależnie od używanego tokena.

Limit platformy 200 x użytkownicy wywołań na godzinę Wywołania z tokenem użytkownika lub aplikacji, liczone względem liczby użytkowników Twojej aplikacji.
Business Use Case, Strony 4800 x zaangażowani użytkownicy wywołań na 24 godziny Wywołania endpointów Stron z tokenem Strony lub użytkownika systemowego.

Odczytuj nagłówki użycia zwracane przez Meta z każdą odpowiedzią, zwalniaj przed osiągnięciem limitu i aktualizuj wersję Graph API, zanim używana wersja zostanie wycofana.

Źródło: przewodnik po rate limiting od Meta. Ostatnia weryfikacja: listopad 2026.

Błędy

Najczęstsze błędy API Facebook i jak je naprawić

Błędy Graph API zwracają code, często także error_subcode, oraz fbtrace_id do przekazania wsparciu Meta. Przed ponowną próbą sprawdź kod: tylko część błędów znika z czasem.

KodCo oznaczaCo zrobić
190Token dostępu wygasł lub jest nieprawidłowy (subkody 463, 467)Pobierz nowy token; poproś użytkownika o ponowne zalogowanie. Zobacz przewodnik token dostępu API Facebook
10, 200 do 299Uprawnienie nieprzyznane lub odebranePoproś ponownie o uprawnienie, sprawdź App Review
4, 17, 613Zbyt wiele wywołań dla aplikacji lub użytkownikaWstrzymaj wywołania, potem ponów z backoffem
100Nieprawidłowy parametr lub identyfikatorSprawdź wysyłany identyfikator i token
368Tymczasowa blokada za naruszenie zasadOdczekaj, potem przeanalizuj wysłane treści
506Zduplikowany postZmień treść przed ponowną publikacją
10 / 2018278Wiadomość wysłana poza dozwolonym oknemOdpowiadaj tylko wtedy, gdy okno wiadomości jest otwarte
Kod 190
Co oznaczaToken dostępu wygasł lub jest nieprawidłowy (subkody 463, 467)
Co zrobićPobierz nowy token; poproś użytkownika o ponowne zalogowanie. Zobacz przewodnik token dostępu API Facebook
Kod 10, 200 do 299
Co oznaczaUprawnienie nieprzyznane lub odebrane
Co zrobićPoproś ponownie o uprawnienie, sprawdź App Review
Kod 4, 17, 613
Co oznaczaZbyt wiele wywołań dla aplikacji lub użytkownika
Co zrobićWstrzymaj wywołania, potem ponów z backoffem
Kod 100
Co oznaczaNieprawidłowy parametr lub identyfikator
Co zrobićSprawdź wysyłany identyfikator i token
Kod 368
Co oznaczaTymczasowa blokada za naruszenie zasad
Co zrobićOdczekaj, potem przeanalizuj wysłane treści
Kod 506
Co oznaczaZduplikowany post
Co zrobićZmień treść przed ponowną publikacją
Kod 10 / 2018278
Co oznaczaWiadomość wysłana poza dozwolonym oknem
Co zrobićOdpowiadaj tylko wtedy, gdy okno wiadomości jest otwarte

Źródła: obsługa błędów Graph API i kody błędów Messengera od Meta. Ostatnia weryfikacja: listopad 2026.

Cennik

Czy API Facebook jest darmowe?

W większości tak. Meta nie sprzedaje dostępu do Graph API. Płaci się za reklamy, niektóre typy wiadomości oraz czas inżynierów potrzebny na zbudowanie i utrzymanie integracji.

Dostęp do Graph APIBez opłatMeta nie pobiera opłat za wywołania Graph API. Twój koszt to konfiguracja aplikacji, App Review i utrzymanie.
Rozmowy w MessengerzeBezpłatneMeta określa Messenger Platform jako bezpłatną; wiadomości marketingowe są rozliczane przez Twoje konto reklamowe.
ReklamyTwój budżet reklamowyWywołania Marketing API są bezpłatne, ale tworzone przez nie kampanie są płatne jak każda inna reklama.

Koszty według typu wiadomości, zmiany w rozliczeniach w 2026 roku i rzeczywisty koszt utrzymania aplikacji Meta omawiamy w przewodniku po cenach, który szczegółowo odpowiada na pytanie, czy API Facebook jest darmowe. Jeśli użytkownicy łączą własne konta przez Unipile, płacisz zamiast tego Unipile za połączone konto: zobacz cennik API.

Dokumentacja

Gdzie znaleźć dokumentację API Facebook

Cała oficjalna dokumentacja znajduje się w Meta for Developers. Meta przenosi swoje strony do developers.facebook.com/documentation/, a kilka starszych linków /docs/ przekierowuje już tam. Te sześć stron odpowiada na większość pytań o integrację; informacje o Instagramie, WhatsAppie, Threads, reklamach i AI znajdą Państwo w naszym przewodniku po API Meta.

Z Unipile

Inny model: połącz własne konta Facebook swoich użytkowników

Systemy CRM, helpdeski, agenci AI i wielokanałowe skrzynki potrzebują rozmów i postów z własnych kont użytkowników. Z Unipile każdy użytkownik łączy swoje konto Facebook przez hostowaną stronę uwierzytelniania, a Twoja aplikacja wywołuje w jego imieniu jedno REST API, bez aplikacji Meta i App Review po Twojej stronie.

Twoja aplikacja Zsynchronizowano
Połączone konta
FacebookAnna LeeKonto osobiste
FacebookNorthwind BakeryStrona
Połącz konto
Skrzynka 2StronaOsobiste
Leo MartinCzy sklep jest dziś otwarty?Strona
Sara KimWysłano zdjęcieOsobiste
Book clubTom: Do zobaczenia o 19Grupa
Omar HaddadWyświetlonoStrona
Opublikowano jako Strona
Northwind BakeryPrzed chwilą

Nasze jesienne menu startuje w poniedziałek.

24 reakcje2 komentarze
Julia NashChlebek dyniowy wrócił!
Ben TorresPrzyjmujecie zamówienia z wyprzedzeniem?
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
ObszarCo obejmuje API Unipile dla Facebooka
PołączenieHosted Auth lub Custom Auth, z danymi logowania użytkownika i uwierzytelnianiem dwuskładnikowym, ciasteczkami przeglądarki lub rozszerzeniem UniLogin
WiadomościLista czatów i wiadomości, rozpoczynanie czatu, wysyłanie wiadomości i załączników, edycja, usuwanie, przekazywanie, reakcje, potwierdzenia odczytu, czaty grupowe
Posty i komentarzeOdczyt, tworzenie, edycja i usuwanie postów; lista, dodawanie, odpowiadanie, edycja i usuwanie komentarzy; reakcje na posty i komentarze
Użytkownicy i relacjeProfile, obserwujący i obserwowani, zaproszenia do znajomych (wysyłanie, akceptowanie, odrzucanie, anulowanie)
WebhookiNowe, zaktualizowane i usunięte wiadomości, potwierdzenia odczytu i dostarczenia, nowe reakcje, aktualizacje czatów
Strony na FacebookuOdczyt wiadomości Strony, którą zarządza użytkownik, odpowiadanie na nie i publikowanie postów jako Strona. Strona nie może rozpocząć rozmowy ani usuwać swoich wiadomości
NieobsługiwaneRelacje (Stories), przypięte wiadomości, blokowanie użytkowników
Połączenie
Hosted Auth lub Custom Auth, z danymi logowania użytkownika i uwierzytelnianiem dwuskładnikowym, ciasteczkami przeglądarki lub rozszerzeniem UniLogin
Wiadomości
Lista czatów i wiadomości, rozpoczynanie czatu, wysyłanie wiadomości i załączników, edycja, usuwanie, przekazywanie, reakcje, potwierdzenia odczytu, czaty grupowe
Posty i komentarze
Odczyt, tworzenie, edycja i usuwanie postów; lista, dodawanie, odpowiadanie, edycja i usuwanie komentarzy; reakcje na posty i komentarze
Użytkownicy i relacje
Profile, obserwujący i obserwowani, zaproszenia do znajomych (wysyłanie, akceptowanie, odrzucanie, anulowanie)
Webhooki
Nowe, zaktualizowane i usunięte wiadomości, potwierdzenia odczytu i dostarczenia, nowe reakcje, aktualizacje czatów
Strony na Facebooku
Odczyt wiadomości Strony, którą zarządza użytkownik, odpowiadanie na nie i publikowanie postów jako Strona. Strona nie może rozpocząć rozmowy ani usuwać swoich wiadomości
Nieobsługiwane
Relacje (Stories), przypięte wiadomości, blokowanie użytkowników

Użytkownicy mogą połączyć osobiste konto Facebook, a Strony, którymi zarządzają, stają się dostępne przez te same endpointy. To samo API obsługuje też LinkedIn, WhatsApp, Instagram, Telegram, e-mail i kalendarze. Pełna lista w tabeli funkcji dostawców.

Lista czatów i wysyłanie wiadomości

Gdy użytkownik połączy konto, otrzymujesz account_id. Każde wywołanie używa Twojego klucza API Unipile w nagłówku X-API-KEY. Druga karta pokazuje dla porównania pierwsze wywołanie Graph API od Meta: odczyt najnowszych postów Strony przy użyciu Page access token.

# 1. Lista czatów Facebook połączonego konta
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. Odpowiedź w jednym z tych czatów
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": "Dziękujemy za wiadomość, zamówienie wyślemy dziś." }'
# Read the 3 latest posts of a Page (Graph API v27.0)
# Needs a Page access token with pages_read_engagement and pages_read_user_content
curl "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?fields=id,message,created_time&limit=3&access_token={PAGE_ACCESS_TOKEN}"

# Response (abridged)
{ "data": [ {
    "id": "{PAGE_ID}_{POST_ID}",
    "message": "Our autumn menu starts Monday.",
    "created_time": "2026-11-16T09:30:00+0000"
  } ],
  "paging": {
    "cursors": { "before": "{CURSOR}", "after": "{CURSOR}" },
    "next": "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?..."
  } }
200 OK · wiadomość wysłana z konta użytkownika
200 OK · posty jednej Strony, jeden token Strony na Stronę

Konfiguracja krok po kroku w Facebook quickstart. Żądanie Graph API sprawdzone 17 listopada 2026 w dokumentacji referencyjnej Page feed od Meta.

Zgodność

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

Unipile to niezależna firma, a nie oficjalna aplikacja Meta ani Meta Partner. Działa w imieniu uwierzytelnionych użytkowników, a Twoich użytkowników nadal obowiązują warunki Meta. Korzystaj z niej w uzasadnionych scenariuszach, takich jak obsługa klienta, CRM i bezpośrednie rozmowy.

Referencja API

Endpointy API Facebook w Unipile

Krótka odpowiedź

Unipile udostępnia Facebooka przez jedno REST API. Jego endpointy V2 obejmują czaty i wiadomości Messengera, posty, komentarze, reakcje, profile, zaproszenia do znajomych, Strony na Facebooku i webhooki. Każde wywołanie wskazuje połączone konto przez jego account_id, więc jedna integracja obsługuje konto osobiste i zarządzane przez nie Strony, bez aplikacji Meta po Twojej stronie.

AkcjaMetoda i ścieżkaOsobiste / StronaPrzewodnik
Wiadomości
Lista czatówGET/v2/{account_id}/chatsOsobisteMessenger dla kont osobistych
Lista wiadomości czatuGET/v2/{account_id}/chats/{chat_id}/messagesOsobiste + Strona
Pobieranie załącznikaGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Osobiste + Strona
Rozpoczęcie nowego czatuPOST/v2/{account_id}/chats/sendOsobisteJak wysłać wiadomość w Messengerze
Wysłanie wiadomości, tekstu lub załącznikówPOST/v2/{account_id}/chats/{chat_id}/messages/sendOsobiste + Strona
Lista, dodawanie lub usuwanie reakcji na wiadomościGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsOsobiste
Oznaczenie wiadomości jako przeczytanejPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readOsobiste
Posty
Lista postów użytkownika lub StronyGET/v2/{account_id}/users/{user_id}/postsOsobiste + StronaPrzewodnik po API postów na Facebooku
Pobranie postaGET/v2/{account_id}/posts/{post_id}Osobiste + Strona
Utworzenie postaPOST/v2/{account_id}/postsOsobiste + Strona
Edycja lub usunięcie postaPATCHDELETE/v2/{account_id}/posts/{post_id}Osobiste + Strona
Komentarze
Lista komentarzy pod postemGET/v2/{account_id}/posts/{post_id}/commentsOsobisteOdczyt komentarzy i odpowiedzi
Lista odpowiedzi na komentarzGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesOsobiste
Dodanie komentarzaPOST/v2/{account_id}/posts/{post_id}/commentsOsobiste
Odpowiedź na komentarzPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Osobiste
Edycja lub usunięcie komentarzaPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Osobiste
Reakcje
Lista, dodawanie lub usuwanie reakcji na postyGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsOsobisteReakcje w przewodniku po komentarzach
Lista, dodawanie lub usuwanie reakcji na komentarzeGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsOsobiste
Profile i relacje
Pobranie profiluGET/v2/{account_id}/users/{user_id}OsobisteSynchronizacja kontaktów z CRM
Lista znajomychGET/v2/{account_id}/users/me/relationsOsobiste
Lista obserwujących lub obserwowanychGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingOsobiste
Wysyłanie lub lista zaproszeń do znajomychPOSTGET/v2/{account_id}/users/me/relation-requestsOsobiste
Akceptowanie, odrzucanie lub anulowanie zaproszeniaPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelOsobiste
Strony na Facebooku
Znalezienie Stron kontaGET/v2/{account_id}/inboxesStronaPraktyczny przewodnik po API Stron na Facebooku
Lista czatów StronyGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsStrona
Odpowiedź jako StronaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendStrona
Publikacja posta jako StronaPOST/v2/{account_id}/posts z post_asStrona
Webhooki
Rejestracja endpointu webhookaPOST/v2/webhooks/endpointsOsobiste + StronaSynchronizacja CRM w czasie rzeczywistym przez webhooki
Zdarzenia wiadomościmessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newOsobiste + Strona
Zdarzenia czatówchat.update, chat.deleteOsobiste
Wiadomości
Lista czatówGET/v2/{account_id}/chatsOsobiste
Lista wiadomości czatuGET/v2/{account_id}/chats/{chat_id}/messagesOsobiste + Strona
Pobieranie załącznikaGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Osobiste + Strona
Rozpoczęcie nowego czatuPOST/v2/{account_id}/chats/sendOsobiste
Wysłanie wiadomości, tekstu lub załącznikówPOST/v2/{account_id}/chats/{chat_id}/messages/sendOsobiste + Strona
Lista, dodawanie lub usuwanie reakcji na wiadomościGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsOsobiste
Oznaczenie wiadomości jako przeczytanejPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readOsobiste
Posty
Lista postów użytkownika lub StronyGET/v2/{account_id}/users/{user_id}/postsOsobiste + Strona
Pobranie postaGET/v2/{account_id}/posts/{post_id}Osobiste + Strona
Utworzenie postaPOST/v2/{account_id}/postsOsobiste + Strona
Edycja lub usunięcie postaPATCHDELETE/v2/{account_id}/posts/{post_id}Osobiste + Strona
Komentarze
Lista komentarzy pod postemGET/v2/{account_id}/posts/{post_id}/commentsOsobiste
Lista odpowiedzi na komentarzGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesOsobiste
Dodanie komentarzaPOST/v2/{account_id}/posts/{post_id}/commentsOsobiste
Odpowiedź na komentarzPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Osobiste
Edycja lub usunięcie komentarzaPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Osobiste
Reakcje
Lista, dodawanie lub usuwanie reakcji na postyGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsOsobiste
Lista, dodawanie lub usuwanie reakcji na komentarzeGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsOsobiste
Profile i relacje
Pobranie profiluGET/v2/{account_id}/users/{user_id}Osobiste
Lista znajomychGET/v2/{account_id}/users/me/relationsOsobiste
Lista obserwujących lub obserwowanychGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingOsobiste
Wysyłanie lub lista zaproszeń do znajomychPOSTGET/v2/{account_id}/users/me/relation-requestsOsobiste
Akceptowanie, odrzucanie lub anulowanie zaproszeniaPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelOsobiste
Strony na Facebooku
Znalezienie Stron kontaGET/v2/{account_id}/inboxesStrona
Lista czatów StronyGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsStrona
Odpowiedź jako StronaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendStrona
Publikacja posta jako StronaPOST/v2/{account_id}/posts z post_asStrona
Webhooki
Rejestracja endpointu webhookaPOST/v2/webhooks/endpointsOsobiste + Strona
Zdarzenia wiadomościmessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newOsobiste + Strona
Zdarzenia czatówchat.update, chat.deleteOsobiste

Uwierzytelnianie. Każde żądanie zawiera Twój klucz API Unipile w nagłówku X-API-KEY. Twoi użytkownicy łączą własne konto Facebook przez Hosted Auth, więc nie tworzysz aplikacji Meta, nie przechodzisz App Review i nie przechowujesz tokenu Strony. Porównaj to z tokenem dostępu API Facebook, a koszty sprawdź w zestawieniu cennika API Messengera.

Endpointy pochodzą z dokumentacji Unipile V2 dla Facebooka i jej tabeli funkcji dostawców. Ostatnia weryfikacja: 17 listopada 2026.

Zastosowania

API Facebook według zastosowań

Większość integracji z Facebookiem należy do jednej z tych grup. Oto jak każda z nich wygląda wewnątrz produktu.

Twój CRM
KontaktySzanse
KontaktEtap
Julia ChenCzy demo jest aktualne?KwalifikowanyFacebook
Lucas MeyerProszę o wycenęOfertaFacebook
Sofia RiveraPodpisane, dzięki!WygranaFacebook
Daniel MoreauPogadajmy w poniedziałekNowyFacebook

Integracja Facebook Messengera z CRM

Synchronizuj rozmowy z kartami kontaktów, aby zespoły sprzedaży i wsparcia odpowiadały z poziomu CRM. Zobacz integrację Facebook Messenger z CRM.

Każda rozmowa zapisana przy właściwym kontakcie, bez kopiowania i wklejania.

Twój helpdesk
ZgłoszeniaKlienci
ZgłoszenieStatus
Mia OwensGdzie jest moje zamówienie? #4521OtwarteFacebook
Elena GarciaZwrot otrzymany #4498RozwiązaneFacebook
Gabriel LopezZdjęcie w załączniku #4530OczekujeFacebook
Anna RossiNie mogę się zalogować #4476OtwarteFacebook

Czat na Facebooku i Messenger

Odpowiadaj osobom, które piszą do Strony przez Messenger Platform, lub kontaktom połączonego konta. Zobacz, jak wysłać wiadomość.

Zapytania z Facebooka obsługiwane w dotychczasowym narzędziu wsparcia.

Twoje narzędzie social media
Opublikuj jakoFacebookNorthwind BakeryFacebookAnna Lee
Świeży chleb na zakwasie codziennie od 7:00.
Opublikuj
Nasze jesienne menu startuje w poniedziałekStrona · DziśOpublikowano
Dziękujemy za 10 wspaniałych lat!Strona · 2 paźEdytowano

API postów na Facebooku

Twórz, edytuj i odczytuj posty. Oficjalne API publikuje tylko na Stronach, a połączone konto może publikować jako jego użytkownik. Przeczytaj przewodnik po API postów na Facebooku.

Posty pisane, publikowane i edytowane z poziomu Twojego produktu.

Twoje narzędzie community
Komentarze pod postem Anna Lee: Nasze jesienne menu startuje w poniedziałek
KomentarzTemat
Ben TorresPrzyjmujecie zamówienia z wyprzedzeniem?PytanieFacebook
Julia NashChlebek dyniowy wrócił!OpiniaFacebook
Kai OkaforCzy jest bezglutenowy?PytanieFacebook
Priya RaoCzy możemy zarezerwować dla 20 osób?SprzedażFacebook

API komentarzy na Facebooku

Wyświetlaj komentarze pod postem, a następnie odpowiadaj, edytuj lub usuwaj je z własnego połączonego konta użytkownika. Komentarze zawsze pochodzą z tego konta, nigdy ze Strony: komentowanie jako Strona odbywa się przez Pages API od Meta. Przeczytaj przewodnik po API komentarzy na Facebooku.

Pytania pod postem wychwycone i przekazane właściwemu zespołowi.

API Stron na Facebooku

Publikuj i moderuj treści Strony na Facebooku, z Page access token i odpowiednimi zadaniami na Stronie. Przeczytaj przewodnik po API Stron na Facebooku.

Cennik Facebook Messenger API

Meta określa Messenger Platform jako bezpłatną, a wiadomości marketingowe są rozliczane w ramach reklam. Prawdziwym kosztem jest czas integracji i weryfikacji. Zobacz pełne omówienie.

Budujesz jedną skrzynkę dla wielu sieci? Przeczytaj, jak działa ujednolicone API do wiadomości, oraz nasz przewodnik po API Instagram dla drugiej sieci Meta.

Wybierz właściwe API dla swojego produktu

Graph API od Meta to właściwe narzędzie, gdy Twoja aplikacja zarządza własnymi Stronami lub reklamami. Gdy produkt potrzebuje rozmów i postów z własnego konta każdego użytkownika, połącz te konta przez Unipile 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. Nasze podejście do Digital Markets Act

API Facebook: FAQ

Szybkie odpowiedzi o kluczach, wersjach, poziomach dostępu, partnerstwie z Meta, zgodności i Grupach.

Programiści używają go do zarządzania Stronami na Facebooku (posty, komentarze, statystyki), odpowiadania na rozmowy Stron przez Messenger Platform, prowadzenia i mierzenia reklam oraz logowania użytkowników przez Facebook Login. Każde z tych zastosowań opiera się na produkcie Graph API z własnymi uprawnieniami.

Nie ma jednego klucza. Utwórz aplikację Meta w Meta for Developers, aby otrzymać App ID i App Secret, a następnie uzyskaj tokeny dostępu: tokeny użytkownika przez Facebook Login, tokeny Stron z /me/accounts. Uprawnienia używane przez publiczność wymagają Advanced Access po App Review.

Graph API to podstawowe API HTTP dla obiektów Facebooka, takich jak użytkownicy, Strony, posty i komentarze. Marketing API to zestaw endpointów Graph API dla kont reklamowych, kampanii, grup odbiorców i raportowania, z własnymi uprawnieniami i wymaganiami biznesowymi.

Nie przez oficjalne API Meta: aplikacje utraciły uprawnienie publish_actions 1 sierpnia 2018 r. i mogą publikować tylko na Stronach. Z Unipile użytkownik, który połączy własne konto Facebook, może tworzyć z niego posty przez endpointy Posts, zgodnie z warunkami Meta.

Nie. Meta wycofała Groups API wraz z Graph API v19.0 w styczniu 2024 r., łącznie z uprawnieniem publish_to_groups. Unipile również nie obsługuje Grup na Facebooku.

W listopadzie 2026 r. changelog Meta wskazywał v27.0 jako najnowszą wersję Graph API. Meta publikuje kilka wersji rocznie i utrzymuje każdą przez co najmniej dwa lata, więc przed przypięciem wersji sprawdź changelog Graph API.

Nie. Unipile to niezależna firma, która działa obok Graph API od Meta, a nie dla Meta. Nie jest Meta Partner ani oficjalną aplikacją Meta i nie jest wspierana, sponsorowana ani zatwierdzona przez Meta. Facebook i Messenger są znakami towarowymi Meta Platforms, Inc.

Nie. Kroki opisane w tym przewodniku, czyli aplikacja Meta, Facebook Login i App Review, dotyczą oficjalnego API Meta. Z Unipile każdy użytkownik łączy własne konto Facebook oraz Strony, którymi zarządza, przez hostowaną stronę uwierzytelniania, więc po Twojej stronie te kroki odpadają.

Zostało zaprojektowane w duchu Digital Markets Act: zamiast jednej aplikacji odczytującej wiele kont każdy użytkownik łączy własne konto, a Unipile działa w jego imieniu, bez przechowywania profili użytkowników. Szczegóły na naszej stronie o Digital Markets Act.

Tak. Niezależnie od tego, czy wywołujesz Graph API, czy Unipile, konta Facebook nadal podlegają Warunkom korzystania z usług Meta. Trzymaj się uzasadnionych zastosowań, takich jak obsługa klienta, CRM i rozmowy, których ludzie oczekują; spam i nieautoryzowana automatyzacja mogą skutkować ograniczeniem konta.

Twoja aplikacja jest nadal ograniczona do osób, które mają w niej rolę. Przy Standard Access uprawnienia można wymagać tylko od administratorów, programistów i testerów aplikacji. Aby obsługiwać Strony innych osób, każde uprawnienie potrzebuje Advanced Access, zatwierdzanego w App Review, a Meta wymaga do tego Business Verification.

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

Porozmawiaj z ekspertem