Wzmianki na Instagramie przez API: wyszukiwanie i odpowiadanie na @wzmianki
API Instagrama zgłasza wzmianki konta firmowego w komentarzach i podpisach pod publicznymi materiałami oraz pozwala kontu odpowiedzieć w tym samym miejscu. Przy Instagram Login wzmianki trafiają na webhook komentarzy, a odpowiedź idzie przez POST /<IG_ID>/mentions z identyfikatorem materiału, a dla komentarza także z identyfikatorem komentarza, i publikuje się jako komentarz w tym miejscu.
easyCoexistence przekazuje komentarze, wzmianki i wiadomości prywatne z konta Instagram na Twój endpoint w miarę ich nadejścia, podpisane sekretem dla tego konta, po ustawieniu go przez set_social_webhook_destination.
Powiadomienie webhooka obejmujące wzmianki w aplikacjach korzystających z Instagram Login.
Endpoint, który odpowiada na komentarz lub podpis, w którym inny użytkownik Instagrama wspomniał konto przez @.
Materiał należący do konta prywatnego nie wywołuje webhooka za komentarz ani wzmiankę @ pod nim.
Uprawnienia potrzebne wzmiankom przy Instagram Login: instagram_business_basic i instagram_business_manage_comments.
Jak docierają wzmianki?
Przez webhook, w momencie wystąpienia. Przy Instagram Login Meta dołącza wzmianki do powiadomienia o komentarzach, zamiast wysyłać osobne pole mentions, więc handler odczytuje je z tych samych zdarzeń co nowe komentarze. Meta nie przechowuje historii wcześniejszych powiadomień, dlatego zapisz to, czego potrzebujesz, z każdego z nich w chwili otrzymania.
Które wzmianki obejmuje API?
API wzmianek Meta wykrywa podpisy, komentarze i materiały, w których konto firmowe lub twórcy zostało wspomniane przez @ lub oznaczone:
- @wzmianki w komentarzach.
- @wzmianki w podpisie posta.
- Materiały, w których konto jest oznaczone, wymienione w GET /<
IG_ID>/tags; komentowanie zdjęć, na których konto jest tylko oznaczone, nie jest obsługiwane. - Nie relacje: API wzmianek ich nie obsługuje, a wzmianka w relacji trafia na konto jako wiadomość prywatna, której typ załącznika to
story_mention. - Nie konta prywatne: materiały z takich kont nie wysyłają webhooków wzmianek.
Jak odpowiedzieć na wzmiankę?
Przez POST /<IG_ID>/mentions. Przy wzmiance w komentarzu wyślij media_id i comment_id wraz z wiadomością, a odpowiedź pojawi się w wątku tego komentarza; przy wzmiance w podpisie wyślij media_id i wiadomość, a odpowiedź opublikuje się jako komentarz pod materiałem. Oba identyfikatory pochodzą z powiadomienia webhooka.
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>Czego wymagają wzmianki?
Przy Instagram Login potrzebne są uprawnienia instagram_business_basic i instagram_business_manage_comments, ta sama para, której używa moderacja komentarzy, a wywołania idą do graph.instagram.com. Aby obsługiwać konta firmowe, których deweloper nie posiada ani nimi nie zarządza, aplikacja potrzebuje też Advanced Access.
Typowe błędy
- Czekanie na osobne zdarzenie wzmianki przy Instagram Login. Meta dostarcza wzmianki wewnątrz powiadomienia o komentarzach.
- Odpowiadanie na wzmiankę pod postem innego konta jak na komentarz pod własnym. Trasą Meta do tego jest POST /<IG_ID>/mentions, z identyfikatorem materiału i, dla komentarza, identyfikatorem komentarza.
- Oczekiwanie wzmianek z relacji przez API wzmianek. Meta ich tam nie obsługuje; trafiają na konto jako wiadomości prywatne.
- Liczenie na to, że webhook odtworzy dawne wzmianki. Meta nie przechowuje historii powiadomień, więc zapisuj każdą wzmiankę w chwili jej otrzymania.
Jego narzędzia odpowiadają na komentarze pod Twoimi własnymi postami przez reply_to_comment; odpowiedź na wzmiankę w cudzym poście, która korzysta z endpointu wzmianek Meta, nie należy do nich. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy mogę skomentować zdjęcie, na którym moje konto jest oznaczone?
Nie. GET /<IG_ID>/tags wymienia materiały, w których konto jest oznaczone, ale Meta nie obsługuje komentowania zdjęć, na których konto jest tylko oznaczone.
Czy mogę odpowiedzieć na wzmiankę pod postem kogoś innego?
Tak. POST /<IG_ID>/mentions z identyfikatorem materiału oraz identyfikatorem komentarza, gdy wzmianka jest w komentarzu, publikuje odpowiedź tam jako konto.
Czy wzmianki z relacji są dostępne przez API wzmianek?
Nie. Wzmianka z relacji trafia na konto jako wiadomość prywatna z typem załącznika story_mention i może dostać odpowiedź w tej rozmowie.
Dlaczego wzmianka nigdy nie dotarła?
Materiał może należeć do konta prywatnego, które nie wysyła powiadomień o wzmiankach, albo wzmianka może być w relacji, którą API wzmianek nie obejmuje.
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