AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram-Kommentar-Webhook: die Payload, Feld für Feld

Das Webhook-Feld comments von Instagram benachrichtigt eine App, wenn jemand einen Beitrag oder ein Reel eines professionellen Kontos kommentiert oder auf einen Kommentar antwortet. Meta sendet eine Änderung mit field = comments, deren value die ID und den Text des Kommentars, die Instagram-scoped ID und den Benutzernamen des Autors in from, die id und den media_product_type des Mediums sowie parent_id enthält, wenn der Kommentar eine Antwort ist.

easyCoexistence abonniert jedes verbundene Instagram-Konto für comments und leitet die Ereignisse comments, die Meta dafür zustellt, sofort an Ihren HTTPS-Endpoint weiter, signiert mit dem Geheimnis dieses Kontos und ohne gespeicherte Kopie.

parent_id

Vorhanden, wenn der Kommentar eine Antwort ist; enthält die ID des Kommentars, auf den er antwortet.

self_ig_scoped_id

Wird um from ergänzt, wenn das Konto auf eigene Medien kommentiert; neben der eigenen ID des Kontos.

live_comments

Eigenes Feld für Kommentare während einer Live-Übertragung; die Benachrichtigungen enden mit der Übertragung.

Advanced Access

Erforderlich für comments- und live_comments-Benachrichtigungen; Medien privater Konten lösen keine aus.

7 days

Zeitfenster, in dem man einem Kommentierenden eine private Antwort senden kann, adressiert über die ID des Kommentars.

Wann löst das Feld comments aus?

Wenn jemand Medien kommentiert, die das professionelle Konto besitzt, oder das Konto erwähnt, sobald App und Konto beide für das Feld abonniert sind. Jeder Kommentar ist eine Änderung in der Benachrichtigung, und diese Fälle haben dieselbe Form:

  • Ein neuer Kommentar zu einem Beitrag, einem Reel, einer Story oder einer Anzeige, mit media.media_product_type, das angibt, auf welcher Fläche das Medium liegt.
  • Eine Antwort unter einem bestehenden Kommentar, die parent_id mit der ID des Kommentars trägt, auf den sie antwortet.
  • Ein Kommentar, den das Konto auf eigene Medien schreibt, einschließlich Antworten: from.id ist die eigene ID des Kontos, und from enthält self_ig_scoped_id.
  • Eine @-Erwähnung des Kontos: Bei Instagram Login nimmt Meta Erwähnungen in die Benachrichtigung comments auf, statt ein eigenes Feld zu verwenden.
  • Ein Kommentar während einer Live-Übertragung kommt über ein eigenes Feld live_comments mit derselben Wertform und endet mit der Übertragung.

Wie sieht eine Benachrichtigung zu Kommentaren aus?

Ein POST, dessen JSON object auf instagram gesetzt ist und ein Array entry enthält. Jeder Eintrag steht für ein professionelles Konto: seine ID, den Zeitpunkt, zu dem Meta die Benachrichtigung gesendet hat, und ein Array changes mit einer Änderung pro Kommentar. Eine Antwort auf ein Reel sieht so aus:

A comments notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000,
      "changes": [
        {
          "field": "comments",
          "value": {
            "id": "<COMMENT_ID>",
            "parent_id": "<PARENT_COMMENT_ID>",
            "text": "<COMMENT_TEXT>",
            "from": {
              "id": "<INSTAGRAM_SCOPED_ID>",
              "username": "<USERNAME>"
            },
            "media": {
              "id": "<MEDIA_ID>",
              "media_product_type": "REELS"
            }
          }
        }
      ]
    }
  ]
}

Was bedeutet jedes Feld?

Die Felder, die Metas Webhook-Referenz für einen Kommentar auflistet, von außen nach innen:

  • entry[].id: die ID des professionellen Kontos, also die user_id, die /me dafür zurückgibt. Sie zeigt, zu welchem Konto der Kommentar gehört.
  • entry[].time: der Zeitpunkt, zu dem Meta die Benachrichtigung gesendet hat, als Unix-Zeitstempel. Es ist nicht der Zeitpunkt, an dem der Kommentar geschrieben wurde.
  • changes[].field: comments oder live_comments bei einer Live-Übertragung. Prüfen Sie es, bevor Sie value lesen.
  • value.id: die ID des Kommentars, die Sie für eine öffentliche oder private Antwort, zum Ausblenden oder Löschen verwenden.
  • value.text: der Text des Kommentars, enthalten, wenn der Kommentar Text hat.
  • value.from.id und value.from.username: die Instagram-scoped ID und der Benutzername des Autors. value.from.self_ig_scoped_id erscheint, wenn das Konto selbst den Kommentar geschrieben hat.
  • value.media.id und value.media.media_product_type: das kommentierte Medium und seine Fläche; Metas Medienreferenz nennt AD, FEED, STORY und REELS.
  • value.parent_id: bei einer Antwort die ID des Kommentars, auf den sie antwortet. Ein Kommentar auf oberster Ebene hat keines.
  • value.media.ad_id, ad_title und original_media_id: laut Referenz bei Kommentaren zu einer Anzeige aufgeführt.

Was meldet das Feld comments nicht?

Einiges, was ein Handler erwarten könnte, fehlt im Ereignis oder wird nie gesendet, laut Metas Einrichtungsanleitung und Referenzen:

  • Kommentare zu Medien eines privaten Kontos: Meta sendet dafür keine Benachrichtigungen zu Kommentaren oder Erwähnungen.
  • Album-IDs: Das Ereignis enthält sie nicht, und Meta empfiehlt, das Album über die ID des Kommentars nachzuschlagen.
  • Anzeigen-IDs für Medien in dynamischen Anzeigen.
  • Der Erstellungszeitpunkt des Kommentars: GET /<COMMENT_ID>?fields=timestamp liefert ihn im Format ISO 8601.
  • Live-Kommentare nach dem Ende der Übertragung, wenn die Benachrichtigungen für Live-Medien enden.
  • Story-Erwähnungen, die die Mentions-API nicht unterstützt; sie erreichen das Konto stattdessen als DMs.
  • Vergangene Ereignisse: Meta bewahrt keinen Benachrichtigungsverlauf zum Abfragen auf, daher speichern Sie, was Sie brauchen, sobald jedes eintrifft.

Was braucht das Feld comments?

Mit Instagram Login die Berechtigungen instagram_business_basic und instagram_business_manage_comments sowie Advanced Access, das Meta für comments- und live_comments-Benachrichtigungen verlangt. Die App muss live sein und im App-Dashboard für comments abonniert sein, und jedes Konto muss über POST /<IG_ID>/subscribed_apps abonniert werden, mit comments in seinen subscribed_fields. Meta empfiehlt diesen Webhook nachdrücklich gegenüber Polling bei Kommentaren, da er das Rate-Limit schont.

Wie antworten Sie auf einen Kommentar aus dem Ereignis?

Mit den IDs, die es mitliefert. POST /<COMMENT_ID>/replies mit einer message veröffentlicht eine öffentliche Antwort unter dem Kommentar, mit value.id. POST /<IG_ID>/messages mit recipient.comment_id und value.id als Wert sendet dem Autor eine private Antwort, innerhalb von 7 Tagen nach dem Kommentar oder solange die Live-Übertragung läuft. from.id ist eine Instagram-scoped ID, doch eine DM direkt an sie schlägt fehl, bis die Person dem Konto geschrieben hat; die private Antwort ist deshalb der Weg, sie per DM zu erreichen.

Wie leitet easyCoexistence einen Kommentar weiter?

Sobald er eintrifft, nachdem für das Konto ein Endpoint gesetzt wurde, entweder mit set_social_webhook_destination aus Claude oder ChatGPT oder mit PUT /channels/:id/webhook über die Partner API. easyCoexistence abonniert jedes verbundene Konto für die Felder, über die seine Kommentare, Erwähnungen und DMs laufen, prüft Metas Signatur bei jeder Zustellung, antwortet Meta sofort und sendet jeden Eintrag für dieses Konto als POST an Ihren HTTPS-Endpoint in einem Umschlag:

  • platform und external_id: instagram und die Instagram-ID des Kontos, gleich entry.id.
  • account_id: die ID der Verbindung in easyCoexistence, die list_social_accounts zurückgibt und die MCP-Tools verwenden.
  • entry: Metas Eintrag für das Konto unverändert, sodass eine gebündelte Zustellung zu einem POST pro Eintrag wird. Metas Feld object und X-Hub-Signature-256 werden nicht weitergegeben.
  • Zustellung: ein Versuch, mit bis zu 8 Sekunden Wartezeit, ohne Weiterleitungen, an eine HTTPS-Adresse, die auf eine öffentliche IP auflöst. Es wird keine Kopie gespeichert und nichts wiederholt.
A forwarded comment, 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": 1793448000,
    "changes": [
      {
        "field": "comments",
        "value": {
          "id": "<COMMENT_ID>",
          "text": "<COMMENT_TEXT>",
          "from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
          "media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
        }
      }
    ]
  }
}

Was machen Kommentar-zu-DM-Regeln mit demselben Ereignis?

Sie lesen es zusammen mit der Weiterleitung. Eine Regel greift, wenn der Kommentar eines ihrer Schlüsselwörter enthält, ohne auf Groß- und Kleinschreibung zu achten, und zwar auf einem ausgewählten Beitrag oder auf allen. Sie sendet dem Autor die DM der Regel als private Antwort, dazu eine öffentliche Antwort, falls die Regel eine hat. Kommentare des Kontos selbst werden übersprungen; Automatisierungen, die bei einem Kommentar starten, übernehmen die Kommentare, auf die keine Regel geantwortet hat, und ein Kommentar, auf den eine Regel geantwortet hat, erreicht trotzdem Ihren Endpoint. Die öffentliche Antwort der Regel kann als neues Ereignis comments vom Konto selbst zurückkommen.

Häufige Fehler

  • comment_id suchen. Bei Instagram Login steht die ID des Kommentars in value.id; comment_id gehört zu den Payloads der anderen Anmeldeverfahren von Meta.
  • Auf die eigenen Kommentare des Kontos antworten. Dessen Antworten kommen als Ereignisse comments mit from.id gleich entry.id zurück, und eine Automatisierung, die darauf antwortet, unterhält sich am Ende mit sich selbst.
  • entry.time als Zeitpunkt des Kommentars lesen. Es gibt an, wann Meta die Benachrichtigung gesendet hat; das eigene Feld timestamp des Kommentars sagt, wann er geschrieben wurde.
  • Auf Live-Kommentare im Feld comments warten. Sie kommen über live_comments, das ein eigenes Abonnement braucht und verstummt, sobald die Übertragung endet.
Mit EasyCoexistence

Kommentar-zu-DM-Regeln und Automatisierungen antworten rund um die Uhr auf dieselben Kommentare. Ab US$ 9 pro verbundenem Konto und Monat, sinkend auf US$ 0.75 mit jeder weiteren Verbindung, die ersten 3 Tage kostenlos.

Häufig gestellte Fragen

Enthält der Instagram-Webhook für Kommentare auch Antworten auf Kommentare?

Ja. Eine Antwort kommt als eigenes Ereignis comments, wobei parent_id die ID des Kommentars enthält, auf den sie antwortet.

Lösen Kommentare unter Reels den Instagram-Webhook für Kommentare aus?

Ja. Ein Kommentar zu einem Reel kommt im Feld comments wie einer zu einem Beitrag, und media.media_product_type unterscheidet beide.

Warum wird mein Instagram-Webhook für Kommentare nicht ausgelöst?

Meistens ist die App nicht live oder hat kein Advanced Access, das Konto wurde nie über /subscribed_apps abonniert, das Medium gehört einem privaten Konto, oder der Kommentar stammte aus einer Live-Übertragung, die live_comments verwendet.

Enthält der Webhook für Kommentare den Benutzernamen des Kommentierenden?

Ja. value.from enthält den Benutzernamen der Person neben ihrer Instagram-scoped ID, sodass kein weiterer Aufruf nötig ist, um anzuzeigen, wer kommentiert hat.

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