Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Webhook message_reactions w Instagramie: payload reakcji i cofnięcia

Pole message_reactions webhooka Instagrama powiadamia aplikację, gdy osoba reaguje na wiadomość w swojej rozmowie z kontem profesjonalnym lub usuwa reakcję. Zdarzenie znajduje się w tablicy messaging z obiektem reaction: mid, czyli ID wiadomości, na którą zareagowano; action, czyli react lub unreact; oraz, tylko przy react, reaction, na przykład love, i emoji, czyli samo emoji.

easyCoexistence subskrybuje każde podłączone konto Instagram do comments, messages i mentions i przekazuje te zdarzenia na Twój endpoint HTTPS w miarę ich nadejścia, podpisane sekretem tego konta, z każdą wiadomością wraz z jej mid.

react / unreact

Dwie wartości reaction.action: dodanie reakcji albo usunięcie reakcji.

v12.0

Wersja Graph API, od której Meta obsługuje w tym webhooku reakcje angry, sad, wow, love, like, laugh i other.

No echo

Meta nie wysyła powiadomienia, gdy samo konto reaguje na wiadomość osoby lub ją cofa.

Default

message_reactions należy do pól, z którymi nowy produkt Instagram w App Dashboard startuje zasubskrybowany.

100/sec

Limit wywołań Send API na sekundę na konto, dla tekstu, linków, reakcji i naklejek.

Kiedy uruchamia się message_reactions?

Gdy osoba reaguje na wiadomość w swojej rozmowie z kontem profesjonalnym, a potem, gdy usuwa tę reakcję, pod warunkiem że aplikacja i konto są zasubskrybowane do tego pola. Przewodnik Meta po Instagram Messaging jasno mówi o drugim kierunku: gdy samo konto reaguje lub cofa reakcję, powiadomienie nie jest wysyłane, a messages też nie dostarcza dla niej echa.

Jak wygląda powiadomienie o reakcji?

POST z object ustawionym na instagram, którego entry zawiera tablicę messaging. W przeciwieństwie do DM zdarzenie nie ma obiektu message: reakcja znajduje się we własnym obiekcie reaction, obok sender, recipient i timestamp. Przykład Meta dla 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}"
          }
        }
      ]
    }
  ]
}

Co oznacza każde pole?

Pola, które Meta dokumentuje dla zdarzenia reakcji, od zewnątrz do środka:

  • entry[].id oraz recipient.id: konto profesjonalne. sender.id: Instagram-scoped ID osoby, która zareagowała.
  • timestamp: moment wyzwolenia zdarzenia, w milisekundach w przykładach Meta; entry[].time to chwila, w której Meta wysłała powiadomienie.
  • reaction.mid: ID wiadomości, na którą zareagowano, ten sam mid, który ta wiadomość miała w zdarzeniu messages.
  • reaction.action: react, gdy reakcja jest dodawana, unreact, gdy jest usuwana.
  • reaction.reaction: nazwa reakcji, na przykład love; Meta wymienia angry, sad, wow, love, like, laugh i other.
  • reaction.emoji: emoji jako ciąg Unicode, na przykład \u{2764}\u{FE0F} dla love.
  • Przy unreact pola reaction i emoji są pomijane.

Jak wygląda unreact?

To samo zdarzenie z action ustawionym na unreact i bez reaction oraz emoji, bo nie ma już czego nazwać. Dopasuj je do usuwanej reakcji przez reaction.mid i sender.id, a potem usuń reakcję tej osoby na wiadomości z własnych zapisów.

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

Na którą wiadomość wskazuje mid?

Na wiadomość, na którą osoba zareagowała, pod tym samym mid, który miała w zdarzeniu messages, łącznie z echami własnych wiadomości konta. Handler zapisujący mid może przypiąć reakcję do właściwej linii rozmowy. Meta zaznacza jedną lukę: reakcja na jedno zdjęcie posta karuzeli zgłasza pierwsze zdjęcie karuzeli, które może nie być tym wybranym.

Jak konto reaguje na wiadomość?

Wywołaniem POST /<IG_ID>/messages: recipient.id ustawione na Instagram-scoped ID osoby, sender_action ustawione na react, a w payload message_id i reaction, czyli emoji lub jego forma UTF-8. Ponowne wywołanie z innym emoji zmienia reakcję, a sender_action ustawione na unreact z samym message_id ją usuwa. Żadne z tych wywołań nie generuje webhooka.

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>"
  }
}

Czego potrzebuje message_reactions?

W Instagram Login: instagram_business_basic i instagram_business_manage_messages, a dla kont, których deweloper nie posiada ani nie zarządza, Advanced Access. Nowy produkt Instagram w App Dashboard startuje zasubskrybowany do message_reactions, a każde konto subskrybuje się przez POST /<IG_ID>/subscribed_apps. Przewodnik Meta Send Messages wymienia to pole jako messaging_reactions, ale jego tabela pól, domyślne ustawienia dashboardu i referencja webhooków mówią message_reactions.

Czy easyCoexistence przekazuje reakcje?

Nie. Aplikacja easyCoexistence i każde połączone konto są subskrybowane tylko do comments, messages i mentions, więc zdarzenia message_reactions nie są przekazywane do Twojego endpointu. DM-y i echa, do których reakcje odwołują się przez mid, do niego docierają, podpisane sekretem konta.

Typowe błędy

  • Szukanie reakcji wewnątrz message. Zdarzenie reakcji nie ma obiektu message; czytaj obiekt reaction obok sender i recipient.
  • Odczyt reaction lub emoji bez sprawdzenia action. Oba są pomijane przy unreact, więc kod zakładający ich obecność przestaje działać, gdy reakcja zostaje usunięta.
  • Oczekiwanie na webhook po reakcji konta. Meta nie wysyła żadnego dla reakcji konta, nawet echa, więc zapisuj je, gdy wysyła je Twoja aplikacja.
  • Kopiowanie nazwy messaging_reactions z przewodnika Meta Send Messages. Pole w jego tabeli pól, domyślnych ustawieniach dashboardu i referencji webhooków to message_reactions.
Z EasyCoexistence zrobisz to

Twój agent odpowiada osobie przez send_social_dm w 24-godzinnym oknie. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Dlaczego reakcja na post karuzeli wskazuje pierwsze zdjęcie?

Meta zgłasza pierwsze zdjęcie karuzeli, gdy ktoś zareaguje na jedno z jej zdjęć, a może to nie być zdjęcie wybrane przez osobę.

Czy Instagram wysyła webhook, gdy firma reaguje na wiadomość?

Nie. Meta nie wysyła powiadomienia message_reactions ani echa, gdy konto reaguje na wiadomość lub ją cofa.

Jakie reakcje może zgłaszać webhook Instagrama?

Przewodnik Meta po Instagram Messaging wymienia od Graph API v12.0 reakcje angry, sad, wow, love, like, laugh i other, a samo emoji znajduje się w reaction.emoji.

Czy pole webhooka to message_reactions czy messaging_reactions?

message_reactions. Przewodnik Meta Send Messages pisze messaging_reactions, ale jego tabela pól, domyślne ustawienia App Dashboard i referencja webhooków używają message_reactions.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w