Webhook message_reactions d'Instagram : le payload de react et unreact
Le champ webhook message_reactions d'Instagram prévient une application lorsqu'une personne réagit à un message de sa conversation avec un compte professionnel, ou retire sa réaction. L'événement figure dans le tableau messaging, avec un objet reaction : mid, l'ID du message auquel on a réagi ; action, react ou unreact ; et, uniquement pour react, reaction, comme love, et emoji, l'emoji lui-même.
easyCoexistence abonne chaque compte Instagram connecté aux commentaires, aux messages et aux mentions, et transmet ces événements à votre endpoint HTTPS dès leur arrivée, signés avec le secret de ce compte, chaque message avec son mid.
Les deux valeurs de reaction.action : une réaction ajoutée, ou une réaction retirée.
Version de l'API Graph à partir de laquelle Meta prend en charge angry, sad, wow, love, like, laugh et les autres réactions dans ce webhook.
Meta n'envoie aucune notification lorsque le compte lui-même réagit au message d'une personne ou retire sa réaction.
message_reactions fait partie des champs auxquels un nouveau produit Instagram dans l'App Dashboard est abonné par défaut.
Appels Send API par seconde et par compte pour le texte, les liens, les réactions et les stickers.
Quand message_reactions se déclenche-t-il ?
Lorsqu'une personne réagit à un message de sa conversation avec le compte professionnel, puis lorsqu'elle retire cette réaction, une fois l'application et le compte abonnés au champ. Le guide Instagram Messaging de Meta est explicite dans l'autre sens : lorsque le compte réagit ou retire une réaction, aucune notification n'est envoyée, et messages ne renvoie pas d'écho pour lui non plus.
À quoi ressemble une notification de réaction ?
Un POST avec object défini sur instagram, dont entry contient un tableau messaging. Contrairement à un DM, l'événement ne comporte pas d'objet message : la réaction figure dans son propre objet reaction, à côté de sender, recipient et timestamp. Exemple de Meta pour 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}"
}
}
]
}
]
}Que signifie chaque champ ?
Les champs que Meta documente pour un événement de réaction, de l'extérieur vers l'intérieur :
- entry[].id et recipient.id : le compte professionnel. sender.id : l'ID propre à Instagram de la personne qui a réagi.
- timestamp : le moment où l'événement a été déclenché, en millisecondes dans les exemples de Meta ; entry[].time correspond à l'envoi de la notification par Meta.
- reaction.mid : l'ID du message auquel on a réagi, le même mid que ce message avait dans son événement messages.
- reaction.action : react lorsqu'une réaction est ajoutée, unreact lorsqu'elle est retirée.
- reaction.reaction : le nom de la réaction, comme love ; Meta cite angry, sad, wow, love, like, laugh et other.
- reaction.emoji : l'emoji sous forme de chaîne Unicode, comme \u{2764}\u{FE0F} pour love.
- Sur unreact, reaction et emoji sont omis.
À quoi ressemble un unreact ?
Le même événement, avec action défini sur unreact et sans reaction ni emoji, puisqu'il n'y a plus rien à nommer. Associez-le à la réaction retirée grâce à reaction.mid et sender.id, puis supprimez la réaction de cette personne sur ce message dans vos enregistrements.
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}Quel message désigne mid ?
Le message auquel la personne a réagi, sous le même mid qu'il portait dans son événement messages, y compris les échos des propres messages du compte. Un gestionnaire qui stocke les mid peut rattacher la réaction à la bonne ligne de la conversation. Meta signale une limite : une réaction à une image d'un carrousel renvoie la première image du carrousel, qui n'est pas forcément celle choisie.
Comment un compte réagit-il à un message ?
Avec POST /<IG_ID>/messages : recipient.id défini sur l'ID Instagram de la personne, sender_action défini sur react, et un payload contenant message_id et reaction, un emoji ou sa forme UTF-8. Répéter l'appel avec un autre emoji modifie la réaction, et sender_action défini sur unreact avec seulement message_id la retire. Aucun de ces appels ne produit de 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>"
}
}De quoi message_reactions a-t-il besoin ?
Avec Instagram Login, instagram_business_basic et instagram_business_manage_messages, ainsi que l'Advanced Access pour les comptes que le développeur ne possède pas ou ne gère pas. Un nouveau produit Instagram dans l'App Dashboard est abonné par défaut à message_reactions, et chaque compte s'abonne via POST /<IG_ID>/subscribed_apps. Le guide Send Messages de Meta le liste sous messaging_reactions, mais son tableau des champs, les valeurs par défaut du tableau de bord et la référence des webhooks disent message_reactions.
easyCoexistence transmet-il les réactions ?
Non. L'app d'easyCoexistence et chaque compte connecté sont abonnés aux commentaires, messages et mentions uniquement, si bien que les événements message_reactions ne sont pas transmis à votre endpoint. Les DM et échos que les réactions visent par leur mid y parviennent, signés avec le secret du compte.
Erreurs courantes
- Chercher la réaction dans message. Un événement de réaction ne comporte pas d'objet message : lisez l'objet reaction à côté de sender et recipient.
- Lire reaction ou emoji sans vérifier action. Les deux sont omis sur unreact, donc le code qui les suppose présents casse lorsqu'une réaction est retirée.
- Attendre un webhook après que le compte a réagi. Meta n'en envoie aucun pour les réactions du compte, pas même un écho : enregistrez-les quand votre application les envoie.
- Copier le nom messaging_reactions depuis le guide Send Messages de Meta. Le champ dans son tableau des champs, les valeurs par défaut du tableau de bord et la référence des webhooks est message_reactions.
Votre agent répond à une personne avec send_social_dm dans la fenêtre de 24 heures. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.
Questions fréquemment posées
Pourquoi une réaction sur un carrousel renvoie-t-elle la première image ?
Meta renvoie la première image du carrousel lorsqu'une personne réagit à l'une de ses images, qui n'est pas forcément celle qu'elle a choisie.
Instagram envoie-t-il un webhook lorsque l'entreprise réagit à un message ?
Non. Meta n'envoie ni notification message_reactions ni écho lorsque le compte réagit à un message ou retire sa réaction.
Quelles réactions le webhook Instagram peut-il signaler ?
Le guide Instagram Messaging de Meta liste angry, sad, wow, love, like, laugh et other à partir de Graph API v12.0, avec l'emoji lui-même dans reaction.emoji.
Le champ webhook s'appelle-t-il message_reactions ou messaging_reactions ?
message_reactions. Le guide Send Messages de Meta écrit messaging_reactions, mais son tableau des champs, les valeurs par défaut de l'App Dashboard et la référence des webhooks utilisent tous message_reactions.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le