Instagram-Webhook-Felder: die vollständige Liste
Für ein professionelles Konto mit Instagram Login listet die Tabelle der Webhook-Felder von Meta comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover und standby auf, wobei mentions innerhalb von comments zugestellt werden; die Beispiele nennen zusätzlich message_edit. Jedes braucht instagram_business_basic sowie instagram_business_manage_comments oder, für die meisten Messaging-Felder, instagram_business_manage_messages. story_insights wird bei Instagram Login nicht angeboten.
easyCoexistence abonniert jedes verbundene Instagram-Konto für comments, messages und mentions und leitet diese Ereignisse an Ihren HTTPS-Endpoint weiter, sobald sie eintreffen, signiert mit dem Secret dieses Kontos.
Felder, auf die ein neues Instagram-Produkt im App Dashboard standardmäßig abonniert ist, darunter comments, messages und message_reactions.
Felder werden für die App ausgewählt, nicht pro Konto: Ein Konto erhält die Felder, die die App ausgewählt hat.
Die Zugriffsstufe, die Metas Einrichtungsanleitung für Instagram-Login-Webhooks nennt und für Benachrichtigungen zu comments und live_comments voraussetzt.
Bei Instagram Login in Metas Feldtabelle als nicht verfügbar gekennzeichnet, angeboten wird es mit Facebook Login und Unified Login.
Als Meta den Webhook message_edit für Business Login for Instagram und Facebook Login for Business einführte.
Welche Webhook-Felder bietet Instagram Login?
Diese, aus Metas Feldtabelle, mit dem, was jedes auslöst, aus den Beispielen und der Webhook-Referenz. Zusätzlich zur angegebenen Berechtigung braucht jedes Feld instagram_business_basic, und Meta verlangt Advanced Access für Benachrichtigungen zu comments und live_comments.
Welche Felder sind bei Instagram Login nicht verfügbar?
Drei Zeilen von Metas Feldtabelle haben keine Berechtigung für Instagram Login, daher erhält eine App mit Instagram Login sie nicht, und ein weiteres Feld gibt es nur außerhalb davon:
story_insights: die Metriken einer Story, wenn sie abläuft, mit Facebook Login oder Unified Login undinstagram_manage_insights. Metas Referenz zu Media Insights sagt, dass der Insights-Webhook mit Instagram Login nicht unterstützt wird.messaging_policy_enforcementundresponse_feedback: nur in der Spalte für Metas Instagram Messaging API.- mentions als eigenständiges Feld: Facebook Login und Unified Login führen es mit
instagram_manage_commentsauf, während Instagram Login mentions in comments zusammenfasst.
Wie abonniert man Felder?
An zwei Stellen. Im App Dashboard speichert man unter den Webhook-Einstellungen des Instagram-Produkts die Callback-URL und den Verify Token, was Metas Verifizierungsanfrage auslöst, und wählt dann die Felder aus; ein neues Instagram-Produkt startet mit acht davon abonniert. Danach abonniert man jedes Konto mit POST /<IG_ID>/subscribed_apps auf graph.instagram.com, wobei subscribed_fields die im Dashboard gewählten Felder kommagetrennt enthält.
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages,message_reactions
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }Kann jedes Konto andere Felder erhalten?
Nein. Metas Einrichtungsanleitung sagt, dass Felder nicht pro Konto der App-Nutzer gewählt werden können: Ein Konto erhält die für die App gewählten Felder. subscribed_fields im Abonnement des Kontos soll die Felder des Dashboards auflisten, daher sollte ein Handler mit jedem Feld rechnen, das die App ausgewählt hat, und anhand des Inhalts jedes Ereignisses entscheiden, nicht anhand dessen, was er für ein Konto angefordert hat.
Wie unterscheidet man die Felder in einer Benachrichtigung?
Anhand der Form des Eintrags. Kommentarfelder kommen in einem changes-Array, wobei jede Änderung ihr Feld nennt. Messaging-Felder kommen in einem messaging-Array ohne Feldnamen, und der Schlüssel neben sender, recipient und timestamp unterscheidet sie:
- changes[].field: comments oder
live_comments, mit dem Kommentar in value. - message: messages, einschließlich Echos der eigenen Nachrichten des Kontos, die
is_echoauf true gesetzt haben. - reaction:
message_reactions. postback:messaging_postbacks. read:messaging_seen.message_edit:message_edit. - referral neben sender:
messaging_referral. Ein referral innerhalb von message gehört zu messages, aus einem neuen Thread oder einer Click-to-Direct-Anzeige. pass_thread_control,take_thread_controloderrequest_thread_control:messaging_handover, wie Metas Webhook-Referenz sie auflistet.
Welche Felder abonniert easyCoexistence?
comments, messages und mentions, die Liste, mit der jedes Instagram-Konto beim Verbinden abonniert wird. Bei Instagram Login kommen die mentions innerhalb von comments, daher umfasst das Abonnement Kommentare und Direktnachrichten, wobei Echos, Story-Antworten, Story-Erwähnungen und Anhänge zu den Direktnachrichten gehören. Die übrigen Felder der Tabelle liefert Meta an eine App, die sie abonniert hat, und sie sind nicht Teil des Abonnements einer Verbindung. Sobald ein Endpoint mit set_social_webhook_destination oder der Partner API gesetzt ist, prüft easyCoexistence die Signatur von Meta, antwortet Meta sofort und sendet jeden Eintrag für das Konto per POST an ihn:
- platform und
external_id: instagram und die Instagram-ID des Kontos, gleich entry.id. account_id: die ID der Verbindung in easyCoexistence, die die MCP-Tools verwenden.- entry: Metas entry für das Konto, unverändert. Metas Feld object und sein Header X-Hub-Signature-256 werden nicht weitergegeben.
- X-EC-Signature: t=<unix>,v1=<hex>, ein HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem rohen Body, mit dem eigenen Geheimnis des Kontos als Schlüssel.
- Zustellung: ein Versuch mit bis zu 8 Sekunden, ohne Weiterleitungen, ohne gespeicherte Kopie und ohne Wiederholungen.
Häufige Fehler
- Auf ein Feld mentions bei Instagram Login warten. Meta fasst mentions in die Benachrichtigung zu comments zusammen, daher läuft ein Handler, der auf das Feld mentions wartet, nie.
- Annehmen, ein Konto erhalte nur die Felder seines eigenen Abonnements. Meta liefert die für die App gewählten Felder, daher nach dem Inhalt jedes Ereignisses verzweigen.
- message.referral und ein referral auf oberster Ebene als ein Ereignis behandeln. Das erste läuft über messages; das zweite ist messaging_referral, für einen ig.me-Link, der in einer bestehenden Unterhaltung geöffnet wurde.
- Auf story_insights bei Instagram Login warten. Meta kennzeichnet es dort als nicht verfügbar, daher die Metriken einer Story aus dem Insights-Endpoint lesen, solange sie noch aktiv ist.
Ereignisse werden standardmäßig nicht gespeichert; ein Konto mit eingeschalteter Automatisierung behält seine DMs und Kommentare 7 Tage lang. Setzen Sie den Endpoint mit set_social_webhook_destination aus Claude oder ChatGPT oder über die Partner API. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Hat Instagram Login ein Webhook-Feld für mentions?
Kein eigenes. Meta nimmt mentions bei Instagram Login in die Benachrichtigung zu comments auf; mentions ist bei Facebook Login und Unified Login ein eigenes Feld.
Ist story_insights mit Instagram Login verfügbar?
Nein. Metas Feldtabelle kennzeichnet es bei Instagram Login als nicht verfügbar, und die Referenz zu Media Insights sagt, dass der Insights-Webhook dort nicht unterstützt wird.
Welche Berechtigungen braucht der Webhook für Instagram-Nachrichten?
instagram_business_basic und instagram_business_manage_messages, mit Advanced Access, wie Metas Einrichtungsanleitung für Instagram-Login-Webhooks angibt.
Wann hat Meta den Webhook message_edit für Instagram eingeführt?
Am 10. September 2025, für Business Login for Instagram und Facebook Login for Business. Eine Bearbeitung kommt im messaging-Array unter dem Schlüssel message_edit an.
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