Send API Messengera: wysyłanie wiadomości ze strony na Facebooku
Strona na Facebooku wysyła wiadomości Messengera przez POST /{page-id}/messages, z tokenem dostępu strony. Pole recipient zawiera identyfikator osoby w zakresie strony (PSID), messaging_type to RESPONSE lub UPDATE w standardowym oknie wiadomości albo MESSAGE_TAG po jego zakończeniu, a message zawiera tekst lub załącznik, taki jak obraz, audio, wideo lub plik. Meta odpowiada identyfikatorami recipient_id i message_id.
easyCoexistence odpowiada na wiadomości prywatne w Messengerze przez send_social_dm z poziomu Claude, ChatGPT lub własnego kodu, w ramach 24-godzinnego okna, jako tekst; multimedia, szybkie odpowiedzi i szablony nie są objęte.
Wywołania Send API, które aplikacja może wykonać na stronę dla wiadomości z tekstem, linkami, reakcjami i naklejkami.
Wywołania Send API, które aplikacja może wykonać na stronę dla wiadomości zawierających audio lub wideo.
Największy zasób, jaki Messenger Platform zapisuje do ponownego użycia; obraz przesłany z adresu URL może mieć co najwyżej 8 MB.
Największa liczba obrazów, jaką jedna wiadomość może mieć w tablicy attachments, jedynym dozwolonym tu typie multimediów.
Jak długo zapisany attachment_id pozostaje ważny, zanim multimedia trzeba będzie przesłać ponownie.
Co zawiera żądanie Send API?
Meta wymienia sześć elementów, które musi zawierać wysyłka: identyfikator wysyłającej strony, identyfikator odbiorcy, token dostępu strony, zgodę tej osoby, typ wiadomości oraz treść. Żądanie to POST z JSON-em na /{page-id}/messages, a odpowiedź na wiadomość, która właśnie przyszła, wygląda tak:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Który identyfikator trafia do recipient?
Zwykle identyfikator w zakresie strony, czyli PSID, który Meta przypisuje osobie przy pierwszej wiadomości do strony. Pojawia się jako sender.id w webhooku messages. Obiekt recipient przyjmuje też inne rodzaje identyfikatorów w szczególnych przypadkach:
- id: PSID, unikalny dla tej osoby i tej strony.
user_ref: dla osoby, która użyła wtyczki lub przycisku postback, by napisać do strony.comment_idlubpost_id: dla prywatnej odpowiedzi na komentarz lub post odwiedzającego.- Identyfikatory z Facebook Login są powiązane z aplikacją i nie działają w Messenger Platform.
Jakiego messaging_type powinna użyć wiadomość?
Typ informuje Metę, dlaczego wiadomość jest wysyłana, i decyduje, kiedy wysyłka jest dozwolona. W dokumentacji Meta dotyczącej wiadomości stron wymienione są cztery wartości:
- RESPONSE: odpowiedź na wiadomość, którą strona otrzymała, promocyjna lub nie, w ramach standardowego okna wiadomości.
- UPDATE: wiadomość, którą strona wysyła z własnej inicjatywy, promocyjna lub nie, również w ramach okna.
MESSAGE_TAG: wiadomość niepromocyjna, wysłana po oknie, z tagiem odpowiadającym zatwierdzonemu przypadkowi użycia.- UTILITY: wiadomość użytkowa oparta na zatwierdzonym szablonie, na przykład aktualizacja zamówienia lub wizyty.
Co może zawierać wiadomość?
Tekst albo jeden obiekt załącznika z typem i payloadem. Załączniki obrazu, audio, wideo i pliku wskazują na URL lub zapisany attachment_id, a załączniki szablonów przenoszą uporządkowane wiadomości z przyciskami. Ten sam endpoint przyjmuje też:
- attachments: tablica do 30 obrazów wysyłanych jako jedna wiadomość.
reply_toz mid: odpowiedź na konkretną wcześniejszą wiadomość, osoby lub strony.quick_replies: do 13 przycisków nad polem pisania, każdy o tytule do 20 znaków.sender_action: wskaźnik pisania, oznaczenie jako przeczytane lub reakcja, wysyłane w osobnym żądaniu, a nie w samej wiadomości.notification_type: domyślnie REGULAR, alboSILENT_PUSHlubNO_PUSH.
Jak duże mogą być załączniki?
Przewodnik Meta po zapisywaniu zasobów wyznacza limity dla multimediów, które Messenger Platform pobiera i przechowuje: zasoby do 25 MB, obrazy do 8 MB przesłane z adresu URL, audio wysłane z odpowiednim Content-Type oraz wideo pobrane w ciągu 75 sekund. Ustawienie is_reusable na true zwraca attachment_id, który może ponownie użyć tylko strona, która go wysłała, przez 90 dni. Metoda POST /{page-id}/message_attachments przesyła multimedia z wyprzedzeniem.
Jakie są limity wywołań Send API?
Meta liczy je dla każdej strony osobno i według rodzaju treści. W dokumentacji wiadomości stron Meta kod 613, „wywołania do tego API przekroczyły limit częstotliwości”, należy do błędów wysyłki, więc gdy się pojawi, zwolnij zamiast ponawiać od razu:
- 300 wywołań na sekundę na stronę dla wiadomości z tekstem, linkami, reakcjami i naklejkami.
- 10 wywołań na sekundę na stronę dla wiadomości z audio lub wideo.
- Zbyt wiele wiadomości do jednego wątku może być ograniczane osobno.
- Łączna liczba wywołań API Messengera: 200 razy liczba zaangażowanych użytkowników, w ciągu kroczących 24 godzin.
- Powyżej 40 wiadomości na sekundę skrzynka strony przestaje pokazywać nowe wiadomości, a strona nie może wysyłać, dopóki wolumen nie spadnie.
Jakie błędy zwraca Send API?
Tabela błędów Messengera w dokumentacji Meta łączy każdy kod z podkodem wskazującym przyczynę. Oto te, które strona napotyka najczęściej podczas wysyłania:
- 10 z 2018278 lub 2534022: wiadomość wysłana poza dozwolonym oknem.
- 10 z 2018300: konwersację kontroluje inna aplikacja.
- 100: nieprawidłowy parametr, na przykład błędny identyfikator odbiorcy; podkod 2018001 oznacza: nie znaleziono pasującego użytkownika.
- 551: osoba jest niedostępna, być może zablokowała stronę lub dezaktywowała konto; 200 z 1545041 oznacza: ta osoba jest obecnie niedostępna.
- 200 z 2018028: aplikacja nie może pisać do osób spoza swoich ról, dopóki
pages_messagingnie przejdzie przeglądu i aplikacja nie stanie się aktywna. - 10904: strona ma wyłączone wiadomości w ustawieniach.
Jak easyCoexistence wysyła przez Send API?
send_social_dm przyjmuje account_id, recipient_id osoby, czyli sender.id w zdarzeniu messages, oraz tekst, i wysyła je na /{page-id}/messages z messaging_type RESPONSE. Wynikiem jest odpowiedź Meta z message_id, a odrzucona wysyłka wraca z kodem i komunikatem błędu Meta. Multimediów, szybkich odpowiedzi, szablonów i wskaźników akcji nie ma wśród narzędzi: send_social_dm wysyła tekst.
Typowe błędy
- Wysyłanie wskaźnika pisania razem z wiadomością. Meta chce samego sender_action z odbiorcą, a tekst lub szablony w osobnym żądaniu.
- Wysyłanie serii wiadomości do jednej osoby naraz. Meta może ograniczać pojedynczy wątek niezależnie od 300 wywołań na sekundę na stronę.
- Wysyłanie audio lub wideo w tempie tekstu. Wiadomości z audio lub wideo są ograniczone do 10 wywołań na sekundę na stronę.
- Ponowne użycie attachment_id starszego niż 90 dni. Zapisane identyfikatory załączników wygasają, więc po nowy trzeba ponownie przesłać multimedia.
Automatyzacje odpowiadają na nowe wiadomości samodzielnie, stałym tekstem lub odpowiedzią AI. Od US$ 9 za połączenie miesięcznie, spadając do US$ 0.75 wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy Send API Messengera jest bezpłatne?
Tak, dla standardowych wiadomości. Przegląd Meta określa Messenger Platform jako bezpłatny w użyciu, więc strona odpowiadająca osobom, które do niej napisały, nie płaci za wiadomości; wiadomości marketingowe są rozliczane za wiadomość.
Jakie zadanie strony jest potrzebne do wysyłania wiadomości?
Przegląd Messengera w dokumentacji Meta wymaga tokenu strony od kogoś, kto może wykonywać zadania MESSAGING i MODERATE, z przyznanym uprawnieniem pages_messaging.
Czy easyCoexistence może odpowiadać obrazami na Messengerze?
Nie dzisiaj. send_social_dm wysyła tekst, a żadne narzędzie nie wysyła załącznika.
Ile kosztuje easyCoexistence dla strony na Facebooku?
Każda podłączona strona to jedno połączenie, rozliczane od US$ 9 za połączenie miesięcznie, spadając do US$ 0.75 wraz z liczbą połączeń. Pierwsze 3 dni są bezpłatne.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w