Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

300 per second

Wywołania Send API, które aplikacja może wykonać na stronę dla wiadomości z tekstem, linkami, reakcjami i naklejkami.

10 per second

Wywołania Send API, które aplikacja może wykonać na stronę dla wiadomości zawierających audio lub wideo.

25 MB

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.

30 images

Największa liczba obrazów, jaką jedna wiadomość może mieć w tablicy attachments, jedynym dozwolonym tu typie multimediów.

90 days

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:

A text reply, and Meta's answer
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_id lub post_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_to z 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, albo SILENT_PUSH lub NO_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_messaging nie 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.
Z EasyCoexistence zrobisz to

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