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

Odczyt historii DM na Instagramie: API konwersacji

Conversations API Instagrama odczytuje historię DM profesjonalnego konta na graph.instagram.com. GET /me/conversations?platform=instagram zwraca listę rozmów wraz z ich updated_time, GET /<CONVERSATION_ID>?fields=messages zwraca listę wiadomości rozmowy według ID i czasu, a GET /<MESSAGE_ID>?fields=id,created_time,from,to,message zwraca jedną wiadomość. Szczegóły są dostępne dla 20 najnowszych wiadomości w każdej rozmowie.

easyCoexistence przekazuje nowe wiadomości DM z Instagrama do Twojego endpointu w chwili ich nadejścia i wysyła odpowiedzi przez send_social_dm w 24-godzinnym oknie, z poziomu Claude, ChatGPT lub własnego kodu, na oficjalnym API Meta; nie ma narzędzia do historii z Conversations API.

20

Najnowsze wiadomości w każdej rozmowie, których szczegóły zwraca API; starsze zwracają błąd informujący, że zostały usunięte.

30 days

Czas bezczynności, po którym rozmowy w folderze Requests nie są już zwracane.

2/sec

Liczba wywołań Conversations API na sekundę dla każdego profesjonalnego konta na Instagramie.

2 permissions

instagram_business_basic i instagram_business_manage_messages, z tokenem osoby, która może zarządzać wiadomościami konta.

Jak wyświetlić listę rozmów konta?

Za pomocą GET /me/conversations lub /<IG_ID>/conversations oraz platform=instagram, z tokenem dostępu Instagram User osoby, która może zarządzać wiadomościami na koncie. Każdy wpis w tablicy data to jedna rozmowa z jej id i updated_time.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

Jak znaleźć rozmowę z jedną osobą?

Dodaj user_id z identyfikatorem IGSID tej osoby, czyli identyfikatorem w zakresie Instagrama, który przychodzi jako sender.id, gdy napisze do konta. Odpowiedź zwraca id tej rozmowy. Dzięki temu zdarzenie z webhooka zamienisz na jej wątek bez przeglądania całej listy.

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

Jak odczytać wiadomości?

W dwóch krokach. GET /<CONVERSATION_ID>?fields=messages zwraca listę wiadomości rozmowy według id i created_time, czyli domyślnych pól. GET /<MESSAGE_ID> z fields=id,created_time,from,to,message zwraca jedną wiadomość: kto ją wysłał i do kogo, każdy z nazwą użytkownika i ID, oraz jej treść.

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

Jak daleko wstecz można czytać?

Przewodnik i przegląd Meta wyznaczają cztery ograniczenia tego, co zostaje zwrócone:

  • Szczegóły wiadomości: 20 najnowszych wiadomości w każdej rozmowie; prośba o starszą zwraca błąd, że została usunięta.
  • Requests: rozmowy w folderze Requests bez aktywności przez 30 dni nie są zwracane.
  • Udostępnienia: udostępniony post lub Reel zwracany jest tylko jako adres URL obrazu lub wideo.
  • Limit: 2 wywołania na sekundę dla każdego profesjonalnego konta na Instagramie.

Czego to wymaga?

Przy Instagram Login potrzebne są uprawnienia instagram_business_basic i instagram_business_manage_messages oraz token osoby, która może zarządzać wiadomościami na koncie. Standardowy dostęp wystarcza dla kont, które posiadasz lub którymi zarządzasz i które dodano do aplikacji; obsługa innych kont wymaga zaawansowanego dostępu (Advanced Access). Konto musi też mieć włączoną opcję „Allow access to messages” w ustawieniach aplikacji Instagram.

Dlaczego prowadzić zapis z webhooków?

Ponieważ API zwraca szczegóły tylko dla 20 najnowszych wiadomości każdej rozmowy, pełną historię trzeba zapisywać na bieżąco. Webhook messages dostarcza wiadomości DM w chwili ich nadejścia, z IGSID osoby jako sender.id. Wiadomości wysłane przez konto też przychodzą, z zamienionymi identyfikatorami, więc można zapisać obie strony rozmowy.

Jak czytać historię DM przez easyCoexistence?

Przekazuje wiadomości DM, a nie odczytuje historii. Nowe wiadomości DM trafiają do Twojego endpointu w chwili nadejścia, po ustawieniu go przez set_social_webhook_destination; są przekazywane dalej bez zachowywania kopii, a send_social_dm wysyła odpowiedź w 24-godzinnym oknie, z poziomu Claude, ChatGPT lub własnego kodu. Żadne narzędzie nie wywołuje me/conversations, więc wcześniejsze wiadomości czyta się w aplikacji Instagram albo przechowuje we własnym systemie w miarę ich nadchodzenia.

Typowe błędy

  • Oczekiwanie pełnego wątku z API. Szczegóły kończą się na 20 najnowszych wiadomościach, dlatego zapisuj wiadomości DM z webhooka messages w chwili ich nadejścia.
  • Odpytywanie rozmów w poszukiwaniu nowych wiadomości DM. API pozwala na 2 wywołania na sekundę dla konta, a webhook messages dostarcza każdą wiadomość DM od razu po jej nadejściu.
  • Szukanie starej prośby o wiadomość. Rozmowy w Requests bez aktywności przez 30 dni nie są już zwracane.
  • Odczytywanie błędu o usunięciu jako decyzji osoby. Meta tak odpowiada na każdą wiadomość starszą niż 20 najnowszych.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, z ceną spadającą wraz z dodawaniem połączeń, i bezpłatny okres próbny przez pierwsze 3 dni.

Najczęściej zadawane pytania

Czy mogę wyeksportować pełną historię DM konta na Instagramie?

Nie w całości przez API: pokazuje ono rozmowy, ale zwraca szczegóły tylko dla 20 najnowszych wiadomości każdej z nich. Pełny zapis powstaje dzięki zapisywaniu wiadomości DM w miarę, jak dostarcza je webhook.

Czy odczyt wiadomości przez API oznacza je jako przeczytane?

Nie. Meta podaje, że wiadomości dostarczone przez API nie są oznaczane jako przeczytane w aplikacji Instagram, dopóki nie zostanie wysłana odpowiedź.

Czy Conversations API działa z Instagram Login?

Tak. Przewodnik Meta dla tego API jest napisany z myślą o Instagram Login, z wywołaniami na graph.instagram.com i uprawnieniami instagram_business_*.

Jak pobrać nazwę użytkownika osoby z rozmowy?

Poproś o pole from przy wiadomości, które zwraca nazwę użytkownika i ID nadawcy. User Profile API zwraca więcej, na przykład imię, na podstawie IGSID, gdy osoba już napisała do konta.

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