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

Odczyt historii rozmów Messengera przez API

Historię Messengera Strony odczytujesz poleceniem GET /{page-id}/conversations?platform=messenger, które zwraca identyfikatory rozmów wraz z czasem ostatniej aktualizacji. Następnie GET /{conversation-id}?fields=messages zwraca identyfikatory wiadomości, a GET /{message-id} podaje nadawcę, odbiorcę, tekst i załączniki każdej z nich. Meta zwraca szczegóły dla 20 najnowszych wiadomości w rozmowie, a wywołania wymagają tokenu dostępu Strony z uprawnieniem pages_messaging.

easyCoexistence przekazuje nowe wiadomości Messengera Strony do Twojego endpointu w miarę nadchodzenia, a send_social_dm wysyła odpowiedzi w ramach 24-godzinnego okna, z Claude, ChatGPT lub Twojego własnego kodu.

20 messages

Szczegóły są zwracane tylko dla 20 najnowszych wiadomości w rozmowie; starsze zwracają błąd informujący, że wiadomość została usunięta.

2 per second

Liczba wywołań Conversations API, które aplikacja może wykonać na jednej Stronie na Facebooku.

30 days

Rozmowy w folderze Requests, które nie były aktywne przez tyle czasu, są pomijane w wynikach API.

MESSAGING or MODERATE

Zadanie na Stronie, które osoba stojąca za tokenem musi móc wykonać, aby odczytywać rozmowy.

80006

Błąd przy zbyt wielu wywołaniach API Messengera dla konta Strony; Meta zaleca chwilę odczekać i spróbować ponownie.

Jak wylistować rozmowy Strony?

Poleceniem GET /{page-id}/conversations, z ustawionym parametrem platform na messenger. Wynik zawiera tablicę data z identyfikatorami rozmów, z których każdy ma updated_time, czyli czas dodania ostatniej wiadomości, oraz obiekt paging. Dokumentacja Meta zaznacza, że paginacja oparta na czasie nie jest dostępna na tym endpoincie, więc przechodź po listach za pomocą obiektu paging.

Listing a Page's Messenger conversations
GET /{page-id}/conversations?platform=messenger

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
  ],
  "paging": { ... }
}

Jak znaleźć rozmowę jednej osoby?

Dodaj do tego samego żądania user_id z identyfikatorem w zakresie Strony (PSID) tej osoby. Meta odpowie identyfikatorem rozmowy między Stroną a tą osobą, co jest najkrótszą drogą od webhooka wiadomości, w którym PSID przychodzi jako sender.id, do historii, która za nim stoi:

One person's conversation
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>

{ "data": [ { "id": "<CONVERSATION_ID>" } ] }

Jak odczytać wiadomości w rozmowie?

W dwóch krokach. GET /{conversation-id} z fields=messages zwraca identyfikatory wiadomości w rozmowie, każdy z created_time, zaczynając od najnowszej. Następnie GET /{message-id} z potrzebnymi polami, takimi jak id, created_time, from, to, message i reply_to, zwraca treść jednej wiadomości. Domyślnie zwracane są pola id i created_time, a pole bez danych jest pomijane w odpowiedzi.

Jakie pola można odczytać?

Rozmowa i wiadomość udostępniają różne pola. Oto te, które dokumentacja Meta wymienia dla wiadomości Stron:

  • Rozmowa: id, updated_time, participants z ich ID, imieniem i e-mailem oraz messages, a także is_owner, gdy włączone jest Conversation Routing.
  • Wiadomość: id, created_time, from i to, każde z ID, imieniem i e-mailem, oraz message, czyli tekst, pusty, gdy go brak.
  • attachments: pliki, obrazy i wideo z adresami URL sieci CDN oraz is_unsupported, zwracane tylko wtedy, gdy wiadomość zawiera nieobsługiwaną treść.
  • reactions, reply_to z mid, na który wiadomość odpowiada, oraz is_self_reply, a także shares dla udostępnionych postów i rolek.
  • tags: folder i źródło wiadomości, na przykład inbox, read lub source:chat.

Jak daleko wstecz można czytać?

Tak daleko, jak sięga rozmowa w przypadku identyfikatorów, ale nie w przypadku treści. Przewodnik Meta mówi, że endpoint rozmowy zwraca wszystkie identyfikatory wiadomości w rozmowie, a szczegóły wracają tylko dla 20 najnowszych; zapytanie o starszą zwraca błąd, że wiadomość została usunięta. Rozmowy w folderze Requests, które są nieaktywne przez 30 dni, w ogóle nie są zwracane.

Jakie uprawnienia i zadania są potrzebne?

Token dostępu Strony od osoby, która może wykonać zadanie MESSAGING lub MODERATE na Stronie, z uprawnieniami pages_manage_metadata, pages_read_engagement i pages_messaging. Odczyt rozmów z osobami, które nie mają roli w aplikacji, na Stronie ani w firmie, wymaga Advanced Access, które Meta przyznaje w App Review.

Jakie limity obowiązują wywołania?

Limity Meta dają Conversations API 2 wywołania na sekundę na Stronę, a wywołania ponad limit wracają z kodem 613 lub 80006 i komunikatem „Zbyt wiele wywołań API Messengera dla tego konta Strony”. Strona, która przekroczy wysoki limit Meta, na przykład wysyłając ponad 40 wiadomości na sekundę, nie może wylistować swoich rozmów, dopóki wolumen nie spadnie, choć pojedyncza rozmowa nadal może być odczytywana pod kątem nowych wiadomości.

Kiedy używać API zamiast webhooków?

Do przeszłości. Webhooki dostarczają nowe wiadomości w chwili ich nadejścia, a Meta zaznacza, że wcześniejszych powiadomień nie da się później wyszukać. Conversations API służy więc integracji do odczytu tego, co było przed rozpoczęciem nasłuchu, albo do nadrobienia zaległości po przestoju. Przy włączonym Conversation Routing pole is_owner zawęża listę do rozmów, za które odpowiada aplikacja, co Meta zaleca przy odzyskiwaniu po przestoju.

Jak easyCoexistence odczytuje historię Messengera?

Nie odczytuje historii. Strona łączy się z uprawnieniami pages_messaging, pages_manage_metadata i pages_read_engagement, ale żadne narzędzie nie wywołuje Conversations API, a tokeny Strony nie są wydawane. Nowe wiadomości trafiają do Twojego endpointu przez set_social_webhook_destination w miarę nadchodzenia, przekazywane bez kopii, więc Twój własny system przechowuje historię, której potrzebuje.

Typowe błędy

  • Oczekiwanie treści wiadomości w wywołaniu listy. Endpoint rozmowy zwraca identyfikatory wiadomości; pola każdej odczytujesz z /{message-id}.
  • Liczenie na pełną historię. Szczegóły kończą się na 20 najnowszych wiadomościach, więc zapisuj to, czego potrzebujesz, z webhooków w miarę nadchodzenia wiadomości.
  • Odpytywanie o nowe wiadomości. Przy 2 wywołaniach na sekundę na Stronę pętla odpytywania szybko trafi na limit, podczas gdy webhook wiadomości dostarcza je w chwili ich nadejścia.
  • Stronicowanie rozmów po dacie za pomocą since i until. Paginacja oparta na czasie nie jest dostępna na endpoincie rozmów; zamiast tego przechodź za pomocą obiektu paging.
Z EasyCoexistence zrobisz to

Nie ma narzędzia dla Conversations API, więc wcześniejszą historię odczytuje się w skrzynce Strony. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, z tańszymi kolejnymi połączeniami, a pierwsze 3 dni są bezpłatnym okresem próbnym.

Najczęściej zadawane pytania

Czy Conversations API zawiera wiadomości samej Strony?

Tak. Pola from i to wskazują osobę albo Stronę, więc wiadomości rozmowy obejmują obie strony.

Czy mogę odczytywać rozmowy Messengera bez App Review?

Dla osób z rolą w aplikacji lub na Stronie wystarczy Standard Access. Rozmowy z kimkolwiek innym wymagają Advanced Access, przyznawanego przez App Review.

Czy Conversations API może wysyłać odpowiedzi?

Nie. Dokumentacja Meta dla rozmów mówi, że ten endpoint nie publikuje; odpowiedzi idą przez Send API pod /{page-id}/messages.

Czy easyCoexistence przechowuje moje rozmowy w Messengerze?

Nie domyślnie. Przekazywane zdarzenia są przesyłane dalej bez zachowywania kopii; przy włączonej automatyzacji treść wiadomości jest przechowywana przez 7 dni, a logi uruchomień automatyzacji przez 30 dni.

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