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

Twoja aplikacja Aktywne
FacebookAnna LeePrywatne FacebookNorthwind BakeryStrona
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
GETchats POSTmessages/send POSTchats/send 200 OK
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. 1

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

  2. 2

    Wysyłaj. Wywołaj POST /v2/{account_id}/chats/{chat_id}/messages/send z Twoim X-API-KEY i polem text.

  3. 3

    Nasłuchuj. Webhook message.new potwierdza wysłanie i dostarcza odpowiedzi.

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.

KryteriumMeta Send APIUnipile API
NadawcaStrona na FacebookuPrywatne konto użytkownika lub Strona, którą zarządza
KonfiguracjaAplikacja Meta, token Strony z pages_messaging, App Review, by obsługiwać Strony innych firmKlucz API i account_id z Hosted Auth, bez aplikacji Meta
Kto pisze pierwszyZawsze druga osobaKonto prywatne może; Strona tylko odpowiada
Okno24 godziny, do 7 dni po reklamie Click-to-MessengerBrak 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 firm
Unipile APIKlucz API i account_id z Hosted Auth, bez aplikacji Meta
Kto 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.

Facebook Żądanie Send API
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

Messenger
2POST

Meta wywołuje Twój webhook

zdarzenie messages
3PSID

Odczytaj ID nadawcy

messaging[0].sender.id
4POST

Odpowiedz przez Send API

recipient.id = PSID

W 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.com
POST/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.

Facebook Skrzynka prywatna · INBOX
Tom BeckerCzwartek o 10:00 mi pasuje.Prywatne
chat_id: {chat_id}
Facebook Skrzynka Strony · PAGE_<page_id>_INBOX
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/send
2Przyjęto

Unipile odpowiada

200 MessageSent
3Potwierdzono

Webhook: wysłano

message.new
4Potwierdzenia

Doręczono, potem przeczytano

message.receipt.delivery message.receipt.read
Facebook Zdarzenie message.new
type"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.

Facebook Webhook Messengera od Meta
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łądZnaczenieRozwiązanie
Meta 100Nieprawidłowy parametr lub tag wycofany 27 kwietnia 2026Sprawdź PSID, usuń tag
Meta 10 / 2018278Wiadomość wysłana poza dozwolonym oknemPoczekaj na nową wiadomość lub wyślij odpowiedź HUMAN_AGENT
Meta 200 / 2018028Nie można pisać do osób, które nie są administratorami, deweloperami ani testerami aplikacji: pages_messaging jeszcze niezatwierdzoneDokończ App Review, a w międzyczasie testuj z rolami aplikacji
Meta 551Ta osoba nie odbiera teraz od Ciebie wiadomościNie ponawiaj
Meta 613Przekroczony rate limitWysyłaj rzadziej
Unipile provider/access_restrictedFacebook odrzuca tego odbiorcę dla tego kontaNie ponawiaj
Unipile 403 api/insufficient_permissionsStrona nieaktywowana na koncieAktywuj ją przy ponownym połączeniu
Unipile 501 api/not_implementedStrona 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_AGENT
Meta 200 / 2018028
ZnaczenieNie można pisać do osób, które nie są administratorami, deweloperami ani testerami aplikacji: pages_messaging jeszcze niezatwierdzone
Rozwią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.

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

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