Instagram-Webhook-Events: Kommentare, Erwähnungen und DMs
Instagram-Webhook-Events melden Aktivität auf einem professionellen Konto in dem Moment, in dem sie passiert: neue Kommentare, @-Erwähnungen und DMs. Meta sendet jedes davon als JSON per POST an den HTTPS-Endpoint der verbundenen App und wiederholt eine fehlgeschlagene Zustellung an diesen Endpoint für bis zu 36 Stunden. easyCoexistence leitet jedes Ereignis einmal an Ihren Endpoint weiter, pro Konto signiert, ohne Wiederholungen. Bei Instagram Login kommen Erwähnungen innerhalb der Kommentarbenachrichtigung an.
Wie lange Meta eine fehlgeschlagene Zustellung an den Endpoint der App wiederholt, bevor sie verworfen wird.
Die meisten Updates fasst Meta zu einer einzigen Webhook-Zustellung zusammen, garantiert das Bündeln jedoch nicht.
Das Kennzeichen, das Meta bei Nachrichten-Events setzt, die das Konto selbst gesendet hat.
Nur Medien auf öffentlichen Konten lösen Benachrichtigungen zu Kommentaren und Erwähnungen aus.
Welche Events gibt es?
Bei einem professionellen Konto, das mit Instagram Login verbunden ist, kommen drei Arten von Aktivität als Events an:
- Kommentare: ein neuer Kommentar zu den Medien des Kontos, mit der Kommentar-ID, der Instagram-bezogenen ID und dem Benutzernamen des Autors, dem Text sowie der Medien-ID und dem Medientyp.
- Erwähnungen: Bei Instagram Login kommen sie innerhalb der Kommentarbenachrichtigung an und nicht als eigenes Feld.
- Nachrichten: eine DM an das Konto, mit Absender, Empfänger, Zeitstempel und der Nachricht selbst, einschließlich Text, Anhängen und Story-Antworten.
Wie gelangen die Events an Ihren Endpoint?
Meta liefert Instagram-Webhooks an die App, mit der das Konto verbunden ist. easyCoexistence empfängt sie und leitet jedes Event sofort an den HTTPS-Endpoint weiter, den Sie für dieses Konto festgelegt haben, signiert mit einem Geheimschlüssel für dieses Konto.
Legen Sie den Endpoint mit set_social_webhook_destination über Claude oder ChatGPT fest oder mit der Partner API über PUT /channels/:id/webhook. Der Geheimschlüssel wird nur einmal angezeigt. Wenn Sie den Endpoint erneut festlegen, wird ein neuer ausgegeben, und wenn Sie null als URL übergeben, wird die Weiterleitung ausgeschaltet.
Wie sieht eine Zustellung aus?
Ein POST mit einem JSON-Body, der die Plattform, die account_id der Verbindung (aus list_social_accounts), die external_id des Instagram-Kontos sowie entry enthält: Metas Webhook-Entry für das Event, unverändert. Eine DM kommt auf dieselbe Weise an, nur mit einem messaging-Array anstelle von changes. Ein neuer Kommentar sieht so aus:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}Wie prüfen Sie eine Zustellung?
Jede Zustellung trägt einen X-EC-Signature-Header in der Form t=<unix>,v1=<hex>. v1 ist der HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem rohen Body der Anfrage, berechnet mit dem Geheimschlüssel des Kontos. Berechnen Sie ihn über den rohen Body genau so, wie er empfangen wurde, vergleichen Sie in konstanter Zeit und lehnen Sie einen Zeitstempel ab, der älter als 5 Minuten ist.
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}Wird eine Zustellung wiederholt?
Nicht durch easyCoexistence: Die Weiterleitung gibt jedes Event genau einmal weiter, im Arbeitsspeicher, und behält keine Kopie, von der aus sie wiederholt werden könnte. Antworten Sie zügig mit einem 2xx und erledigen Sie die Arbeit danach. Speichern Sie, was Sie benötigen, sobald es eintrifft, denn Meta führt ebenfalls keine abfragbare Historie vergangener Benachrichtigungen.
Meta selbst wiederholt eine fehlgeschlagene Zustellung an die App bis zu 36 Stunden lang, daher kann dasselbe Event gelegentlich zweimal ankommen. Entfernen Sie Duplikate anhand der Kommentar-ID oder der mid der Nachricht.
Was sollte ein Handler außerdem prüfen?
Einige Details in Metas Payloads stolpern bei einem ersten Handler:
is_echo: Ein Nachrichten-Event mitis_echoauf true wurde vom Konto selbst gesendet, deshalb ist keine Antwort nötig.- Story-Antworten: Eine DM, die auf eine Story antwortet, enthält
reply_tomit der ID und URL der Story. - Story-Erwähnungen: kommen als Nachricht an, deren Anhangtyp
story_mentionist. - time: der Zeitpunkt, zu dem Meta die Benachrichtigung gesendet hat, nicht der Zeitpunkt, an dem der Kommentar oder die Nachricht entstand. Der eigene Zeitstempel einer Nachricht steht in ihrem messaging-Eintrag.
- Album-IDs: Kommentar-Events enthalten sie nicht. Suchen Sie das Album über die Kommentar-ID nach.
Häufige Fehler
- Arbeit vor der Antwort erledigen. Die Weiterleitung wiederholt nicht, also antworten Sie sofort mit einem 2xx und verarbeiten das Event danach.
- Signatur über geparstes JSON prüfen. Berechnen Sie den HMAC über den rohen Body genau so, wie er eingetroffen ist.
- Auf Echos antworten. Ein Nachrichten-Event mit gesetztem is_echo wurde vom Konto gesendet, und eine Antwort darauf startet eine Schleife.
- Deduplizierung auslassen. Meta kann nach einem Fehler dasselbe Event erneut zustellen. Verwenden Sie daher die Kommentar-ID oder die mid der Nachricht als Schlüssel.
easyCoexistence leitet die Kommentare, Erwähnungen und DMs des Instagram-Kontos sofort an Ihren HTTPS-Endpoint weiter, signiert mit einem Geheimschlüssel für dieses Konto und ohne unterwegs eine Kopie zu speichern. Aktivieren Sie es mit set_social_webhook_destination über Claude oder ChatGPT oder mit der Partner API. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit kostenloser Testphase über die ersten 3 Tage.
Häufig gestellte Fragen
Was bedeutet das Feld time in einem Instagram-Webhook?
Den Zeitpunkt, zu dem Meta die Benachrichtigung gesendet hat, nicht den, an dem der Kommentar oder die Nachricht entstand. Der eigene Zeitstempel einer DM steht in ihrem messaging-Eintrag.
Wiederholt Meta fehlgeschlagene Instagram-Webhook-Zustellungen?
Ja. Meta wiederholt eine fehlgeschlagene Zustellung an die App bis zu 36 Stunden lang, daher kann dasselbe Event gelegentlich zweimal ankommen. Entfernen Sie Duplikate anhand der Kommentar-ID oder der mid der Nachricht. easyCoexistence leitet jedes Event genau einmal an Ihren Endpoint weiter, antworten Sie also zügig mit einem 2xx.
Wie viele Updates kann eine Instagram-Webhook-Zustellung enthalten?
Bis zu 1.000, wenn Meta sie bündelt, wobei Meta das Bündeln nicht garantiert. Durchlaufen Sie das gesamte entry-Array, statt nur dessen erstes Element zu lesen.
Haben Erwähnungen ein eigenes Event?
Nicht bei Instagram Login. Meta nimmt Erwähnungen in die Kommentarbenachrichtigung auf, daher kommen sie auf demselben Weg an wie Kommentare.
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