Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Instagram message_reactions webhook: payload za reakciju i uklanjanje reakcije

Polje message_reactions webhooka Instagrama obaveštava aplikaciju kad osoba reaguje na poruku u razgovoru sa profesionalnim nalogom ili ukloni reakciju. Događaj se nalazi u nizu messaging, sa objektom reaction: mid, ID poruke na koju je reagovano; action, react ili unreact; i samo za react, reaction, na primer love, i emoji, sam emoji.

easyCoexistence pretplaćuje svaki povezani Instagram nalog na comments, messages i mentions i prosleđuje te događaje vašem HTTPS endpointu čim stignu, potpisane tajnom tog naloga, a svaka poruka sa svojim mid-om.

react / unreact

Dve vrednosti za reaction.action: dodata reakcija ili uklonjena reakcija.

v12.0

Verzija Graph API-ja od koje Meta podržava angry, sad, wow, love, like, laugh i druge reakcije u ovom webhooku.

No echo

Meta ne šalje obaveštenje kad sam nalog reaguje na poruku osobe ili ukloni reakciju.

Default

message_reactions je među poljima na koja se novi Instagram proizvod u App Dashboard-u pretplaćuje od početka.

100/sec

Pozivi Send API-ja po sekundi po nalogu za tekst, linkove, reakcije i nalepnice.

Kada se okida message_reactions?

Kada osoba reaguje na poruku u svom razgovoru sa profesionalnim nalogom, i ponovo kad ukloni tu reakciju, pod uslovom da su aplikacija i nalog pretplaćeni na polje. Metin vodič za Instagram Messaging jasan je o suprotnom smeru: kad sam nalog reaguje ili ukloni reakciju, obaveštenje se ne šalje, a messages ni za to ne isporučuje eho.

Kako izgleda obaveštenje o reakciji?

POST zahtev sa objektom instagram, čiji entry sadrži niz messaging. Za razliku od DM-a, događaj ne nosi objekat message: reakcija je u sopstvenom objektu reaction, pored sender, recipient i timestamp. Metin primer za 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}"
          }
        }
      ]
    }
  ]
}

Šta znači svako polje?

Polja koja Meta dokumentuje za događaj reakcije, od spolja ka unutra:

  • entry[].id i recipient.id: profesionalni nalog. sender.id: Instagram ID osobe koja je reagovala.
  • timestamp: kada je događaj okinut, u milisekundama u Metinim primerima; entry[].time je kada je Meta poslala obaveštenje.
  • reaction.mid: ID poruke na koju je reagovano, isti mid koji je ta poruka imala u svom događaju messages.
  • reaction.action: react kad se reakcija doda, unreact kad se ukloni.
  • reaction.reaction: naziv reakcije, na primer love; Meta navodi angry, sad, wow, love, like, laugh i other.
  • reaction.emoji: emoji kao Unicode niz, na primer \u{2764}\u{FE0F} za love.
  • Kod unreact, reaction i emoji se izostavljaju.

Kako izgleda unreact?

Isti događaj sa action postavljenim na unreact, bez reaction i emoji, jer nema šta da se imenuje. Uparite ga sa reakcijom koju uklanja preko reaction.mid i sender.id, i obrišite tu reakciju te osobe sa poruke u svojim zapisima.

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

Na koju poruku pokazuje mid?

Na poruku na koju je osoba reagovala, pod istim mid-om koji je imala u svom događaju messages, uključujući ehoe sopstvenih poruka naloga. Obrađivač koji čuva mid-ove može reakciju da zakači za pravi red razgovora. Meta navodi jedan izuzetak: reakcija na jednu sliku iz karusel objave prijavljuje prvu sliku karusela, koja možda nije ona koju je osoba izabrala.

Kako nalog reaguje na poruku?

Pozivom POST /<IG_ID>/messages: recipient.id postavljen na Instagram ID osobe, sender_action postavljen na react, i payload sa message_id i reaction, emoji ili njegovim UTF-8 oblikom. Ponavljanje poziva sa drugim emoji-jem menja reakciju, a sender_action postavljen na unreact sa samo message_id uklanja je. Nijedan poziv ne proizvodi 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>"
  }
}

Šta message_reactions zahteva?

Uz Instagram Login, instagram_business_basic i instagram_business_manage_messages, i Advanced Access za naloge koje programer ne poseduje ili ne upravlja njima. Novi Instagram proizvod u App Dashboard-u počinje pretplaćen na message_reactions, a svaki nalog se pretplaćuje preko POST /<IG_ID>/subscribed_apps. Metin vodič Send Messages navodi polje kao messaging_reactions, ali njegova tabela polja, podrazumevana podešavanja App Dashboard-a i referenca webhooka kažu message_reactions.

Da li easyCoexistence prosleđuje reakcije?

Ne. easyCoexistence-ova aplikacija i svaki povezani nalog pretplaćeni su samo na comments, messages i mentions, pa se message_reactions događaji ne prosleđuju vašem endpointu. DM-ovi i ehoi na koje reakcije pokazuju svojim mid-om ipak stižu do njega, potpisani tajnim ključem naloga.

Česte greške

  • Traženje reakcije unutar message. Događaj reakcije nema objekat message; čitajte objekat reaction pored sender i recipient.
  • Čitanje reaction ili emoji bez provere action. Oba se izostavljaju kod unreact, pa kod koji to pretpostavlja puca kad se reakcija ukloni.
  • Čekanje webhooka kad nalog reaguje. Meta ne šalje nijedan za sopstvene reakcije naloga, čak ni eho, pa ih zapišite kad ih vaša aplikacija šalje.
  • Kopiranje naziva messaging_reactions iz Metinog vodiča Send Messages. Polje u njegovoj tabeli polja, podrazumevanim podešavanjima App Dashboard-a i referenci webhooka je message_reactions.
Ovo radite uz EasyCoexistence

Vaš agent odgovara osobi pomoću send_social_dm u okviru 24-časovnog prozora. Od US$ 9 do US$ 0,75 po vezi mesečno, sa padom kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Zašto reakcija na karusel objavu pokazuje na prvu sliku?

Meta prijavljuje prvu sliku karusela kad neko reaguje na jednu od njegovih slika, a to možda nije slika koju je osoba izabrala.

Da li Instagram šalje webhook kad profesionalni nalog reaguje na poruku?

Ne. Meta ne šalje obaveštenje message_reactions ni eho kad nalog reaguje na poruku ili je ukloni.

Koje reakcije webhook za Instagram može da prijavi?

Metin vodič za Instagram Messaging navodi angry, sad, wow, love, like, laugh i other od Graph API v12.0, a sam emoji je u reaction.emoji.

Da li se webhook polje zove message_reactions ili messaging_reactions?

message_reactions. Metin vodič Send Messages piše messaging_reactions, ali njegova tabela polja, podrazumevana podešavanja App Dashboard-a i referenca webhooka svi koriste message_reactions.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na