AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram-Story-Erwähnungen und Story-Antworten im Webhook

Instagram liefert Story-Erwähnungen und Story-Antworten als DMs über das messages-Webhook-Feld. Eine Erwähnung kommt als Nachricht an, deren attachments ein Element vom Typ story_mention enthalten, mit der CDN-URL der Story in payload.url. Eine Antwort enthält den Text der Person sowie reply_to.story mit url und id der Story und bei einer Story mit Link-Sticker zusätzlich link_sticker_url.

easyCoexistence abonniert jedes verbundene Instagram-Konto für messages, sodass Story-Erwähnungen und Story-Antworten zusammen mit den übrigen DMs bei Ihrem HTTPS-Endpoint ankommen, sobald sie eintreffen, signiert mit dem Secret des Kontos und ohne gespeicherte Kopie.

story_mention

Anhang-Typ des messages-Events, den Meta sendet, wenn jemand das Konto in seiner Story erwähnt.

link_sticker_url

Feld, das Meta am 12. Dezember 2025 in reply_to.story ergänzt hat; es enthält die Link-Sticker-URL der beantworteten Story.

24 hours

Wie lange eine Story besteht; nach Ablauf oder Löschung wird ihre Erwähnungs-URL nicht mehr angezeigt.

Public

Konten, deren Story-Erwähnungen ankommen; die Erwähnung eines privaten Kontos kommt nur an, wenn es dem professionellen Konto folgt.

GIF, sticker

Story-Antworten, die der Webhook laut Metas Instagram-Messaging-Leitfaden nicht unterstützt.

Wie kommt eine Story-Erwähnung an?

Als DM. Erwähnt eine Person das professionelle Konto in ihrer Story, legt Instagram im Posteingang des Kontos eine Nachricht an, die auf diese Story verweist, und Meta sendet dafür ein messages-Event. sender.id ist die Instagram-scoped ID der Person, und message.attachments enthält genau ein Element vom Typ story_mention, dessen payload.url die CDN-URL der Story ist. Metas Beispiele enthalten keinen Text, deshalb muss der Anhang gelesen werden:

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

Wie kommt eine Story-Antwort an?

Ebenfalls als DM, mit der Nachricht der Person und einem reply_to-Objekt, das auf die Story des Kontos zeigt. reply_to.story enthält die CDN-URL und die ID der Story. In Metas Webhook-Referenz steht dort außerdem link_sticker_url, das im Dezember 2025 für Antworten auf Stories mit Link-Sticker ergänzt wurde; Meta empfiehlt das Feld, um Automatisierungen nach Link zu steuern. Eine Inline-Antwort auf eine frühere Nachricht verwendet stattdessen 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>"
    }
  }
}

Was bedeutet jedes Feld?

Die Felder, die Meta für diese beiden Events dokumentiert, von außen nach innen:

  • entry[].id und recipient.id: das professionelle Konto. sender.id: die Instagram-scoped ID der Person, an die eine Antwort geht.
  • timestamp: Zeitpunkt der Nachricht, in Metas Beispielen in Millisekunden; entry[].time ist der Zeitpunkt, zu dem Meta die Benachrichtigung gesendet hat.
  • message.mid: die Nachrichten-ID, zum Deduplizieren von Wiederholungen und zum Antworten mit reply_to.mid.
  • attachments[].type story_mention und payload.url: eine Erwähnung und die CDN-URL der Story, die sie ausgelöst hat.
  • reply_to.story.url und reply_to.story.id: die Story des Kontos, auf die die Person geantwortet hat.
  • reply_to.story.link_sticker_url: die URL auf dem Link-Sticker dieser Story.
  • message.text: der Text der Antwort, enthalten, wenn die Nachricht Text hat.

Wie lange funktioniert die Story-URL?

So lange wie die Story. Eine Story verschwindet nach 24 Stunden oder wenn ihr Autor sie löscht; laut Metas Leitfaden zu Story-Erwähnungen wird die URL dann nicht mehr angezeigt. Die Übersicht ergänzt, dass die CDN-URLs von Instagram datenschutzbewusst gestaltet sind und für gelöschte oder abgelaufene Inhalte nichts zurückgeben. Derselbe Leitfaden erlaubt, die CDN-URL zu speichern, nicht aber die Medien: Eine App darf den Inhalt der Story nicht auf ihren Servern speichern oder zwischenspeichern und sollte nach dem Verschwinden der Story einen Platzhalter zeigen.

Wann kommt kein Event an?

Metas Leitfäden nennen diese Fälle, in denen ein Handler, der auf ein Story-Event wartet, nichts erhält:

  • Eine Story-Erwähnung durch ein privates Konto, das dem professionellen Konto nicht folgt.
  • Eine Markierung in einem regulären Beitrag: Meta sagt, dass nur Story-Erwähnungen den messages-Webhook auslösen, nicht das Markieren in Beiträgen.
  • Eine Story-Antwort mit einem GIF oder einem Sticker, die der Webhook nicht unterstützt.
  • Stories über die Mentions-API: GET /<IG_ID>/tags und POST /<IG_ID>/mentions unterstützen sie nicht, daher kommt die Story-Erwähnung als DM an.

Öffnen Story-Erwähnungen und -Antworten das Nachrichtenfenster?

Eine Antwort ist eine Nachricht der Person, und Meta führt Story-Erwähnungen unter den Kanälen auf, über die eine Person ein Gespräch beginnt. Das Fenster, das ihre Aktion öffnet, dauert bei den meisten Aktionen 24 Stunden. Solange es offen ist, kann das Konto mit POST /<IG_ID>/messages antworten, wobei recipient.id auf die sender.id des Events gesetzt wird. Die Antwort des Kontos kommt über messages als Echo zurück, mit is_echo auf true.

Wie leitet easyCoexistence sie weiter?

Über das messages-Feld, das jedes verbundene Konto abonniert. Story-Erwähnungen und Story-Antworten erreichen Ihren Endpoint daher zusammen mit den übrigen DMs des Kontos: jeder Eintrag in einem Umschlag aus platform, account_id, external_id und entry, signiert in X-EC-Signature mit dem Secret des Kontos, einmal gesendet und ohne gespeicherte Kopie. send_social_dm antwortet der Person mit der sender.id des Events als recipient_id, innerhalb des 24-Stunden-Fensters.

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

Häufige Fehler

  • Die Medien der Story speichern. Metas Leitfaden zu Story-Erwähnungen erlaubt, die CDN-URL zu behalten, nicht aber den Inhalt; dieser darf nicht auf Ihren Servern gespeichert oder zwischengespeichert werden.
  • Nur message.text lesen. Eine Story-Erwähnung trägt einen Anhang vom Typ story_mention und laut Metas Beispielen keinen Text, sodass ein reiner Text-Handler eine leere Nachricht sieht.
  • Die Story-URL Tage später rendern. Sie funktioniert nicht mehr, sobald die Story nach 24 Stunden abläuft oder gelöscht wird; ab dann sollten Sie einen Platzhalter zeigen.
  • Story-Erwähnungen im comments-Feld oder in der Mentions-API suchen. Meta liefert sie als DMs über messages aus.
Mit EasyCoexistence

send_social_dm antwortet der Person innerhalb des 24-Stunden-Fensters, von Claude, ChatGPT oder Ihrem eigenen Code aus. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, die ersten 3 Tage kostenlos.

Häufig gestellte Fragen

Enthält das Event einer Instagram-Story-Erwähnung Text?

Nicht in Metas Beispielen. Eine Story-Erwähnung trägt einen Anhang vom Typ story_mention mit der CDN-URL der Story, daher sieht ein Handler, der nur message.text liest, eine leere Nachricht.

Was ist link_sticker_url in einer Instagram-Story-Antwort?

Die URL auf dem Link-Sticker der Story, auf die die Person geantwortet hat, in reply_to.story.link_sticker_url. Meta hat sie am 12. Dezember 2025 ergänzt und empfiehlt sie, um Automatisierungen nach Link zu steuern.

Lösen GIF- oder Sticker-Antworten auf eine Story den Webhook aus?

Nein. Metas Leitfaden zum Instagram-Messaging besagt, dass der Webhook Story-Antworten mit einem GIF oder einem Sticker nicht unterstützt.

Lösen private Konten Story-Erwähnungs-Webhooks aus?

Nur wenn das private Konto dem professionellen Konto folgt. Erwähnungen aus öffentlichen Konten kommen an, sobald sie passieren.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am