Wzmianki w relacjach i odpowiedzi na relacje w webhooku
Instagram dostarcza wzmianki w relacjach i odpowiedzi na relacje jako wiadomości prywatne w polu messages webhooka. Wzmianka przychodzi jako wiadomość, której załączniki zawierają element typu story_mention, a adres CDN relacji znajduje się w payload.url. Odpowiedź zawiera tekst osoby oraz reply_to.story z url i id relacji, a przy relacji z naklejką linku także link_sticker_url.
easyCoexistence subskrybuje każde podłączone konto Instagram do messages, więc wzmianki i odpowiedzi w relacjach docierają do Twojego endpointu HTTPS razem z pozostałymi wiadomościami prywatnymi, w miarę jak przychodzą, podpisane sekretem tego konta i bez zachowywania kopii.
Typ załącznika zdarzenia messages, które Meta wysyła, gdy ktoś wspomina konto w swojej relacji.
Pole, które Meta dodała do reply_to.story 12 grudnia 2025, zawierające adres URL naklejki z linkiem odpowiadanej relacji.
Jak długo żyje relacja; po wygaśnięciu lub usunięciu jej adres wzmianki przestaje się wyświetlać.
Konta, których wzmianki w relacjach docierają; wzmianka z konta prywatnego przychodzi tylko wtedy, gdy obserwuje ono konto profesjonalne.
Odpowiedzi na relacje, których webhook nie obsługuje, według przewodnika Meta po Instagram Messaging.
Jak przychodzi wzmianka w relacji?
Jako wiadomość prywatna. Gdy ktoś wspomni profesjonalne konto w swojej relacji, Instagram umieszcza w skrzynce konta wiadomość odwołującą się do tej relacji, a Meta wysyła dla niej zdarzenie messages. sender.id to identyfikator osoby w zakresie Instagrama, a message.attachments zawiera jeden element typu story_mention, którego payload.url to adres CDN relacji. Próbki Meta nie mają tekstu, więc odczytaj załącznik:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}Jak przychodzi odpowiedź na relację?
Również jako wiadomość prywatna, z tekstem osoby i obiektem reply_to wskazującym na relację konta. reply_to.story zawiera adres CDN relacji i jej id. Dokumentacja webhooka Meta wymienia tam także link_sticker_url, dodane w grudniu 2025 roku dla odpowiedzi na relacje z naklejką linku, którą Meta zaleca do kierowania automatyzacji według linku. Odpowiedź bezpośrednio na wcześniejszą wiadomość używa zamiast tego reply_to.mid.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Co oznacza każde pole?
Pola, które Meta dokumentuje dla tych dwóch zdarzeń, od zewnątrz do środka:
- entry[].id i recipient.id: profesjonalne konto. sender.id: identyfikator osoby w zakresie Instagrama, czyli ten, do którego trafia odpowiedź.
- timestamp: moment wysłania wiadomości, w milisekundach w próbkach Meta; entry[].time to moment, w którym Meta wysłała powiadomienie.
- message.mid: identyfikator wiadomości, do deduplikacji ponownych wysyłek i do odpowiadania przez
reply_to.mid. - attachments[].type
story_mentionoraz payload.url: wzmianka i adres CDN relacji, która ją wywołała. reply_to.story.url ireply_to.story.id: relacja konta, na którą odpowiedziała osoba.reply_to.story.link_sticker_url: adres URL na naklejce linku tej relacji.- message.text: słowa odpowiedzi, obecne, gdy wiadomość zawiera tekst.
Jak długo działa adres URL relacji?
Tak długo, jak sama relacja. Relacja znika po 24 godzinach lub gdy jej autor ją usunie, a przewodnik Meta po wzmiankach w relacjach mówi, że wtedy adres URL przestaje się wyświetlać. Przegląd dodaje, że adresy CDN Instagrama uwzględniają prywatność i nie zwracają niczego dla usuniętych lub wygasłych treści. Ten sam przewodnik pozwala zachować adres CDN, ale nie media: aplikacja nie może przechowywać ani buforować treści relacji na swoich serwerach i powinna pokazać symbol zastępczy, gdy relacja zniknie.
Kiedy nie uruchamia się żadne z tych zdarzeń?
Przewodniki Meta wymieniają te przypadki, w których handler czekający na zdarzenie relacji nic nie dostaje:
- Wzmianka w relacji od konta prywatnego, które nie obserwuje konta profesjonalnego.
- Oznaczenie w zwykłym poście: Meta mówi, że webhook messages wyzwala tylko wzmianka w relacji, a nie oznaczenie w postach.
- Odpowiedź na relację wysłana GIF-em lub naklejką, czego webhook nie obsługuje.
- Relacje przez API wzmianek: GET /<
IG_ID>/tags i POST /<IG_ID>/mentions ich nie obsługują, więc wiadomość prywatna jest sposobem, w jaki dociera wzmianka w relacji.
Czy wzmianki i odpowiedzi w relacjach otwierają okno wiadomości?
Odpowiedź to wiadomość od osoby, a Meta wymienia wzmianki w relacjach wśród kanałów, przez które osoba rozpoczyna rozmowę. Okno otwarte przez jej działanie trwa 24 godziny w przypadku większości działań, więc konto może odpowiedzieć przez POST /<IG_ID>/messages z recipient.id ustawionym na sender.id zdarzenia, dopóki okno jest otwarte. Odpowiedź konta wraca w messages jako echo, z is_echo ustawionym na true.
Jak easyCoexistence je przekazuje?
Przez pole messages, do którego subskrybowane jest każde podłączone konto, więc wzmianki i odpowiedzi w relacjach docierają do Twojego endpointu razem z pozostałymi wiadomościami prywatnymi konta: każdy wpis w kopercie z platform, account_id, external_id i entry, podpisany w X-EC-Signature sekretem konta, wysłany raz i bez zachowywania kopii. send_social_dm odpowiada osobie, używając sender.id zdarzenia jako recipient_id, w ramach 24-godzinnego okna.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}Typowe błędy
- Zapisywanie mediów relacji. Przewodnik Meta po wzmiankach w relacjach pozwala zachować adres CDN, ale nie treść, której nie wolno przechowywać ani buforować na Twoich serwerach.
- Czytanie tylko message.text. Wzmianka w relacji ma załącznik typu story_mention i, w próbkach Meta, brak tekstu, więc handler obsługujący tylko tekst widzi pustą wiadomość.
- Renderowanie adresu relacji po dniach. Przestaje działać, gdy relacja wygaśnie po 24 godzinach lub zostanie usunięta, więc od tego momentu pokaż symbol zastępczy.
- Szukanie wzmianek w relacjach w polu comments lub w API wzmianek. Meta dostarcza je jako wiadomości prywatne w polu messages.
send_social_dm odpowiada osobie w ramach 24-godzinnego okna, od Claude, ChatGPT lub z własnego kodu. 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 zdarzenie wzmianki w relacji Instagrama zawiera tekst?
W próbkach Meta nie. Wzmianka w relacji ma załącznik typu story_mention z adresem CDN relacji, więc handler czytający tylko message.text widzi pustą wiadomość.
Czym jest link_sticker_url w odpowiedzi na relację Instagrama?
To adres URL na naklejce linku relacji, na którą odpowiedziała osoba, w polu reply_to.story.link_sticker_url. Meta dodała go 12 grudnia 2025 i zaleca do kierowania automatyzacji według linku.
Czy odpowiedzi na relację GIF-em lub naklejką uruchamiają webhook?
Nie. Przewodnik Meta po Instagram Messaging mówi, że webhook nie obsługuje odpowiedzi na relacje wysłanych GIF-em lub naklejką.
Czy konta prywatne uruchamiają webhooki wzmianek w relacjach?
Tylko wtedy, gdy konto prywatne obserwuje konto profesjonalne. Wzmianki z kont publicznych przychodzą na bieżąco, w miarę jak się dzieją.
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