message_reactions-Webhook von Instagram: die Payload für Reagieren und Zurücknehmen
Das message_reactions-Feld des Instagram-Webhooks benachrichtigt eine App, wenn eine Person auf eine Nachricht in ihrer Unterhaltung mit einem professionellen Konto reagiert oder die Reaktion entfernt. Das Ereignis steht im messaging-Array mit einem reaction-Objekt: mid, die ID der Nachricht, auf die reagiert wurde; action, react oder unreact; und bei react zusätzlich reaction, etwa love, sowie emoji, das Emoji selbst.
easyCoexistence abonniert jedes verbundene Instagram-Konto für comments, messages und mentions und leitet diese Ereignisse bei Eingang an Ihren HTTPS-Endpoint weiter, signiert mit dem Geheimschlüssel des jeweiligen Kontos, wobei jede Nachricht ihre mid trägt.
Die zwei Werte von reaction.action: eine hinzugefügte Reaktion oder eine entfernte Reaktion.
Graph-API-Version, ab der Meta angry, sad, wow, love, like, laugh und weitere Reaktionen in diesem Webhook unterstützt.
Meta sendet keine Benachrichtigung, wenn das Konto selbst auf eine Nachricht einer Person reagiert oder die Reaktion entfernt.
message_reactions gehört zu den Feldern, die ein neues Instagram-Produkt im App Dashboard von Anfang an abonniert hat.
Send-API-Aufrufe pro Sekunde und Konto für Text, Links, Reaktionen und Sticker.
Wann wird message_reactions ausgelöst?
Wenn eine Person auf eine Nachricht in ihrer Unterhaltung mit dem professionellen Konto reagiert, und erneut, wenn sie diese Reaktion entfernt, sobald App und Konto für das Feld abonniert sind. Metas Anleitung zu Instagram Messaging ist in der anderen Richtung eindeutig: Reagiert das Konto selbst oder entfernt es seine Reaktion, wird keine Benachrichtigung gesendet, und messages liefert dafür ebenfalls kein Echo.
Wie sieht eine Reaktionsbenachrichtigung aus?
Ein POST mit object auf instagram, dessen entry ein messaging-Array enthält. Anders als bei einer DM trägt das Ereignis kein message-Objekt: Die Reaktion steht in einem eigenen reaction-Objekt, neben sender, recipient und timestamp. Metas Beispiel für Instagram Login:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "react",
"reaction": "love",
"emoji": "\u{2764}\u{FE0F}"
}
}
]
}
]
}Was bedeutet jedes Feld?
Die Felder, die Meta für ein Reaktionsereignis dokumentiert, von außen nach innen:
- entry[].id und recipient.id: das professionelle Konto. sender.id: die Instagram-scoped ID der Person, die reagiert hat.
- timestamp: wann das Ereignis ausgelöst wurde, in Millisekunden in Metas Beispielen; entry[].time ist der Zeitpunkt, zu dem Meta die Benachrichtigung gesendet hat.
- reaction.mid: die ID der Nachricht, auf die reagiert wurde, dieselbe mid, die diese Nachricht in ihrem messages-Ereignis hatte.
- reaction.action: react, wenn eine Reaktion hinzugefügt wird, unreact, wenn sie entfernt wird.
- reaction.reaction: der Name der Reaktion, etwa love; Meta führt angry, sad, wow, love, like, laugh und other auf.
- reaction.emoji: das Emoji als Unicode-String, etwa \u{2764}\u{FE0F} für love.
- Bei unreact fehlen reaction und emoji.
Wie sieht ein unreact aus?
Dasselbe Ereignis mit action auf unreact und ohne reaction und emoji, da nichts mehr zu benennen ist. Ordnen Sie es der entfernten Reaktion über reaction.mid und sender.id zu und entfernen Sie die Reaktion dieser Person aus der Nachricht in Ihren Aufzeichnungen.
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}Auf welche Nachricht zeigt mid?
Auf die Nachricht, auf die die Person reagiert hat, unter derselben mid, die sie in ihrem messages-Ereignis trug, einschließlich der Echos der eigenen Nachrichten des Kontos. Ein Handler, der mids speichert, kann die Reaktion der richtigen Zeile der Unterhaltung zuordnen. Meta weist auf eine Lücke hin: Eine Reaktion auf ein Bild eines Karussell-Posts meldet das erste Bild des Karussells, das möglicherweise nicht das gewählte ist.
Wie reagiert ein Konto auf eine Nachricht?
Mit POST /<IG_ID>/messages: recipient.id auf die Instagram-scoped ID der Person, sender_action auf react und eine payload mit message_id und reaction, einem Emoji oder dessen UTF-8-Form. Wiederholt man den Aufruf mit einem anderen Emoji, ändert sich die Reaktion; sender_action auf unreact mit nur message_id entfernt sie. Keiner der beiden Aufrufe erzeugt einen Webhook.
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "id": "<IGSID>" },
"sender_action": "react",
"payload": {
"message_id": "<MESSAGE_ID>",
"reaction": "<EMOJI>"
}
}Was braucht message_reactions?
Mit Instagram Login instagram_business_basic und instagram_business_manage_messages sowie Advanced Access für Konten, die der Entwickler nicht besitzt oder verwaltet. Ein neues Instagram-Produkt im App Dashboard ist von Anfang an auf message_reactions abonniert, und jedes Konto wird über POST /<IG_ID>/subscribed_apps abonniert. Metas Anleitung Send Messages führt es als messaging_reactions auf, doch seine Feldtabelle, die Standardwerte im Dashboard und die Webhook-Referenz nennen message_reactions.
Leitet easyCoexistence Reaktionen weiter?
Nein. Die App von easyCoexistence und jedes verbundene Konto sind nur für comments, messages und mentions abonniert, daher werden message_reactions-Ereignisse nicht an Ihren Endpoint weitergeleitet. Die DMs und Echos, auf die Reaktionen über ihre mid zeigen, erreichen ihn jedoch, signiert mit dem Secret des Kontos.
Häufige Fehler
- Die Reaktion im message-Objekt suchen. Ein Reaktionsereignis hat kein message-Objekt; lesen Sie das reaction-Objekt neben sender und recipient.
- reaction oder emoji lesen, ohne action zu prüfen. Beide fehlen bei unreact, daher bricht Code, der sie voraussetzt, wenn eine Reaktion entfernt wird.
- Auf einen Webhook warten, nachdem das Konto reagiert hat. Meta sendet dafür keinen, auch kein Echo, also protokollieren Sie die eigenen Reaktionen des Kontos, wenn Ihre App sie sendet.
- Den Namen messaging_reactions aus Metas Anleitung Send Messages übernehmen. Das Feld in dessen Feldtabelle, den Standardwerten im Dashboard und der Webhook-Referenz heißt message_reactions.
Ihr Agent antwortet einer Person mit send_social_dm innerhalb des 24-Stunden-Fensters. US$ 9 bis US$ 0.75 pro Verbindung und Monat, je mehr Verbindungen Sie hinzufügen, desto weniger, mit den ersten 3 Tagen in der kostenlosen Testphase.
Häufig gestellte Fragen
Warum zeigt eine Reaktion auf einen Karussell-Post auf das erste Bild?
Meta meldet das erste Bild des Karussells, wenn jemand auf eines seiner Bilder reagiert, und das ist möglicherweise nicht das Bild, das die Person gewählt hat.
Sendet Instagram einen Webhook, wenn das Unternehmen auf eine Nachricht reagiert?
Nein. Meta sendet keine message_reactions-Benachrichtigung und kein Echo, wenn das Konto auf eine Nachricht reagiert oder seine Reaktion entfernt.
Welche Reaktionen kann der Instagram-Webhook melden?
Metas Anleitung zu Instagram Messaging führt angry, sad, wow, love, like, laugh und other ab Graph API v12.0 auf, wobei das Emoji selbst in reaction.emoji steht.
Heißt das Webhook-Feld message_reactions oder messaging_reactions?
message_reactions. Metas Anleitung Send Messages schreibt messaging_reactions, doch Feldtabelle, Standardwerte im App Dashboard und Webhook-Referenz verwenden alle message_reactions.
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