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.
Dvije vrijednosti reaction.action: dodana reakcija ili uklonjena reakcija.
Verzija Graph API-ja od koje Meta u ovom webhooku podržava angry, sad, wow, love, like, laugh i ostale reakcije.
Meta ne šalje obavijest kad sam račun reagira na poruku osobe ili ukloni reakciju na nju.
message_reactions je među poljima na koja se novi Instagram proizvod u App Dashboardu automatski pretplaćuje.
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:
{
"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.
"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.
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.
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