Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Instagram webhook message_reactions: payload za reakciju i uklanjanje reakcije

Polje message_reactions webhooka obavještava aplikaciju kad osoba reagira na poruku u razgovoru s profesionalnim računom ili ukloni reakciju. Događaj se nalazi u nizu messaging s objektom reaction: mid, ID poruke na koju je reagirano; action, react ili unreact; i, samo kod reakcije react, reaction, poput love, te emoji, sam emoji.

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

react / unreact

Dvije vrijednosti reaction.action: dodana reakcija ili uklonjena reakcija.

v12.0

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

No echo

Meta ne šalje obavijest kad sam račun reagira na poruku osobe ili ukloni reakciju na nju.

Default

message_reactions je među poljima na koja se novi Instagram proizvod u App Dashboardu automatski pretplaćuje.

100/sec

Send API poziva u sekundi po računu za tekst, poveznice, reakcije i naljepnice.

Kada se aktivira message_reactions?

Kad osoba reagira na poruku u razgovoru s profesionalnim računom, i ponovno kad tu reakciju ukloni, nakon što su aplikacija i račun pretplaćeni na to polje. Meta je u vodiču Instagram Messaging jasna u suprotnom smjeru: kad sam račun reagira ili ukloni reakciju, ne šalje se obavijest, a messages za to također ne donosi echo.

Kako izgleda obavijest o reakciji?

POST s objektom object postavljenim na instagram, čiji entry sadrži niz messaging. Za razliku od DM-a, događaj ne nosi objekt message: reakcija je u vlastitom objektu reaction, uz sender, recipient i timestamp. Metin primjer 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}"
          }
        }
      ]
    }
  ]
}

Što znači svako polje?

Polja koja Meta dokumentira za događaj reakcije, od vanjskog prema unutarnjem:

  • entry[].id i recipient.id: profesionalni račun. sender.id: Instagram-ograničeni ID osobe koja je reagirala.
  • timestamp: kad je događaj nastao, u milisekundama u Metinim primjerima; entry[].time je kad je Meta poslala obavijest.
  • reaction.mid: ID poruke na koju se reagira, isti mid koji je ta poruka imala u svom događaju messages.
  • reaction.action: react kad se reakcija dodaje, unreact kad se uklanja.
  • reaction.reaction: naziv reakcije, poput love; Meta navodi angry, sad, wow, love, like, laugh i other.
  • reaction.emoji: emoji kao Unicode niz, poput \u{2764}\u{FE0F} za love.
  • Kod unreact, reaction i emoji se izostavljaju.

Kako izgleda uklanjanje reakcije?

Isti događaj s action postavljenim na unreact, bez reaction i emoji, jer nema što imenovati. Uparite ga s reakcijom koju uklanja pomoću reaction.mid i sender.id te u svojim zapisima uklonite tu reakciju te osobe s poruke.

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

Na koju poruku pokazuje mid?

Na poruku na koju je osoba reagirala, pod istim mid-om koji je imala u svom događaju messages, uključujući echo poruka samog računa. Rukovatelj koji pohranjuje vrijednosti mid može reakciju pridružiti pravom retku razgovora. Meta navodi jedan nedostatak: reakcija na jednu sliku karusel objave prijavljuje prvu sliku karusela, koja možda nije ona koju je osoba odabrala.

Kako račun reagira na poruku?

Pozivom POST /<IG_ID>/messages: recipient.id postavljen na Instagram-ograničeni ID osobe, sender_action postavljen na react i payload koji sadrži message_id i reaction, emoji ili njegov UTF-8 oblik. Ponovljeni poziv s drugim emojijem mijenja reakciju, a sender_action postavljen na unreact samo s 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>"
  }
}

Što je potrebno za message_reactions?

Uz Instagram Login: instagram_business_basic i instagram_business_manage_messages, te Advanced Access za račune koje razvojni programer ne posjeduje niti njima upravlja. Novi Instagram proizvod u App Dashboardu automatski je pretplaćen na message_reactions, a svaki se račun pretplaćuje putem POST /<IG_ID>/subscribed_apps. Metin vodič Send Messages navodi ga kao messaging_reactions, ali njegova tablica polja, zadane postavke u App Dashboardu i referenca webhooka kažu message_reactions.

Prosljeđuje li easyCoexistence reakcije?

Ne. Aplikacija easyCoexistence i svaki povezani račun pretplaćeni su samo na comments, messages i mentions, pa se događaji message_reactions ne prosljeđuju vašem endpointu. DM-ovi i eho-poruke na koje reakcije pokazuju putem mid stižu do njega, potpisani tajnim ključem tog računa.

Uobičajene pogreške

  • Traženje reakcije unutar message. Događaj reakcije nema objekt message; čitajte objekt reaction pored sender i recipient.
  • Čitanje reaction ili emoji bez provjere action. Oba se izostavljaju kod unreact, pa kod koji to pretpostavlja puca kad se reakcija ukloni.
  • Čekanje webhooka nakon što račun reagira. Meta ne šalje nijedan za reakcije samog računa, čak ni echo, pa ih zapišite kad ih vaša aplikacija šalje.
  • Kopiranje naziva messaging_reactions iz Metinog vodiča Send Messages. Polje u njegovoj tablici polja, zadanim postavkama App Dashboarda i referenci webhooka jest message_reactions.
Radite ovo uz EasyCoexistence

Vaš agent odgovara osobi pomoću send_social_dm unutar 24-satnog prozora. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, s prvih 3 dana besplatno.

Često postavljana pitanja

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

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

Šalje li Instagram webhook kad poslovni račun reagira na poruku?

Ne. Meta ne šalje obavijest message_reactions ni echo kad račun reagira na poruku ili je ukloni.

Koje reakcije webhook Instagrama može prijaviti?

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

Je li polje webhooka message_reactions ili messaging_reactions?

message_reactions. Metin vodič Send Messages piše messaging_reactions, ali njegova tablica polja, zadane postavke App Dashboarda i referenca webhooka svi koriste message_reactions.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na