IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Webhook ya message_reactions ya Instagram: payload ya react na unreact

Kipengele cha message_reactions cha webhook ya Instagram humjulisha programu mtu anapoitikia ujumbe katika mazungumzo yake na akaunti ya kitaalamu, au anapoondoa mwitikio huo. Tukio linakaa katika safu ya messaging, likiwa na kitu cha reaction: mid, kitambulisho cha ujumbe ulioitikiwa; action, react au unreact; na, kwa react pekee, reaction, kama love, na emoji, yaani emoji yenyewe.

easyCoexistence inajisajili kila akaunti ya Instagram iliyounganishwa kwa maoni, ujumbe na kutajwa, na kusambaza matukio hayo kwa endpoint yako ya HTTPS yanapofika, yakitiwa sahihi kwa siri ya akaunti hiyo, kila ujumbe ukiwa na mid yake.

react / unreact

Thamani mbili za reaction.action: mwitikio umeongezwa, au mwitikio umeondolewa.

v12.0

Toleo la Graph API ambalo kuanzia hapo Meta inaunga mkono angry, sad, wow, love, like, laugh na mwitikio mwingine katika webhook hii.

No echo

Meta haituma arifa akaunti yenyewe inapoitikia au kuondoa mwitikio wa ujumbe wa mtu.

Default

message_reactions ni miongoni mwa sehemu ambazo bidhaa mpya ya Instagram kwenye App Dashboard inaanza ikiwa imejisajili nazo.

100/sec

Miito ya Send API kwa sekunde kwa kila akaunti kwa maandishi, viungo, mwitikio na stika.

Je, message_reactions huanzishwa lini?

Mtu anapoitikia ujumbe katika mazungumzo yake na akaunti ya kitaalamu, na tena anapoondoa mwitikio huo, mara tu programu na akaunti zimejisajili kwenye kipengele hicho. Mwongozo wa Meta wa Instagram Messaging uko wazi kuhusu upande mwingine: akaunti yenyewe inapoitikia au kuondoa mwitikio, hakuna arifa inayotumwa, na messages haitoi mwangwi kwa hilo pia.

Arifa ya mwitikio inaonekanaje?

POST yenye object iliyowekwa kuwa instagram, ambayo entry yake inashikilia safu ya messaging. Tofauti na DM, tukio halibebi kitu cha ujumbe: mwitikio uko katika kitu chake cha reaction, pembeni ya sender, recipient na timestamp. Mfano wa Meta kwa 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}"
          }
        }
      ]
    }
  ]
}

Kila sehemu inamaanisha nini?

Sehemu ambazo Meta inaandika kwa tukio la mwitikio, kutoka nje kwenda ndani:

  • entry[].id na recipient.id: akaunti ya kitaalamu. sender.id: kitambulisho cha mtu aliyeitikia kilichowekwa kwa Instagram.
  • timestamp: wakati tukio lilipochochewa, kwa milisekunde katika sampuli za Meta; entry[].time ni wakati Meta ilipotuma arifa.
  • reaction.mid: kitambulisho cha ujumbe ulioitikiwa, mid ile ile iliyokuwa nayo katika tukio lake la messages.
  • reaction.action: react mwitikio unapoongezwa, unreact unapoondolewa.
  • reaction.reaction: jina la mwitikio, kama love; Meta inaorodhesha angry, sad, wow, love, like, laugh na other.
  • reaction.emoji: emoji kama mfuatano wa Unicode, kama \u{2764}\u{FE0F} kwa love.
  • Wakati wa unreact, reaction na emoji zinaachwa.

Unreact inaonekanaje?

Tukio lile lile lenye action iliyowekwa kuwa unreact, bila reaction wala emoji, kwa sababu hakuna kitu cha kutaja. Lilingane na mwitikio unaoondolewa kwa reaction.mid na sender.id, kisha ondoa mwitikio wa mtu huyo kutoka kwenye ujumbe katika kumbukumbu zako.

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

mid inaelekeza kwenye ujumbe gani?

Ujumbe ambao mtu aliitikia, chini ya mid ile ile uliyobeba katika tukio lake la messages, ikijumuisha mwangwi wa ujumbe wa akaunti yenyewe. Kishughulikiaji kinachohifadhi mids kinaweza kuambatanisha mwitikio na mstari sahihi wa mazungumzo. Meta inataja pengo moja: mwitikio kwa picha moja ya chapisho la carousel huripoti picha ya kwanza ya carousel, ambayo huenda isiwe ile iliyochaguliwa.

Akaunti inaitikia ujumbe vipi?

Kwa POST /<IG_ID>/messages: recipient.id iliyowekwa kuwa kitambulisho cha Instagram cha mtu, sender_action iliyowekwa kuwa react, na payload inayoshikilia message_id na reaction, yaani emoji au umbo lake la UTF-8. Kurudia wito kwa emoji nyingine kunabadilisha mwitikio, na sender_action iliyowekwa kuwa unreact pamoja na message_id pekee inauondoa. Wito wote mawili hauzalishi 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>"
  }
}

message_reactions inahitaji nini?

Kwa Instagram Login, instagram_business_basic na instagram_business_manage_messages, na Advanced Access kwa akaunti ambazo msanidi hamiliki wala hazisimamii. Bidhaa mpya ya Instagram kwenye App Dashboard inaanza ikiwa imejisajili kwenye message_reactions, na kila akaunti inajisajili kupitia POST /<IG_ID>/subscribed_apps. Mwongozo wa Meta wa Send Messages unaiorodhesha kama messaging_reactions, lakini jedwali lake la sehemu, chaguo-msingi za App Dashboard na rejeleo la webhook zinasema message_reactions.

easyCoexistence inasambaza mwitikio?

Hapana. Programu ya easyCoexistence na kila akaunti iliyounganishwa zimejisajili kwa maoni, ujumbe na kutajwa pekee, kwa hiyo matukio ya message_reactions hayasambazwi kwenye endpoint yako. DM na mwangwi ambao mids za mwitikio zinaelekeza zinafika kwenye endpoint yako, zikisainiwa kwa siri ya akaunti.

Makosa ya kawaida

  • Kutafuta mwitikio ndani ya kitu cha ujumbe. Tukio la mwitikio halina kitu cha ujumbe; soma kitu cha reaction pembeni ya sender na recipient.
  • Kusoma reaction au emoji bila kukagua action. Zote mbili zinaachwa wakati wa unreact, kwa hiyo msimbo unaodhani zipo huvunjika mwitikio unapoondolewa.
  • Kusubiri webhook baada ya akaunti kuitikia. Meta haituma yoyote kwa mwitikio wa akaunti yenyewe, hata mwangwi, kwa hiyo yahifadhi kwenye rekodi zako wakati programu yako inayatuma.
  • Kunakili jina messaging_reactions kutoka mwongozo wa Meta wa Send Messages. Sehemu katika jedwali lake la sehemu, chaguo-msingi za App Dashboard na rejeleo la webhook ni message_reactions.
Kufanya hili ukitumia EasyCoexistence

Wakala wako anamjibu mtu kwa send_social_dm ndani ya dirisha la huduma kwa wateja la saa 24. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Kwa nini mwitikio kwenye chapisho la carousel unaelekeza kwenye picha ya kwanza?

Meta huripoti picha ya kwanza ya carousel mtu anapoitikia mojawapo ya picha zake, ambayo huenda isiwe picha aliyoichagua mtu huyo.

Je, Instagram hutuma webhook biashara inapoitikia ujumbe?

Hapana. Meta haituma arifa ya message_reactions wala mwangwi akaunti inapoitikia au kuondoa mwitikio wa ujumbe.

Webhook ya Instagram inaweza kuripoti mwitikio gani?

Mwongozo wa Meta wa Instagram Messaging unaorodhesha angry, sad, wow, love, like, laugh na other kuanzia Graph API v12.0, na emoji yenyewe iko katika reaction.emoji.

Jina la webhook ni message_reactions au messaging_reactions?

message_reactions. Mwongozo wa Meta wa Send Messages unaandika messaging_reactions, lakini jedwali lake la sehemu, chaguo-msingi za App Dashboard na rejeleo la webhook zote zinatumia message_reactions.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye