InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram Story-vermeldingen en Story-antwoorden in de webhook

Instagram levert Story-vermeldingen en Story-antwoorden als DM's af op het messages-webhookveld. Een vermelding komt binnen als een bericht waarvan de attachments een item van het type story_mention bevatten, met de CDN-URL van de Story in payload.url. Een antwoord bevat de tekst van de persoon, plus reply_to.story met de url en het id van de Story en, bij een Story met een linksticker, link_sticker_url.

easyCoexistence abonneert elk verbonden Instagram-account op messages, zodat Story-vermeldingen en Story-antwoorden samen met de overige DM's bij je HTTPS-endpoint aankomen zodra ze binnenkomen, ondertekend met het geheim van dat account en zonder kopie te bewaren.

story_mention

Bijlagetype van het messages-event dat Meta stuurt wanneer iemand het account in zijn Story vermeldt.

link_sticker_url

Veld dat Meta op 12 december 2025 aan reply_to.story heeft toegevoegd, met de URL van de linksticker van de beantwoorde Story.

24 hours

Hoe lang een Story duurt; zodra die verloopt of wordt verwijderd, geeft de vermeldings-URL niet langer iets weer.

Public

Accounts waarvan Story-vermeldingen binnenkomen; de vermelding van een privéaccount komt alleen binnen als het het professionele account volgt.

GIF, sticker

Story-antwoorden die de webhook niet ondersteunt, volgens de Instagram Messaging-gids van Meta.

Hoe komt een Story-vermelding binnen?

Als DM. Wanneer iemand het professionele account in zijn Story vermeldt, plaatst Instagram een bericht met verwijzing naar die Story in de inbox van het account, en Meta stuurt daarvoor een messages-event. sender.id is het Instagram-scoped ID van de persoon, en message.attachments bevat één item van het type story_mention waarvan payload.url de CDN-URL van de Story is. De voorbeelden van Meta bevatten geen tekst, dus lees de bijlage:

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>" }
              }
            ]
          }
        }
      ]
    }
  ]
}

Hoe komt een Story-antwoord binnen?

Ook als DM, met het bericht van de persoon en een reply_to-object dat naar de Story van het account verwijst. reply_to.story bevat de CDN-url en het id van de Story. De webhookreferentie van Meta vermeldt daar ook link_sticker_url, toegevoegd in december 2025 voor antwoorden op Stories met een linksticker, wat Meta aanraadt om automatiseringen op basis van de link te routeren. Een inline antwoord op een eerder bericht gebruikt in plaats daarvan 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>"
    }
  }
}

Wat betekent elk veld?

De velden die Meta voor deze twee events documenteert, van buiten naar binnen:

  • entry[].id en recipient.id: het professionele account. sender.id: het Instagram-scoped ID van de persoon, het ID waar een antwoord naartoe gaat.
  • timestamp: het moment waarop het bericht is verzonden, in milliseconden in de voorbeelden van Meta; entry[].time is het moment waarop Meta de melding verstuurde.
  • message.mid: het bericht-ID, om herhaalde leveringen te herkennen en om te antwoorden met reply_to.mid.
  • attachments[].type story_mention en payload.url: een vermelding en de CDN-URL van de Story die die vermelding maakte.
  • reply_to.story.url en reply_to.story.id: de Story van het account die de persoon beantwoordde.
  • reply_to.story.link_sticker_url: de URL op de linksticker van die Story.
  • message.text: de woorden van het antwoord, opgenomen wanneer het bericht tekst bevat.

Hoe lang werkt de Story-URL?

Zolang de Story bestaat. Een Story verdwijnt na 24 uur of wanneer de auteur haar verwijdert, en de gids over Story-vermeldingen van Meta zegt dat de URL dan niet meer wordt weergegeven; het overzicht voegt eraan toe dat de CDN-URL's van Instagram privacybewust zijn en niets teruggeven voor verwijderde of verlopen content. Dezelfde gids staat toe de CDN-URL te bewaren, maar niet de media: een app mag de content van de Story niet op de servers opslaan of cachen en moet een tijdelijke aanduiding tonen zodra de Story weg is.

Wanneer komt geen van beide events binnen?

De gidsen van Meta noemen deze gevallen, waarin een handler die op een Story-event wacht niets krijgt:

  • Een Story-vermelding door een privéaccount dat het professionele account niet volgt.
  • Een tag op een gewone post: Meta zegt dat alleen Story-vermeldingen de messages-webhook activeren, niet taggen op posts.
  • Een Story-antwoord met een GIF of sticker, die de webhook niet ondersteunt.
  • Stories via de mentions-API: GET /<IG_ID>/tags en POST /<IG_ID>/mentions ondersteunen ze niet, dus een Story-vermelding komt binnen via de DM.

Openen Story-vermeldingen en -antwoorden het 24-uursvenster?

Een antwoord is een bericht van de persoon, en Meta noemt Story-vermeldingen onder de kanalen waarmee een persoon een gesprek start. Het venster dat hun actie opent duurt voor de meeste acties 24 uur, dus het account kan antwoorden met POST /<IG_ID>/messages en recipient.id gelijk aan sender.id van het event zolang het open is. Het antwoord van het account komt terug op messages als echo, met is_echo op true.

Hoe stuurt easyCoexistence ze door?

Op het messages-veld, waarop elk verbonden account is geabonneerd, dus Story-vermeldingen en Story-antwoorden bereiken je endpoint samen met de overige DM's van het account: elk item binnen een envelop met platform, account_id, external_id en entry, ondertekend in X-EC-Signature met het geheim van het account, eenmaal verzonden en zonder kopie te bewaren. send_social_dm antwoordt de persoon met de sender.id van het event als recipient_id, binnen het 24-uursvenster.

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>" } }
          ]
        }
      }
    ]
  }
}

Veelgemaakte fouten

  • De media van de Story opslaan. De gids over Story-vermeldingen van Meta staat toe de CDN-URL te bewaren, niet de content, die niet op je servers mag worden opgeslagen of gecachet.
  • Alleen message.text lezen. Een Story-vermelding heeft een bijlage van het type story_mention en in de voorbeelden van Meta geen tekst, dus een handler die alleen tekst leest ziet een leeg bericht.
  • De Story-URL dagen later weergeven. Die werkt niet meer zodra de Story na 24 uur verloopt of wordt verwijderd, dus toon vanaf dat moment een tijdelijke aanduiding.
  • Story-vermeldingen zoeken op het comments-veld of in de mentions-API. Meta levert ze af als DM's op messages.
Dit doen met EasyCoexistence

send_social_dm antwoordt de persoon binnen het 24-uursvenster, vanuit Claude, ChatGPT of je eigen code. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, inclusief de gratis proefperiode van 3 dagen.

Veelgestelde vragen

Heeft een Instagram-event voor een Story-vermelding tekst?

Niet in de voorbeelden van Meta. Een Story-vermelding bevat een bijlage van het type story_mention met de CDN-URL van de Story, dus een handler die alleen message.text leest ziet een leeg bericht.

Wat is link_sticker_url in een Story-antwoord op Instagram?

De URL op de linksticker van de Story die de persoon beantwoordde, in reply_to.story.link_sticker_url. Meta voegde het op 12 december 2025 toe en raadt aan het te gebruiken om automatiseringen op basis van de link te routeren.

Activeren GIF- of stickerantwoorden op een Story de webhook?

Nee. De Instagram Messaging-gids van Meta zegt dat de webhook Story-antwoorden met een GIF of sticker niet ondersteunt.

Activeren privéaccounts webhooks voor Story-vermeldingen?

Alleen wanneer het privéaccount het professionele account volgt. Vermeldingen van openbare accounts komen binnen op het moment dat ze plaatsvinden.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op