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.
Najnowsze wiadomości w każdej rozmowie, których szczegóły zwraca API; starsze zwracają błąd informujący, że zostały usunięte.
Czas bezczynności, po którym rozmowy w folderze Requests nie są już zwracane.
Liczba wywołań Conversations API na sekundę dla każdego profesjonalnego konta na Instagramie.
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.
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.
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ść.
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.
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