Instagram message_reactions-webhook: de payload bij react en unreact
Het message_reactions-veld van Instagram meldt aan een app wanneer iemand in het gesprek met een professioneel account op een bericht reageert of die reactie verwijdert. De gebeurtenis staat in de messaging-array, met een reaction-object: mid, de ID van het bericht waarop gereageerd is; action, react of unreact; en alleen bij react ook reaction, zoals love, en emoji, de emoji zelf.
easyCoexistence abonneert elk verbonden Instagram-account op comments, messages en mentions en stuurt die gebeurtenissen door naar je HTTPS-endpoint zodra ze binnenkomen, ondertekend met het geheim van dat account, elk bericht met zijn mid.
De twee waarden van reaction.action: een reactie toegevoegd, of een reactie verwijderd.
Vanaf welke Graph API-versie Meta angry, sad, wow, love, like, laugh en andere reacties ondersteunt in deze webhook.
Meta stuurt geen melding wanneer het account zelf op een bericht van een persoon reageert of die reactie verwijdert.
message_reactions behoort tot de velden waarop een nieuw Instagram-product in het App Dashboard standaard is geabonneerd.
Send API-aanroepen per seconde per account voor tekst, links, reacties en stickers.
Wanneer wordt message_reactions verstuurd?
Wanneer een persoon op een bericht reageert in het gesprek met het professionele account, en opnieuw wanneer die persoon de reactie verwijdert, zodra de app en het account zijn geabonneerd op het veld. In de Instagram Messaging-gids van Meta staat duidelijk wat er in de andere richting gebeurt: wanneer het account zelf reageert of een reactie verwijdert, wordt geen melding verstuurd, en ook messages levert daarvoor geen echo.
Hoe ziet een reactiemelding eruit?
Een POST met object ingesteld op instagram, waarvan entry een messaging-array bevat. Anders dan bij een DM bevat de gebeurtenis geen bericht-object: de reactie zit in een eigen reaction-object, naast sender, recipient en timestamp. Voorbeeld van Meta voor 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}"
}
}
]
}
]
}Wat betekent elk veld?
De velden die Meta voor een reactiegebeurtenis documenteert, van buiten naar binnen:
- entry[].id en recipient.id: het professionele account. sender.id: de Instagram-gebonden ID van de persoon die reageerde.
- timestamp: wanneer de gebeurtenis is geactiveerd, in milliseconden in de voorbeelden van Meta; entry[].time is wanneer Meta de melding verstuurde.
- reaction.mid: de ID van het bericht waarop gereageerd is, dezelfde mid die dat bericht had in zijn messages-gebeurtenis.
- reaction.action: react wanneer een reactie wordt toegevoegd, unreact wanneer die wordt verwijderd.
- reaction.reaction: de naam van de reactie, zoals love; Meta somt op angry, sad, wow, love, like, laugh en andere.
- reaction.emoji: de emoji als Unicode-string, zoals \u{2764}\u{FE0F} voor love.
- Bij unreact ontbreken reaction en emoji.
Hoe ziet een unreact eruit?
Dezelfde gebeurtenis met action ingesteld op unreact, zonder reaction en emoji, omdat er niets meer is om te benoemen. Koppel die aan de reactie die het verwijdert via reaction.mid en sender.id, en haal de reactie van die persoon bij dat bericht uit je gegevens.
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}Naar welk bericht wijst mid?
Naar het bericht waarop de persoon reageerde, onder dezelfde mid die het droeg in zijn messages-gebeurtenis, inclusief de echo's van de eigen berichten van het account. Een handler die mids opslaat, kan de reactie koppelen aan de juiste regel van het gesprek. Meta noemt één uitzondering: een reactie op één afbeelding van een carrouselpost meldt de eerste afbeelding van de carrousel, die niet altijd de gekozen afbeelding is.
Hoe reageert een account op een bericht?
Met POST /<IG_ID>/messages: recipient.id ingesteld op de Instagram-gebonden ID van de persoon, sender_action ingesteld op react, en een payload met message_id en reaction, een emoji of de UTF-8-vorm daarvan. Een herhaling van de aanroep met een andere emoji wijzigt de reactie, en sender_action ingesteld op unreact met alleen message_id verwijdert die. Geen van beide aanroepen levert een webhook op.
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>"
}
}Wat heeft message_reactions nodig?
Met Instagram Login: instagram_business_basic en instagram_business_manage_messages, en Advanced Access voor accounts die de ontwikkelaar niet bezit of beheert. Een nieuw Instagram-product in het App Dashboard is standaard geabonneerd op message_reactions, en elk account wordt geabonneerd via POST /<IG_ID>/subscribed_apps. In de Send Messages-gids van Meta staat het als messaging_reactions, maar de velden-tabel, de standaardinstellingen van het dashboard en de webhook-referentie zeggen message_reactions.
Stuurt easyCoexistence reacties door?
Nee. De app van easyCoexistence en elk verbonden account zijn alleen geabonneerd op comments, messages en mentions, dus message_reactions-events worden niet doorgestuurd naar je endpoint. De DM's en echo's waarnaar reacties via hun mid verwijzen, bereiken het wel, ondertekend met het geheim van het account.
Veelgemaakte fouten
- Zoeken naar de reactie binnen `message`. Een reactiegebeurtenis heeft geen `message`-object; lees het reaction-object naast sender en recipient.
- Reaction of emoji lezen zonder action te controleren. Beide ontbreken bij unreact, dus code die daar van uitgaat, breekt wanneer een reactie wordt verwijderd.
- Wachten op een webhook nadat het account heeft gereageerd. Meta stuurt er geen voor de eigen reacties van het account, ook geen echo, dus registreer ze zelf wanneer je app ze verstuurt.
- De naam messaging_reactions overnemen uit de Send Messages-gids van Meta. Het veld in de velden-tabel, de standaardinstellingen van het dashboard en de webhook-referentie is message_reactions.
Je agent antwoordt een persoon met send_social_dm binnen het venster van 24 uur. US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Waarom wijst een reactie op een carrouselpost naar de eerste afbeelding?
Meta meldt de eerste afbeelding van de carrousel wanneer iemand op een van de afbeeldingen reageert, en dat is niet altijd de afbeelding die de persoon koos.
Stuurt Instagram een webhook wanneer het bedrijf op een bericht reageert?
Nee. Meta stuurt geen message_reactions-melding en geen echo wanneer het account op een bericht reageert of een reactie verwijdert.
Welke reacties kan de Instagram-webhook melden?
Meta's Instagram Messaging-gids noemt angry, sad, wow, love, like, laugh en andere vanaf Graph API v12.0, met de emoji zelf in reaction.emoji.
Is de webhook-veldnaam message_reactions of messaging_reactions?
message_reactions. De Send Messages-gids van Meta schrijft messaging_reactions, maar de velden-tabel, de standaardinstellingen in het App Dashboard en de webhook-referentie gebruiken allemaal message_reactions.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op