Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Webhook-ul message_reactions de la Instagram: payload-ul pentru reacție și anulare

Câmpul de webhook message_reactions al Instagram notifică o aplicație când o persoană reacționează la un mesaj din conversația sa cu un cont profesional sau își elimină reacția. Evenimentul apare în array-ul messaging, cu un obiect reaction: mid, ID-ul mesajului la care s-a reacționat; action, react sau unreact; iar, doar la react, reaction, precum love, și emoji, emoji-ul propriu-zis.

easyCoexistence abonează fiecare cont Instagram conectat la comments, messages și mentions și transmite aceste evenimente către endpoint-ul dumneavoastră HTTPS pe măsură ce sosesc, semnate cu secretul contului respectiv, fiecare mesaj cu mid-ul său.

react / unreact

Cele două valori ale reaction.action: o reacție adăugată sau o reacție eliminată.

v12.0

Versiunea Graph API de la care Meta acceptă angry, sad, wow, love, like, laugh și alte reacții în acest webhook.

No echo

Meta nu trimite nicio notificare când contul însuși reacționează sau își elimină reacția la mesajul unei persoane.

Default

message_reactions face parte dintre câmpurile la care un nou produs Instagram din App Dashboard este abonat implicit.

100/sec

Apeluri Send API pe secundă, per cont, pentru text, linkuri, reacții și stickere.

Când se declanșează message_reactions?

Când o persoană reacționează la un mesaj din conversația sa cu contul profesional și din nou când își elimină acea reacție, odată ce aplicația și contul sunt abonate la câmp. Ghidul Instagram Messaging de la Meta este explicit în privința celeilalte direcții: când contul însuși reacționează sau elimină o reacție, nu se trimite nicio notificare, iar messages nu livrează niciun echo pentru ea.

Cum arată o notificare de reacție?

Un POST cu object setat la instagram, al cărui entry conține un array messaging. Spre deosebire de un DM, evenimentul nu are obiect message: reacția se află în propriul obiect reaction, alături de sender, recipient și timestamp. Exemplul Meta pentru 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}"
          }
        }
      ]
    }
  ]
}

Ce înseamnă fiecare câmp?

Câmpurile pe care Meta le documentează pentru un eveniment de reacție, de la exterior spre interior:

  • entry[].id și recipient.id: contul profesional. sender.id: ID-ul cu scop Instagram al persoanei care a reacționat.
  • timestamp: momentul în care a fost declanșat evenimentul, în milisecunde în exemplele Meta; entry[].time este momentul în care Meta a trimis notificarea.
  • reaction.mid: ID-ul mesajului la care s-a reacționat, același mid pe care îl avea mesajul în evenimentul său messages.
  • reaction.action: react când se adaugă o reacție, unreact când este eliminată.
  • reaction.reaction: numele reacției, precum love; Meta listează angry, sad, wow, love, like, laugh și other.
  • reaction.emoji: emoji-ul ca șir Unicode, precum \u{2764}\u{FE0F} pentru love.
  • La unreact, reaction și emoji sunt omise.

Cum arată un unreact?

Același eveniment, cu action setat la unreact și fără reaction sau emoji, deoarece nu mai rămâne nimic de numit. Asociați-l cu reacția pe care o elimină prin reaction.mid și sender.id și scoateți reacția acelei persoane din mesaj în evidențele dumneavoastră.

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

La ce mesaj indică mid?

Mesajul la care a reacționat persoana, sub același mid pe care îl avea în evenimentul său messages, inclusiv ecourile mesajelor contului. Un handler care stochează mid-urile poate atașa reacția la rândul corect din conversație. Meta notează o limitare: o reacție la o imagine dintr-o postare carusel raportează prima imagine a carusel-ului, care poate să nu fie cea aleasă.

Cum reacționează un cont la un mesaj?

Prin POST /<IG_ID>/messages: recipient.id setat la ID-ul cu scop Instagram al persoanei, sender_action setat la react, iar un payload care conține message_id și reaction, un emoji sau forma sa UTF-8. Repetarea apelului cu alt emoji schimbă reacția, iar sender_action setat la unreact, doar cu message_id, o elimină. Niciunul dintre apeluri nu produce 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>"
  }
}

Ce are nevoie message_reactions?

Cu Instagram Login, instagram_business_basic și instagram_business_manage_messages, și Advanced Access pentru conturile pe care dezvoltatorul nu le deține sau nu le administrează. Un nou produs Instagram din App Dashboard este abonat implicit la message_reactions, iar fiecare cont se abonează prin POST /<IG_ID>/subscribed_apps. Ghidul Send Messages de la Meta îl listează ca messaging_reactions, dar tabelul său de câmpuri, valorile implicite din dashboard și referința webhook spun message_reactions.

easyCoexistence transmite reacțiile?

Nu. Aplicația easyCoexistence și fiecare cont conectat sunt abonate doar la comments, messages și mentions, nu la message_reactions, deci evenimentele message_reactions nu sunt transmise mai departe către endpoint-ul dumneavoastră. DM-urile și ecourile la care indică reacțiile prin mid ajung totuși la el, semnate cu secretul contului.

Greșeli frecvente

  • Căutarea reacției în interiorul message. Un eveniment de reacție nu are obiect message; citiți obiectul reaction alături de sender și recipient.
  • Citirea lui reaction sau emoji fără verificarea lui action. Ambele sunt omise la unreact, deci codul care le presupune prezente se rupe când o reacție este eliminată.
  • Așteptarea unui webhook după ce contul reacționează. Meta nu trimite niciunul pentru reacțiile contului, nici măcar un echo, așa că înregistrați-le atunci când aplicația dumneavoastră le trimite.
  • Copierea numelui messaging_reactions din ghidul Send Messages al Meta. Câmpul din tabelul său de câmpuri, din valorile implicite din dashboard și din referința webhook este message_reactions.
Faceți acest lucru cu EasyCoexistence

Agentul dumneavoastră răspunde unei persoane cu send_social_dm în fereastra de 24 de ore. De la US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

De ce indică o reacție la o postare carusel prima imagine?

Meta raportează prima imagine a carusel-ului atunci când cineva reacționează la una dintre imaginile sale, care poate să nu fie imaginea aleasă de persoană.

Trimite Instagram un webhook când afacerea reacționează la un mesaj?

Nu. Meta nu trimite nicio notificare message_reactions și niciun echo când contul reacționează la un mesaj sau își elimină reacția.

Ce reacții poate raporta webhook-ul Instagram?

Ghidul Instagram Messaging de la Meta listează angry, sad, wow, love, like, laugh și other de la Graph API v12.0, cu emoji-ul propriu-zis în reaction.emoji.

Este numele câmpului webhook message_reactions sau messaging_reactions?

message_reactions. Ghidul Send Messages de la Meta scrie messaging_reactions, dar tabelul de câmpuri, valorile implicite din App Dashboard și referința webhook folosesc toate message_reactions.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la