Erwähnungen

Identifiziere Bildunterschriften, Kommentare und IG-Medien, in denen der Alias eines Instagram Business- oder Creator-Kontos markiert oder @erwähnt wurde.

Einschränkungen

• Für Stories werden keine Mentions unterstützt.
• Fotos, in denen du markiert wurdest, können nicht kommentiert werden.
• Webhooks werden nicht gesendet, wenn das Medium, in dem der Kommentar oder die @Erwähnung erscheint, von einem Konto erstellt wurde, das auf privat gesetzt ist.

Endpunkte

Die API besteht aus den folgenden Endpunkten:

• GET /{ig-user-id}/tags – zum Abrufen der Medienobjekte, in denen ein Business- oder Creator-Konto markiert wurde
• GET /{ig-user-id}?fields=mentioned_comment – zum Abrufen eines Kommentars, in dem ein Business- oder Creator-Konto @erwähnt wurde
• GET /{ig-user-id}?fields=mentioned_media – zum Abrufen von Daten zu einem Medienobjekt, in dem ein Business- oder Creator-Konto in einer Bildunterschrift @erwähnt wurde
• POST /{ig-user-id}/mentions – zum Antworten auf einen Kommentar oder eine Bildunterschrift eines Medienobjekts, in dem/der ein Business- oder Creator-Konto von einem anderen Instagram-Nutzer @erwähnt wurde

Informationen zu Nutzungsanweisungen findest du in der Referenzdokumentation zu den einzelnen Endpunkten.

Webhooks

Abonniere das mentions-Feld, um Instagram Webhooks-Benachrichtigungen zu erhalten, wenn ein Instagram-Nutzer ein Instagram Business- oder Creator-Konto erwähnt. Beachte, dass wir keine Webhooks-Benachrichtigungsdaten speichern. Wenn du also einen Webhook einrichtest, der Erwähnungen abfragt, solltest du alle erhaltenen Daten speichern, um sie später gegebenenfalls wiederverwenden zu können.

Beispiele

Abrufen von und Antworten auf @Erwähnungen in Kommentaren

Du kannst einen Listener für @Erwähnungen in Kommentaren einrichten und auf alle Erwähnungen antworten, die deinen Kriterien entsprechen:

1. Richte einen Instagram-Webhook ein, der das mentions-Feld abonniert hat.
2. Richte ein Skript ein, das die Webhooks-Benachrichtigungen analysieren und Kommentar-IDs identifizieren kann.
3. Frage mit den IDs den GET /{ig-user-id}/mentioned_comment-Endpunkt ab, um mehr Informationen zu den einzelnen Kommentaren zu erhalten.
4. Analysiere die zurückgegebenen Ergebnisse, um alle Kommentare zu identifizieren, die deinen Kriterien entsprechen.
5. Verwende den POST /{ig-user-id}/mentions-Endpunkt, um auf diese Kommentare zu antworten.

Die Antwort wird als Sub-Thread-Kommentar zu dem Kommentar angezeigt, in dem das Business- oder Creator-Konto erwähnt wurde.

Abrufen von und Antworten auf @Erwähnungen in Bildunterschriften

Du kannst einen Listener für @Erwähnungen in Bildunterschriften einrichten und auf alle Erwähnungen antworten, die deinen Kriterien entsprechen:

1. Richte einen Instagram-Webhook ein, der das mentions-Feld abonniert hat.
2. Richte ein Skript ein, das die Webhooks-Benachrichtigungen analysieren und Medien-IDs identifizieren kann.
3. Frage mit den IDs den GET /{ig-user-id}/mentioned_media-Endpunkt ab, um mehr Informationen zu den einzelnen Medienobjekten zu erhalten.
4. Analysiere die zurückgegebenen Ergebnisse, um die Medienobjekte in Bildunterschriften zu identifizieren, die deinen Kriterien entsprechen.
5. Verwende den POST /{ig-user-id}/mentions-Endpunkt, um diese Medienobjekte zu kommentieren.