
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.
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
GET
chats
POSTmessages/send
POSTposts
200 OK
Spis treści
Podstawy
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.
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?
| API | Do czego służy | Obsługiwane konto | Wymagany dostęp |
|---|---|---|---|
| Graph API | Odczyt i zapis obiektów Facebooka | Użytkownicy, Strony, firmy | Aplikacja Meta, token dostępu, uprawnienia |
| Pages API | Publikowanie postów, moderowanie komentarzy, odczyt danych Strony. Przewodnik: API postów Facebook | Strony na Facebooku | Page access token, zadania na Stronie, App Review |
| Messenger Platform | Wysyłanie i odbieranie rozmów Strony | Strony na Facebooku i profesjonalne konta Instagram | Token Strony, uprawnienie do wiadomości, App Review |
| Marketing API | Tworzenie reklam i odczyt ich wyników | Konta reklamowe | Weryfikacja firmy, uprawnienia reklamowe |
| Conversions API | Wysyłanie zdarzeń webowych i offline na potrzeby reklam | Firmy prowadzące reklamy | Piksel lub zbiór danych, token użytkownika systemowego |
| Facebook Login | Logowanie osób do Twojej aplikacji | Użytkownicy Facebooka | Aplikacja 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
| Token | Działa w imieniu | Typowe zastosowanie |
|---|---|---|
| User access token | Działa w imieniu osoby zalogowanej do Twojej aplikacji | Domyślnie krótkotrwały, można go wymienić na token długoterminowy |
| Page access token | Działa w imieniu Strony, pobierany z /me/accounts | Wymagany przez większość endpointów Pages API i Messengera |
| App access token | Działa w imieniu samej aplikacji | Ustawienia aplikacji i część danych publicznych |
| System user token | Działa w imieniu firmy, bez udziału osoby | Zadania 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/accountsTypowe 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.
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_actionszostał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.
| Kod | Co oznacza | Co zrobić |
|---|---|---|
| 190 | Token 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 299 | Uprawnienie nieprzyznane lub odebrane | Poproś ponownie o uprawnienie, sprawdź App Review |
| 4, 17, 613 | Zbyt wiele wywołań dla aplikacji lub użytkownika | Wstrzymaj wywołania, potem ponów z backoffem |
| 100 | Nieprawidłowy parametr lub identyfikator | Sprawdź wysyłany identyfikator i token |
| 368 | Tymczasowa blokada za naruszenie zasad | Odczekaj, potem przeanalizuj wysłane treści |
| 506 | Zduplikowany post | Zmień treść przed ponowną publikacją |
| 10 / 2018278 | Wiadomość wysłana poza dozwolonym oknem | Odpowiadaj 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.
Omówienie Graph APIKoncepcje, żądania, tokeny
Dokumentacja referencyjna Graph APIWszystkie węzły i krawędzie
Changelog Graph APIWersje i daty wycofania
Tokeny dostępuTokeny użytkownika, Strony, aplikacji i użytkownika systemowego
Pages APIPosty, komentarze i zadania na Stronie
Messenger PlatformRozmowy Strony i webhooki
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.
Połączone konta
Anna LeeKonto osobiste
Northwind 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
| Obszar | Co obejmuje API Unipile dla Facebooka |
|---|---|
| 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 |
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.
| Akcja | Metoda i ścieżka | Osobiste / Strona | Przewodnik |
|---|---|---|---|
| Wiadomości | |||
| Lista czatów | GET/v2/{account_id}/chats | Osobiste | Messenger dla kont osobistych |
| Lista wiadomości czatu | GET/v2/{account_id}/chats/{chat_id}/messages | Osobiste + Strona | |
| Pobieranie załącznika | GET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id} | Osobiste + Strona | |
| Rozpoczęcie nowego czatu | POST/v2/{account_id}/chats/send | Osobiste | Jak wysłać wiadomość w Messengerze |
| Wysłanie wiadomości, tekstu lub załączników | POST/v2/{account_id}/chats/{chat_id}/messages/send | Osobiste + Strona | |
| Lista, dodawanie lub usuwanie reakcji na wiadomości | GETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactions | Osobiste | |
| Oznaczenie wiadomości jako przeczytanej | POST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/read | Osobiste | |
| Posty | |||
| Lista postów użytkownika lub Strony | GET/v2/{account_id}/users/{user_id}/posts | Osobiste + Strona | Przewodnik po API postów na Facebooku |
| Pobranie posta | GET/v2/{account_id}/posts/{post_id} | Osobiste + Strona | |
| Utworzenie posta | POST/v2/{account_id}/posts | Osobiste + Strona | |
| Edycja lub usunięcie posta | PATCHDELETE/v2/{account_id}/posts/{post_id} | Osobiste + Strona | |
| Komentarze | |||
| Lista komentarzy pod postem | GET/v2/{account_id}/posts/{post_id}/comments | Osobiste | Odczyt komentarzy i odpowiedzi |
| Lista odpowiedzi na komentarz | GET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/replies | Osobiste | |
| Dodanie komentarza | POST/v2/{account_id}/posts/{post_id}/comments | Osobiste | |
| Odpowiedź na komentarz | POST/v2/{account_id}/posts/{post_id}/comments/{comment_id} | Osobiste | |
| Edycja lub usunięcie komentarza | PATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id} | Osobiste | |
| Reakcje | |||
| Lista, dodawanie lub usuwanie reakcji na posty | GETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactions | Osobiste | Reakcje w przewodniku po komentarzach |
| Lista, dodawanie lub usuwanie reakcji na komentarze | GETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactions | Osobiste | |
| Profile i relacje | |||
| Pobranie profilu | GET/v2/{account_id}/users/{user_id} | Osobiste | Synchronizacja kontaktów z CRM |
| Lista znajomych | GET/v2/{account_id}/users/me/relations | Osobiste | |
| Lista obserwujących lub obserwowanych | GET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/following | Osobiste | |
| Wysyłanie lub lista zaproszeń do znajomych | POSTGET/v2/{account_id}/users/me/relation-requests | Osobiste | |
| Akceptowanie, odrzucanie lub anulowanie zaproszenia | POST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancel | Osobiste | |
| Strony na Facebooku | |||
| Znalezienie Stron konta | GET/v2/{account_id}/inboxes | Strona | Praktyczny przewodnik po API Stron na Facebooku |
| Lista czatów Strony | GET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chats | Strona | |
| Odpowiedź jako Strona | POST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/send | Strona | |
| Publikacja posta jako Strona | POST/v2/{account_id}/posts z post_as | Strona | |
| Webhooki | |||
| Rejestracja endpointu webhooka | POST/v2/webhooks/endpoints | Osobiste + Strona | Synchronizacja CRM w czasie rzeczywistym przez webhooki |
| Zdarzenia wiadomości | message.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.new | Osobiste + Strona | |
| Zdarzenia czatów | chat.update, chat.delete | Osobiste | |
Wiadomości
Lista czatówGET
/v2/{account_id}/chatsOsobisteLista wiadomości czatuGET
/v2/{account_id}/chats/{chat_id}/messagesOsobiste + StronaPobieranie załącznikaGET
/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Osobiste + StronaRozpoczęcie nowego czatuPOST
/v2/{account_id}/chats/sendOsobisteWysłanie wiadomości, tekstu lub załącznikówPOST
/v2/{account_id}/chats/{chat_id}/messages/sendOsobiste + StronaLista, dodawanie lub usuwanie reakcji na wiadomościGETPOSTDELETE
/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsOsobisteOznaczenie wiadomości jako przeczytanejPOST
/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readOsobistePrzewodniki: Messenger dla kont osobistych i jak wysłać wiadomość w Messengerze
Posty
Lista postów użytkownika lub StronyGET
/v2/{account_id}/users/{user_id}/postsOsobiste + StronaPobranie postaGET
/v2/{account_id}/posts/{post_id}Osobiste + StronaUtworzenie postaPOST
/v2/{account_id}/postsOsobiste + StronaEdycja lub usunięcie postaPATCHDELETE
/v2/{account_id}/posts/{post_id}Osobiste + StronaPrzewodnik: Przewodnik po API postów na Facebooku
Komentarze
Lista komentarzy pod postemGET
/v2/{account_id}/posts/{post_id}/commentsOsobisteLista odpowiedzi na komentarzGET
/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesOsobisteDodanie komentarzaPOST
/v2/{account_id}/posts/{post_id}/commentsOsobisteOdpowiedź na komentarzPOST
/v2/{account_id}/posts/{post_id}/comments/{comment_id}OsobisteEdycja lub usunięcie komentarzaPATCHDELETE
/v2/{account_id}/posts/{post_id}/comments/{comment_id}OsobistePrzewodnik: odczyt komentarzy i odpowiedzi
Reakcje
Lista, dodawanie lub usuwanie reakcji na postyGETPOSTDELETE
/v2/{account_id}/posts/{post_id}/reactionsOsobisteLista, dodawanie lub usuwanie reakcji na komentarzeGETPOSTDELETE
/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsOsobistePrzewodnik: reakcje w przewodniku po komentarzach
Profile i relacje
Pobranie profiluGET
/v2/{account_id}/users/{user_id}OsobisteLista znajomychGET
/v2/{account_id}/users/me/relationsOsobisteLista obserwujących lub obserwowanychGET
/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingOsobisteWysyłanie lub lista zaproszeń do znajomychPOSTGET
/v2/{account_id}/users/me/relation-requestsOsobisteAkceptowanie, odrzucanie lub anulowanie zaproszeniaPOST
/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelOsobistePrzewodnik: synchronizacja kontaktów z CRM
Strony na Facebooku
Znalezienie Stron kontaGET
/v2/{account_id}/inboxesStronaLista czatów StronyGET
/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsStronaOdpowiedź jako StronaPOST
/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendStronaPublikacja posta jako StronaPOST
/v2/{account_id}/posts z post_asStronaPrzewodnik: Praktyczny przewodnik po API Stron na Facebooku
Webhooki
Rejestracja endpointu webhookaPOST
/v2/webhooks/endpointsOsobiste + StronaZdarzenia wiadomości
message.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newOsobiste + StronaZdarzenia czatów
chat.update, chat.deleteOsobisteUwierzytelnianie. 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.
KontaktySzanse
KontaktEtap
Julia ChenCzy demo jest aktualne?Kwalifikowany
Lucas MeyerProszę o wycenęOferta
Sofia RiveraPodpisane, dzięki!Wygrana
Daniel MoreauPogadajmy w poniedziałekNowy
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.
ZgłoszeniaKlienci
ZgłoszenieStatus
Mia OwensGdzie jest moje zamówienie? #4521Otwarte
Elena GarciaZwrot otrzymany #4498Rozwiązane
Gabriel LopezZdjęcie w załączniku #4530Oczekuje
Anna RossiNie mogę się zalogować #4476Otwarte
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.
Opublikuj jako
Northwind Bakery
Anna 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.
Komentarze pod postem Anna Lee: Nasze jesienne menu startuje w poniedziałek
KomentarzTemat
Ben TorresPrzyjmujecie zamówienia z wyprzedzeniem?Pytanie
Julia NashChlebek dyniowy wrócił!Opinia
Kai OkaforCzy jest bezglutenowy?Pytanie
Priya RaoCzy możemy zarezerwować dla 20 osób?Sprzedaż
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.
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
