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

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.

story_mention

Typ załącznika zdarzenia messages, które Meta wysyła, gdy ktoś wspomina konto w swojej relacji.

link_sticker_url

Pole, które Meta dodała do reply_to.story 12 grudnia 2025, zawierające adres URL naklejki z linkiem odpowiadanej relacji.

24 hours

Jak długo żyje relacja; po wygaśnięciu lub usunięciu jej adres wzmianki przestaje się wyświetlać.

Public

Konta, których wzmianki w relacjach docierają; wzmianka z konta prywatnego przychodzi tylko wtedy, gdy obserwuje ono konto profesjonalne.

GIF, sticker

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:

A Story mention, as Meta sends it
{
  "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.

The message object of a Story reply
"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_mention oraz payload.url: wzmianka i adres CDN relacji, która ją wywołała.
  • reply_to.story.url i reply_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.

A forwarded Story mention, headers included
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.
Z EasyCoexistence zrobisz to

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