Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagram message_reactions -webhook: react- ja unreact-payload

Instagramin message_reactions-webhook-kenttä ilmoittaa sovellukselle, kun henkilö reagoi viestiin keskustelussaan ammatillisen tilin kanssa tai poistaa reaktionsa. Tapahtuma on messaging-taulukossa reaction-objektissa: mid on reagoidun viestin ID; action on react tai unreact; ja pelkässä react-tapauksessa reaction, kuten love, sekä emoji eli itse emoji-merkki.

easyCoexistence tilaa jokaisen yhdistetyn Instagram-tilin kommentteihin, viesteihin ja maininnoihin ja välittää nämä tapahtumat HTTPS-endpointiisi niiden saapuessa, allekirjoitettuna kyseisen tilin salaisuudella, jokainen viesti mid-tunnuksellaan.

react / unreact

reaction.action-kentän kaksi arvoa: reaktio lisätty tai reaktio poistettu.

v12.0

Graph API -versio, josta alkaen Meta tukee tässä webhookissa reaktioita angry, sad, wow, love, like, laugh ja muita.

No echo

Meta ei lähetä ilmoitusta, kun tili itse reagoi henkilön viestiin tai poistaa reaktionsa.

Default

message_reactions kuuluu kenttiin, joihin uusi Instagram-tuote sovelluksen App Dashboardissa on oletuksena tilattu.

100/sec

Send API -kutsua sekunnissa tiliä kohden tekstille, linkeille, reaktioille ja tarroille.

Milloin message_reactions laukeaa?

Kun henkilö reagoi viestiin keskustelussaan ammatillisen tilin kanssa, ja uudelleen, kun hän poistaa reaktion, kunhan sovellus ja tili on tilattu kenttään. Metan Instagram Messaging -ohje on selvä toisesta suunnasta: kun tili itse reagoi tai poistaa reaktion, ilmoitusta ei lähetetä, eikä messages-kenttä tuo siitä kaikua.

Miltä reaktio-ilmoitus näyttää?

POST-pyyntö, jonka object-kentän arvo on instagram ja jonka entry sisältää messaging-taulukon. Toisin kuin DM-viestissä, tapahtumassa ei ole message-objektia: reaktio on omassa reaction-objektissaan sender-, recipient- ja timestamp-kenttien rinnalla. Metan esimerkki Instagram Login -kirjautumiselle:

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

Mitä kukin kenttä tarkoittaa?

Kentät, jotka Meta dokumentoi reaktiotapahtumalle, ulkopuolelta sisäänpäin:

  • entry[].id ja recipient.id: ammatillinen tili. sender.id: reagoineen henkilön Instagram-kohtainen ID.
  • timestamp: milloin tapahtuma laukesi, Metan näytteissä millisekunteina; entry[].time on hetki, jolloin Meta lähetti ilmoituksen.
  • reaction.mid: reagoidun viestin ID, sama mid kuin viestillä oli sen messages-tapahtumassa.
  • reaction.action: react, kun reaktio lisätään, unreact, kun se poistetaan.
  • reaction.reaction: reaktion nimi, kuten love; Meta luettelee angry, sad, wow, love, like, laugh ja muut.
  • reaction.emoji: emoji Unicode-merkkijonona, kuten \u{2764}\u{FE0F} love-reaktiolle.
  • Unreact-tapauksessa reaction ja emoji jätetään pois.

Miltä unreact näyttää?

Sama tapahtuma, jossa action on unreact ja jossa ei ole kenttiä reaction eikä emoji, koska nimettävää ei ole. Yhdistä se poistettavaan reaktioon reaction.midin ja sender.id:n perusteella ja poista kyseisen henkilön reaktio viestistä omista tallennetuista tiedoistasi.

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

Mihin viestiin mid viittaa?

Viestiin, jonka henkilö reagoi, samalla mid-tunnuksella, jonka se sai messages-tapahtumassaan, tilin omat kaiut mukaan lukien. Käsittelijä, joka tallentaa mid-tunnuksia, voi liittää reaktion keskustelun oikealle riville. Meta mainitsee yhden rajoituksen: reaktio yhteen karuselli-julkaisun kuvaan ilmoittaa karusellin ensimmäisen kuvan, joka ei välttämättä ole se, jonka henkilö valitsi.

Miten tili reagoi viestiin?

POST /<IG_ID>/messages -pyynnöllä: recipient.id on henkilön Instagram-kohtainen ID, sender_action on react ja payload sisältää message_id:n sekä reaction-arvon, emojin tai sen UTF-8-muodon. Kutsun toistaminen toisella emojilla vaihtaa reaktion, ja sender_action unreact pelkällä message_id:llä poistaa sen. Kumpikaan kutsu ei tuota webhookia.

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

Mitä message_reactions vaatii?

Instagram Login -kirjautumisessa oikeudet instagram_business_basic ja instagram_business_manage_messages sekä Advanced Access -käyttöoikeus tileille, joita kehittäjä ei omista eikä hallinnoi. Uusi Instagram-tuote sovelluksen App Dashboardissa tilataan oletuksena message_reactions-kenttään, ja jokainen tili tilataan POST /<IG_ID>/subscribed_apps -kutsulla. Metan Send Messages -ohje listaa kentän nimellä messaging_reactions, mutta sen kenttätaulukko, App Dashboardin oletukset ja webhook-viite sanovat message_reactions.

Välittääkö easyCoexistence reaktiot?

Ei. easyCoexistencen sovellus ja jokainen yhdistetty tili on tilattu vain kommentteihin, viesteihin ja maininnoihin, joten message_reactions-tapahtumia ei välitetä päätepisteeseesi. Reaktioiden mid-tunnuksella osoittamat DM-viestit ja kaiut kuitenkin saapuvat sinne, allekirjoitettuina tilin salaisuudella.

Yleiset virheet

  • Reaktion etsiminen message-objektin sisältä. Reaktiotapahtumalla ei ole message-objektia; lue reaction-objekti sender- ja recipient-kenttien rinnalta.
  • Reaction- tai emoji-kentän lukeminen tarkistamatta action-arvoa. Molemmat jätetään pois unreact-tapauksessa, joten koodi, joka olettaa niiden olevan olemassa, hajoaa, kun reaktio poistetaan.
  • Webhookia odottaminen sen jälkeen, kun tili reagoi. Meta ei lähetä sitä tilin omista reaktioista, ei edes kaikua, joten tallenna ne, kun sovelluksesi lähettää ne.
  • Nimen messaging_reactions kopioiminen Metan Send Messages -ohjeesta. Kenttä kenttätaulukossa, App Dashboardin oletuksissa ja webhook-viitteessä on message_reactions.
Näin teet tämän EasyCoexistencen avulla

Agenttisi vastaa henkilölle send_social_dm-työkalulla 24 tunnin ikkunassa. US$ 9 alkaen ja laskee US$ 0,75:een yhteyttä kohden kuukaudessa, kun yhteyksiä lisätään, kolmen ensimmäisen päivän ilmainen kokeilu.

Usein kysytyt kysymykset

Miksi reaktio karuselli-julkaisussa osoittaa ensimmäiseen kuvaan?

Meta raportoi karusellin ensimmäisen kuvan, kun joku reagoi yhteen sen kuvista, ja se ei välttämättä ole kuva, jonka henkilö valitsi.

Lähettääkö Instagram webhookin, kun yritys reagoi viestiin?

Ei. Meta ei lähetä message_reactions-ilmoitusta eikä kaikua, kun tili reagoi viestiin tai poistaa reaktion.

Mitä reaktioita Instagram-webhook voi ilmoittaa?

Metan Instagram Messaging -ohje listaa angry, sad, wow, love, like, laugh ja muut Graph API v12.0:sta alkaen, ja itse emoji on reaction.emoji-kentässä.

Onko webhook-kenttä message_reactions vai messaging_reactions?

message_reactions. Metan Send Messages -ohje kirjoittaa messaging_reactions, mutta sen kenttätaulukko, App Dashboardin oletukset ja webhook-viite käyttävät kaikki message_reactions-nimeä.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu