
Tutorial
Facebook Messenger API: jak wysłać wiadomość w Node.js, Python i PHP
Zasady Send API od Meta w 2026 roku, a potem jedno wywołanie REST, by wysyłać wiadomości z własnych kont Twoich użytkowników.
Czat prywatny
Tom BeckerOd: Anna Lee
Możemy przełożyć demo?
Czwartek o 10:00 mi pasuje.
Wyświetlono
Czat Strony
Maya RossDo: Northwind Bakery
Dowozicie w niedziele?
Tak, od 9:00 do 12:00.
Dostarczono
GET
chats
POSTmessages/send
POSTchats/send
200 OK
Spis treści
Krótka odpowiedź
Wiadomość w Facebook Messengerze można wysłać przez API na dwa sposoby. Send API od Meta wysyła ze Strony na Facebooku, z Page access tokenem, i tylko do osób, które napisały do Strony w ciągu ostatnich 24 godzin. Ujednolicone API, takie jak Unipile, wysyła z połączonego konta Twojego użytkownika (konta prywatnego lub Strony, którą zarządza) jednym wywołaniem REST: POST /v2/{account_id}/chats/{chat_id}/messages/send.
POST/{PAGE-ID}/messagesMeta: odpowiedź jako Strona
POST/v2/{account_id}/chats/{chat_id}/messages/sendUnipile: odpowiedź w istniejącym czacie
POST/v2/{account_id}/chats/sendUnipile: pierwsza wiadomość
Z Unipile
Wyślij wiadomość w Messengerze w trzech krokach
- 1
Połącz. Twój użytkownik łączy swoje konto Facebook lub Stronę przez Hosted Auth. Bez aplikacji Meta i bez App Review.
- 2
Wysyłaj. Wywołaj
POST /v2/{account_id}/chats/{chat_id}/messages/sendz TwoimX-API-KEYi polemtext. - 3
Nasłuchuj. Webhook
message.newpotwierdza wysłanie i dostarcza odpowiedzi.
Kod w czterech językach: wysyłka z połączonego konta. Dokumentacja: Unipile V2, wysyłanie wiadomości.
Buduj teraz
Wybierz drogę
Dwa sposoby wysłania wiadomości w Messengerze przez API
Send API od Meta działa w imieniu Strony, którą zarządza Twoja aplikacja. Unipile działa w imieniu konta połączonego przez Twojego użytkownika końcowego.
| Kryterium | Meta Send API | Unipile API |
|---|---|---|
| Nadawca | Strona na Facebooku | Prywatne konto użytkownika lub Strona, którą zarządza |
| Konfiguracja | Aplikacja Meta, token Strony z pages_messaging, App Review, by obsługiwać Strony innych firm | Klucz API i account_id z Hosted Auth, bez aplikacji Meta |
| Kto pisze pierwszy | Zawsze druga osoba | Konto prywatne może; Strona tylko odpowiada |
| Okno | 24 godziny, do 7 dni po reklamie Click-to-Messenger | Brak okna Send API; Facebook może odrzucić odbiorcę |
Nadawca
Meta Send APIStrona na Facebooku
Unipile APIPrywatne konto użytkownika lub Strona, którą zarządza
Konfiguracja
Meta Send APIAplikacja Meta, token Strony z
pages_messaging, App Review, by obsługiwać Strony innych firmUnipile APIKlucz API i
account_id z Hosted Auth, bez aplikacji MetaKto pisze pierwszy
Meta Send APIZawsze druga osoba
Unipile APIKonto prywatne może; Strona tylko odpowiada
Okno
Meta Send API24 godziny, do 7 dni po reklamie Click-to-Messenger
Unipile APIBrak okna Send API; Facebook może odrzucić odbiorcę
Bot dla własnej Strony pasuje do drogi Meta; CRM, helpdesk lub agent AI w rozmowach Twoich klientów potrzebuje połączonego konta. Pełną mapę znajdziesz w materiale o tym, jak współgrają ze sobą API Facebooka.
Meta Send API
Jak wysłać wiadomość przez Facebook Graph API (Send API)
Oficjalna droga Meta to Send API w Messenger Platform: POST https://graph.facebook.com/v27.0/{PAGE-ID}/messages z Page access tokenem z uprawnieniem pages_messaging, polem recipient.id, messaging_type i obiektem message. Odpowiada tylko osobom, które napisały do Twojej Strony.
1
Utwórz aplikację Meta i powiąż Stronę
Dodaj Messengera, połącz Stronę.
2
Uzyskaj Page access token
Z pages_messaging; App Review, by obsługiwać inne firmy. Zobacz nasz przewodnik token dostępu API Facebook.
3
Wyślij żądanie
Adresuj osobę po jej PSID (Page-scoped ID), odczytanym z webhooka messages.
access_tokenPage access token
recipient.idPSID danej osoby
messaging_typeRESPONSE, UPDATE lub MESSAGE_TAG
message.text"Hello, world!"
responserecipient_id, message_id
POST
graph.facebook.com/v27.0/{PAGE-ID}/messages
200 OK
RESPONSE: odpowiedź w oknie czasowym.UPDATE: wiadomość z Twojej inicjatywy, w oknie czasowym.MESSAGE_TAG: poza oknem, z tagiem i treścią niepromocyjną.
Skąd pochodzi PSID
1Przychodząca
Osoba pisze do Twojej Strony
Messenger2POST
Meta wywołuje Twój webhook
zdarzenie messages3PSID
Odczytaj ID nadawcy
messaging[0].sender.id4POST
Odpowiedz przez Send API
recipient.id = PSIDW zdarzeniu messages pole sender.id to PSID danej osoby, a recipient.id to ID Twojej Strony. Skopiuj żądanie z zakładek Meta cURL, Node.js, Python i PHP w bloku kodu poniżej.
Źródła: dokumentacja Meta Send a Message i zdarzenie webhooka messages. Ostatnia weryfikacja: 17 listopada 2026.
Zasady
24-godzinne okno Messengera i tagi wiadomości w 2026
Send API pisze tylko do osób, które napisały do Strony, przez 24 godziny od ich ostatniej wiadomości lub do 7 dni po reklamie Click-to-Messenger. Później HUMAN_AGENT obejmuje odpowiedź człowieka w ciągu 7 dni, a trzy tagi aktualizacji kończą się błędem 100 od 27 kwietnia 2026 roku.
Start
Osoba pisze
To otwiera standardowe okno.
0–24 h
Okno otwarte
Wysyłaj z RESPONSE lub UPDATE.
Do 7 dni
Agent ludzki
HUMAN_AGENT: tag dla odpowiedzi napisanej przez człowieka.
Później
Okno zamknięte
Poczekaj na nową wiadomość.
Wycofane 27 kwietnia 2026
Żądania z tagami CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE lub POST_PURCHASE_UPDATE kończą się teraz błędem o kodzie 100.
Źródła: od Meta Send API reference oraz Send a Message. Ostatnia weryfikacja: listopad 2026.
Tutorial
Wyślij wiadomość w Facebook Messengerze z połączonego konta (Node.js, Python, PHP, cURL)
Twój użytkownik raz łączy swoje konto Facebook, a Ty otrzymujesz account_id. Wylistuj jego czaty, a potem wyślij wiadomość w wybranym chat_id. Żądania trafiają do https://api.unipile.com z Twoim kluczem w nagłówku X-API-KEY, przez Facebook Messenger API od Unipile. Zakładki Meta wysyłają tę samą odpowiedź przez Send API Meta, ze Strony, którą zarządzasz.
1
Połącz konto
Użytkownik loguje się na stronie Hosted Auth. Szczegóły w naszym przewodniku Messenger API dla kont prywatnych.
2
Wylistuj czaty
GET /v2/{account_id}/chats zwraca do 100 czatów na stronę.
3
Wyślij wiadomość
Jeden POST z polem text.
# 1. List chats
curl --request GET \
--url 'https://api.unipile.com/v2/acc_123456789/chats?limit=20' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json'
# 2. Send a message
curl --request POST \
--url https://api.unipile.com/v2/acc_123456789/chats/CHAT_ID/messages/send \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{ "text": "Thanks, your order ships today." }'
// npm i @unipile/sdk
import { UnipileMessaging } from '@unipile/sdk';
const request_options = {
baseUrl: 'https://api.unipile.com',
headers: { 'X-API-KEY': 'YOUR_API_KEY' },
throwOnError: true,
};
const messagingApi = new UnipileMessaging();
// 1. List chats
const chats = await messagingApi.getChatsList({
...request_options,
path: { account_id: 'acc_123456789' },
query: { limit: 20 },
});
// 2. Send a message
await messagingApi.sendMessage({
...request_options,
path: { account_id: 'acc_123456789', chat_id: 'CHAT_ID' },
body: { text: 'Thanks, your order ships today.' },
});
import unipile
configuration = unipile.Configuration()
configuration.api_key["apiKey"] = "YOUR_API_KEY"
api_client = unipile.ApiClient(configuration)
messaging_api = unipile.MessagingApi(api_client)
# 1. List chats
chats = messaging_api.get_chats_list("acc_123456789", limit=20)
# 2. Send a message
messaging_api.send_message(
"CHAT_ID",
"acc_123456789",
{"text": "Thanks, your order ships today."},
)
<?php
$base = 'https://api.unipile.com/v2/acc_123456789';
$headers = ['X-API-KEY: YOUR_API_KEY', 'accept: application/json'];
// 1. List chats
$ch = curl_init("$base/chats?limit=20");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => true,
]);
$chats = json_decode(curl_exec($ch), true);
curl_close($ch);
// 2. Send a message
$ch = curl_init("$base/chats/CHAT_ID/messages/send");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array_merge($headers, ['content-type: application/json']),
CURLOPT_POSTFIELDS => json_encode(['text' => 'Thanks, your order ships today.']),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true);
curl_close($ch);
# Meta Send API: reply to a person who messaged your Page
curl -X POST \
"https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"recipient": { "id": "PSID" },
"messaging_type": "RESPONSE",
"message": { "text": "Thanks, your order ships today." }
}'
// Node.js 18+: built-in fetch, no SDK
const url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages'
+ '?access_token=' + process.env.PAGE_ACCESS_TOKEN;
const res = await fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
recipient: { id: 'PSID' },
messaging_type: 'RESPONSE',
message: { text: 'Thanks, your order ships today.' },
}),
});
const data = await res.json(); // { recipient_id, message_id }
# pip install requests
import requests
resp = requests.post(
"https://graph.facebook.com/v27.0/PAGE_ID/messages",
params={"access_token": "PAGE_ACCESS_TOKEN"},
json={
"recipient": {"id": "PSID"},
"messaging_type": "RESPONSE",
"message": {"text": "Thanks, your order ships today."},
},
)
print(resp.json()) # {"recipient_id": "...", "message_id": "..."}
<?php
$url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN';
$payload = [
'recipient' => ['id' => 'PSID'],
'messaging_type' => 'RESPONSE',
'message' => ['text' => 'Thanks, your order ships today.'],
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true); // recipient_id, message_id
curl_close($ch);
200 OK · { "object": "MessageSent", "message_id": "..." }
200 OK · { "recipient_id": "PAGE-SCOPED-ID", "message_id": "AG5Hz2U..." }
Pierwsze cztery zakładki wywołują Unipile dla połączonego konta; to samo żądanie działa dla LinkedIn, WhatsApp, Instagrama i Telegrama. Zakładki Meta wywołują Send API Meta dla Twojej własnej Strony, z Page access tokenem i PSID danej osoby (jak uzyskać PSID). Dokumentacja: Unipile Facebook, Send messages i Meta Send a Message (v27.0, weryfikacja 17 listopada 2026).
Pierwsza wiadomość
Jak rozpocząć nową rozmowę w Messengerze przez API
Gdy czat jeszcze nie istnieje, wywołaj POST /v2/{account_id}/chats/send z ID osoby w users_ids i swoim text. Send API od Meta tego nie potrafi.
Bazowy URL
https://api.unipile.comPOST/v2/{account_id}/chats/sendStart a Chat
users_idsID osoby lub Strony
text„Cześć Tom, krótkie pytanie”
attachmentsOpcjonalne pliki
SDK: startChat (Node.js), start_chat (Python)
200 OK
Odpowiedź zwraca nowe chat_id i message_id.
Jeśli Facebook nie pozwala temu kontu pisać do tej osoby, żądanie kończy się błędem provider/access_restricted.
Ograniczenia skrzynki Strony
Strona nie może rozpocząć rozmowy (501 api/not_implemented) ani usuwać swoich wiadomości.
Strony
Jak odpowiadać jako Strona na Facebooku przez API
Strona zarządzana przez użytkownika odpowiada przez to samo account_id: wylistuj skrzynki, otwórz skrzynkę Strony, a potem wyślij wiadomość z ID czatu Strony. Jak Strony i ich tokeny działają po stronie Meta, opisujemy w przewodniku Facebook Page API.
Tom BeckerCzwartek o 10:00 mi pasuje.Prywatne
chat_id:
{chat_id}Maya RossDowozicie w niedziele?Strona
chat_id:
PAGE_<page_id>_<thread_key>GET/v2/{account_id}/inboxesListuje skrzynki Stron
GET/v2/{account_id}/inboxes/{inbox_id}/chatsListuje czaty Strony
POST/v2/{account_id}/chats/PAGE_1357020157484056_100001234567890/messages/sendOdpowiada jako Strona
Ogólna lista czatów zwraca tylko czaty prywatne. Prefiks PAGE_ sprawia, że Unipile działa jako Strona. Szczegóły w dokumentacji Facebook Pages.
Załączniki
Wysyłanie zdjęć i plików w czacie Messengera
Dodaj tablicę attachments do tego samego endpointu wysyłki. Dla dużych plików użyj multipart.
POST/v2/{account_id}/chats/{chat_id}/messages/sendSend a Message
textOpcjonalny podpis, może być ""
contentPlik zakodowany w base64
content_type"image/png"
filename"image.png"
Duży plik: multipart/form-data
200 OK
Czaty szyfrowane. W prywatnych czatach z szyfrowaniem end-to-end każdy plik jest wysyłany jako osobna wiadomość.
Odpowiednik w Meta. Send API przyjmuje obiekt attachment z polami type i url, do 30 zdjęć na jedną wysyłkę.
Czas rzeczywisty
Potwierdzaj doręczenie i odbieraj odpowiedzi przez webhooki
Kod 200 oznacza, że Facebook przyjął wiadomość, a nie że została doręczona. Doręczenie potwierdza zdarzenie webhooka message.new, które dostarcza też odpowiedzi.
1POST
Twoja aplikacja wysyła
messages/send2Przyjęto
Unipile odpowiada
200 MessageSent3Potwierdzono
Webhook: wysłano
message.new4Potwierdzenia
Doręczono, potem przeczytano
message.receipt.delivery message.receipt.readtype"message.new"
account_idPołączone konto
payloadObiekt Message: id, chat_id, sender_id, text, timestamp, is_sender
Wywoływane dla wiadomości wysłanych i odebranych; sprawdź is_sender.
Kieruj zdarzenia Stron według prefiksu PAGE_<page_id>_ w ich chat_id, który może różnić się od tego z API. Konfiguracja w Configure a webhook.
Po stronie Meta bot Strony zbudowany na Send API potrzebuje własnego webhooka Messengera. To w nim odczytujesz też PSID przed odpowiedzią.
Źródło: dokumentacja Meta Messenger webhooks. Ostatnia weryfikacja: 17 listopada 2026.
WeryfikacjaGET z hub.mode=subscribe i Twoim hub.verify_token: zwróć hub.challenge
PodpisX-Hub-Signature-256: SHA256 payloadu z Twoim App Secret
Polamessages, message_deliveries
Odpowiedź200 OK w ciągu 5 sekund
Błędy
Błędy przy wysyłaniu wiadomości w Messengerze
Większość błędów wysyłki wynika z zasad: ponowna próba znów się nie powiedzie. Token bez pages_messaging blokuje każde wywołanie Send API.
| Błąd | Znaczenie | Rozwiązanie |
|---|---|---|
| Meta 100 | Nieprawidłowy parametr lub tag wycofany 27 kwietnia 2026 | Sprawdź PSID, usuń tag |
| Meta 10 / 2018278 | Wiadomość wysłana poza dozwolonym oknem | Poczekaj na nową wiadomość lub wyślij odpowiedź HUMAN_AGENT |
| Meta 200 / 2018028 | Nie można pisać do osób, które nie są administratorami, deweloperami ani testerami aplikacji: pages_messaging jeszcze niezatwierdzone | Dokończ App Review, a w międzyczasie testuj z rolami aplikacji |
| Meta 551 | Ta osoba nie odbiera teraz od Ciebie wiadomości | Nie ponawiaj |
| Meta 613 | Przekroczony rate limit | Wysyłaj rzadziej |
Unipile provider/access_restricted | Facebook odrzuca tego odbiorcę dla tego konta | Nie ponawiaj |
Unipile 403 api/insufficient_permissions | Strona nieaktywowana na koncie | Aktywuj ją przy ponownym połączeniu |
Unipile 501 api/not_implemented | Strona rozpoczęła czat lub usunęła wiadomość | Odpowiedz w istniejącym czacie |
Meta 100
ZnaczenieNieprawidłowy parametr lub tag wycofany 27 kwietnia 2026
RozwiązanieSprawdź PSID, usuń tag
Meta 10 / 2018278
ZnaczenieWiadomość wysłana poza dozwolonym oknem
RozwiązaniePoczekaj na nową wiadomość lub wyślij odpowiedź
HUMAN_AGENTMeta 200 / 2018028
ZnaczenieNie można pisać do osób, które nie są administratorami, deweloperami ani testerami aplikacji:
pages_messaging jeszcze niezatwierdzoneRozwiązanieDokończ App Review, a w międzyczasie testuj z rolami aplikacji
Meta 551
ZnaczenieTa osoba nie odbiera teraz od Ciebie wiadomości
RozwiązanieNie ponawiaj
Meta 613
ZnaczeniePrzekroczony rate limit
RozwiązanieWysyłaj rzadziej
Unipile provider/access_restricted
ZnaczenieFacebook odrzuca tego odbiorcę dla tego konta
RozwiązanieNie ponawiaj
Unipile 403 api/insufficient_permissions
ZnaczenieStrona nieaktywowana na koncie
RozwiązanieAktywuj ją przy ponownym połączeniu
Unipile 501 api/not_implemented
ZnaczenieStrona rozpoczęła czat lub usunęła wiadomość
RozwiązanieOdpowiedz w istniejącym czacie
Źródła: od Meta Messenger error codes oraz od Unipile error responses. Ostatnia weryfikacja: 17 listopada 2026.
Zgodność
Każdy użytkownik wysyła z własnego konta
Unipile to niezależna firma, a nie oficjalna aplikacja Meta ani Meta Partner. Działa w imieniu uwierzytelnionych użytkowników, których nadal obowiązują warunki Meta. Korzystaj z niej do obsługi klienta, CRM i bezpośrednich rozmów.
Wyślij pierwszą wiadomość
Send API od Meta sprawdzi się w bocie na własnej Stronie. Aby wysyłać wiadomości przez Facebook Messenger API z własnych kont Twoich użytkowników, połącz te konta przez Unipile.
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
Wszystkie endpointy API Facebooka w jednym miejscu
Wiadomości to tylko jedna część. Zobacz wszystkie endpointy Facebooka dostępne w Unipile, od postów i komentarzy po profile i webhooki, lub przeczytaj kompletny przewodnik po API Facebook.
Facebook Messenger API: wysyłanie wiadomości, FAQ
Szybkie odpowiedzi o wysyłaniu wiadomości w Messengerze przez API.
Nie. Send API dociera tylko do osób, które napisały do Twojej Strony, w oknie czasowym, a Strona nigdy nie pisze pierwsza. Nową rozmowę trzeba rozpocząć z połączonego konta prywatnego, na przykład przez POST /v2/{account_id}/chats/send w Unipile.
Meta nie podaje oficjalnego SDK Python dla Send API: wyślij POST do /{PAGE-ID}/messages biblioteką requests, jak w zakładce Meta Python powyżej. Unipile udostępnia SDK Python, importowane jako unipile, z metodami get_chats_list i send_message.
Wyślij żądanie HTTP POST przez cURL lub Guzzle: do /{PAGE-ID}/messages w Graph API z Page access tokenem (zakładka Meta PHP) albo do /v2/{account_id}/chats/{chat_id}/messages/send w Unipile z Twoim X-API-KEY (zakładka PHP).
Zainstaluj @unipile/sdk i wywołaj sendMessage z account_id, chat_id i text, jak w zakładce Node.js powyżej. W Send API od Meta wyślij POST do /{PAGE-ID}/messages przez fetch, jak w zakładce Meta Node.js.
W Send API: zamknięte okno (błąd 10, kod podrzędny 2018278), tag wycofany 27 kwietnia 2026 roku (błąd 100), token bez zatwierdzonego pages_messaging (błąd 200, kod podrzędny 2018028) lub osoba, która blokuje Twoje wiadomości (błąd 551). W Unipile: provider/access_restricted, gdy Facebook odrzuca odbiorcę, albo Strona próbująca rozpocząć rozmowę.
W przypadku bota Strony na platformie Meta Twój endpoint odpowiada na weryfikację GET, zwracając hub.challenge, sprawdza podpis X-Hub-Signature-256 za pomocą App Secret i subskrybuje messages; sender.id każdego zdarzenia to PSID, któremu odpowiadasz. W Unipile rejestrujesz jeden URL i otrzymujesz zdarzenia message.new dla wszystkich połączonych kont.
Nie. Unipile to niezależna firma: nie jest Meta Partner i nie jest wspierana, sponsorowana ani zatwierdzona przez Meta. Zakładki Meta na tej stronie wywołują publiczne Send API samej Meta; pozostałe zakładki wywołują API Unipile. Facebook i Messenger są znakami towarowymi Meta Platforms, Inc.
Nie. Aplikacja Meta, token Strony i App Review dotyczą wyłącznie ścieżki Send API. W Unipile Twoi użytkownicy łączą własne konto Facebook lub Strony, którymi zarządzają, przez hostowane uwierzytelnianie, a Ty wysyłasz wiadomości z account_id i swoim kluczem API.
Unipile zostało zaprojektowane w duchu Digital Markets Act: każdy użytkownik łączy własne konto, a wiadomości wychodzą w jego imieniu, w jego własnych rozmowach, bez przechowywania profili użytkowników przez Unipile. Szczegóły na naszej stronie o Digital Markets Act.
Tak. Każde połączone konto nadal podlega Warunkom korzystania z usług Meta. Wysyłaj wiadomości w uzasadnionych celach, takich jak odpowiedzi w obsłudze klienta, działania następcze w CRM i rozmowy, których ludzie się spodziewają; masowe niezamówione wiadomości i spam mogą skutkować ograniczeniem konta.
Masz jeszcze pytania? Nasz zespół chętnie pomoże.
Porozmawiaj z ekspertem
