AccediInizia la prova gratuita
easyCoexistence API ufficiali

Webhook message_reactions di Instagram: il payload di react e unreact

Il campo message_reactions del webhook di Instagram avvisa un'app quando una persona reagisce a un messaggio nella sua conversazione con un account professionale, oppure rimuove la reazione. L'evento si trova nell'array messaging, con un oggetto reaction: mid, l'ID del messaggio con reazione; action, react oppure unreact; e, solo nel caso di react, reaction, come love, ed emoji, l'emoji stessa.

easyCoexistence sottoscrive ogni account Instagram connesso a comments, messages e mentions e inoltra questi eventi al tuo endpoint HTTPS non appena arrivano, firmati con il segreto di quell'account, ogni messaggio con il suo mid.

react / unreact

I due valori di reaction.action: una reazione aggiunta, oppure una reazione rimossa.

v12.0

Versione della Graph API da cui Meta supporta in questo webhook angry, sad, wow, love, like, laugh e altre reazioni.

No echo

Meta non invia alcuna notifica quando è l'account stesso a reagire a un messaggio o a rimuovere una reazione.

Default

message_reactions è tra i campi a cui un nuovo prodotto Instagram nella App Dashboard risulta sottoscritto fin dall'inizio.

100/sec

Chiamate al secondo alla Send API per account, per testo, link, reazioni e sticker.

Quando si attiva message_reactions?

Quando una persona reagisce a un messaggio nella sua conversazione con l'account professionale, e di nuovo quando rimuove quella reazione, una volta che l'app e l'account sono iscritti al campo. La guida Instagram Messaging di Meta è esplicita sull'altra direzione: quando è l'account stesso a reagire o a rimuovere una reazione, non viene inviata alcuna notifica, e messages non consegna nemmeno un eco per essa.

Come appare una notifica di reazione?

Una POST con object impostato su instagram, la cui entry contiene un array messaging. Diversamente da un DM, l'evento non ha un oggetto message: la reazione sta nel proprio oggetto reaction, accanto a sender, recipient e timestamp. Ecco l'esempio di Meta per Instagram Login:

A message_reactions notification, as Meta sends it
{
  "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}"
          }
        }
      ]
    }
  ]
}

Cosa significa ogni campo?

I campi che Meta documenta per un evento di reazione, dall'esterno verso l'interno:

  • entry[].id e recipient.id: l'account professionale. sender.id: l'ID con ambito Instagram della persona che ha reagito.
  • timestamp: il momento in cui è stato generato l'evento, in millisecondi negli esempi di Meta; entry[].time è il momento in cui Meta ha inviato la notifica.
  • reaction.mid: l'ID del messaggio con reazione, lo stesso mid che quel messaggio aveva nel suo evento messages.
  • reaction.action: react quando una reazione viene aggiunta, unreact quando viene rimossa.
  • reaction.reaction: il nome della reazione, come love; Meta elenca angry, sad, wow, love, like, laugh e other.
  • reaction.emoji: l'emoji come stringa Unicode, come \u{2764}\u{FE0F} per love.
  • Nel caso di unreact, reaction ed emoji vengono omessi.

Come appare un unreact?

Lo stesso evento con action impostato su unreact e senza reaction né emoji, dato che non resta nulla da nominare. Abbinalo alla reazione che rimuove tramite reaction.mid e sender.id, ed elimina la reazione di quella persona dal messaggio nei tuoi registri.

The reaction object of an unreact
"reaction": {
  "mid": "<MESSAGE_ID>",
  "action": "unreact"
}

A quale messaggio punta mid?

Al messaggio che la persona ha reagito, con lo stesso mid che aveva nel suo evento messages, eco dei messaggi dell'account compresi. Un handler che memorizza i mid può collegare la reazione alla riga giusta della conversazione. Meta segnala una lacuna: una reazione a una immagine di un post carosello riporta la prima immagine del carosello, che potrebbe non essere quella scelta.

Come reagisce un account a un messaggio?

Con POST /<IG_ID>/messages: recipient.id impostato sull'ID con ambito Instagram della persona, sender_action impostato su react e un payload che contiene message_id e reaction, un'emoji o la sua forma UTF-8. Ripetere la chiamata con un'altra emoji cambia la reazione, e sender_action impostato su unreact con solo message_id la rimuove. Nessuna delle due chiamate genera un webhook.

Reacting to a person's message
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>"
  }
}

Di cosa ha bisogno message_reactions?

Con Instagram Login, instagram_business_basic e instagram_business_manage_messages, e Advanced Access per gli account che lo sviluppatore non possiede né gestisce. Un nuovo prodotto Instagram nella App Dashboard risulta sottoscritto a message_reactions, e ogni account si sottoscrive tramite POST /<IG_ID>/subscribed_apps. La guida Send Messages di Meta lo elenca come messaging_reactions, ma la sua tabella dei campi, i valori predefiniti della dashboard e il riferimento dei webhook dicono message_reactions.

easyCoexistence inoltra le reazioni?

No. L'app di easyCoexistence e ogni account connesso sono sottoscritti solo a comments, messages e mentions, quindi gli eventi message_reactions non vengono inoltrati al tuo endpoint. I DM e gli eco a cui le reazioni puntano tramite il loro mid arrivano comunque, firmati con il segreto dell'account.

Errori comuni

  • Cercare la reazione dentro message. Un evento di reazione non ha un oggetto message: leggi l'oggetto reaction accanto a sender e recipient.
  • Leggere reaction o emoji senza controllare action. Entrambi vengono omessi nel caso di unreact, quindi il codice che li presuppone si rompe quando una reazione viene rimossa.
  • Aspettare un webhook dopo che l'account ha reagito. Meta non ne invia per le reazioni dell'account stesso, nemmeno un eco, quindi registrale quando è la tua app a inviarle.
  • Copiare il nome messaging_reactions dalla guida Send Messages di Meta. Il campo nella sua tabella dei campi, nei valori predefiniti della dashboard e nel riferimento dei webhook è message_reactions.
Farlo con EasyCoexistence

Il tuo agente risponde a una persona con send_social_dm entro la finestra di 24 ore. Da US$ 9 a US$ 0.75 per connessione al mese, che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Perché una reazione su un post carosello punta alla prima immagine?

Meta riporta la prima immagine del carosello quando qualcuno reagisce a una delle sue immagini, che potrebbe non essere quella scelta dalla persona.

Instagram invia un webhook quando l'account reagisce a un messaggio?

No. Meta non invia alcuna notifica message_reactions né eco quando l'account reagisce a un messaggio o rimuove la reazione.

Quali reazioni può riportare il webhook di Instagram?

La guida Instagram Messaging di Meta elenca angry, sad, wow, love, like, laugh e other dalla Graph API v12.0, con l'emoji stessa in reaction.emoji.

Il campo webhook è message_reactions o messaging_reactions?

message_reactions. La guida Send Messages di Meta scrive messaging_reactions, ma la sua tabella dei campi, i valori predefiniti della App Dashboard e il riferimento dei webhook usano tutti message_reactions.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il