Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Webhook message_reactions Instagram: payload react dan unreact

Medan message_reactions webhook Instagram memberitahu aplikasi apabila seseorang bereaksi kepada mesej dalam perbualannya dengan akaun profesional, atau membuang reaksinya. Peristiwa itu berada dalam tatasusunan messaging dengan objek reaction: mid, ID mesej yang diberi reaksi; action, react atau unreact; dan, hanya pada react, reaction, seperti love, dan emoji, iaitu emojinya sendiri.

easyCoexistence melanggan setiap akaun Instagram yang disambungkan kepada comments, messages dan mentions, dan memajukan peristiwa itu ke endpoint HTTPS anda sebaik sahaja tiba, ditandatangani dengan rahsia akaun itu, dengan setiap mesej membawa mid-nya.

react / unreact

Dua nilai bagi reaction.action: reaksi ditambah, atau reaksi dibuang.

v12.0

Versi Graph API tempat Meta menyokong reaksi angry, sad, wow, love, like, laugh dan lain-lain dalam webhook ini.

No echo

Meta tidak menghantar notifikasi apabila akaun itu sendiri bereaksi atau membuang reaksi pada mesej seseorang.

Default

message_reactions termasuk antara medan yang dilanggan secara lalai oleh produk Instagram baharu dalam App Dashboard.

100/sec

Panggilan Send API sesaat bagi setiap akaun untuk teks, pautan, reaksi dan pelekat.

Bila message_reactions dicetuskan?

Apabila seseorang bereaksi kepada mesej dalam perbualannya dengan akaun profesional, dan sekali lagi apabila dia membuang reaksi itu, selepas aplikasi dan akaun dilanggan kepada medan ini. Panduan Meta untuk Instagram Messaging jelas tentang arah sebaliknya: apabila akaun itu sendiri bereaksi atau membuang reaksi, tiada notifikasi dihantar, dan messages juga tidak menghantar gema untuknya.

Bagaimana rupa notifikasi reaksi?

Satu POST dengan object ditetapkan kepada instagram, yang entry-nya memuat tatasusunan messaging. Tidak seperti DM, peristiwa ini tidak membawa objek message: reaksi berada dalam objek reaction sendiri, di sebelah sender, recipient dan timestamp. Contoh Meta untuk 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}"
          }
        }
      ]
    }
  ]
}

Apa maksud setiap medan?

Medan yang didokumenkan Meta untuk peristiwa reaksi, dari luar ke dalam:

  • entry[].id dan recipient.id: akaun profesional. sender.id: ID Instagram-scoped bagi orang yang bereaksi.
  • timestamp: bila peristiwa dicetuskan, dalam milisaat dalam contoh Meta; entry[].time ialah bila Meta menghantar notifikasi.
  • reaction.mid: ID mesej yang diberi reaksi, sama dengan mid yang mesej itu ada dalam peristiwa messages-nya.
  • reaction.action: react apabila reaksi ditambah, unreact apabila ia dibuang.
  • reaction.reaction: nama reaksi, seperti love; Meta menyenaraikan angry, sad, wow, love, like, laugh dan lain-lain.
  • reaction.emoji: emoji sebagai rentetan Unicode, seperti \u{2764}\u{FE0F} bagi love.
  • Pada unreact, reaction dan emoji ditinggalkan.

Bagaimana rupa unreact?

Peristiwa yang sama dengan action ditetapkan kepada unreact dan tanpa reaction mahupun emoji, kerana tiada apa lagi untuk dinamakan. Padankan dengan reaksi yang dibuang melalui reaction.mid dan sender.id, dan keluarkan reaksi orang itu daripada mesej dalam rekod anda.

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

Mesej mana yang ditunjuk oleh mid?

Mesej yang orang itu beri reaksi, di bawah mid yang sama seperti dalam peristiwa messages-nya, termasuk gema mesej akaun itu sendiri. Pengendali yang menyimpan mid boleh melampirkan reaksi pada baris yang betul dalam perbualan. Meta menyatakan satu jurang: reaksi kepada satu imej dalam siaran karusel melaporkan imej pertama karusel, yang mungkin bukan imej yang dipilih.

Bagaimana akaun bereaksi kepada mesej?

Dengan POST /<IG_ID>/messages: recipient.id ditetapkan kepada ID Instagram-scoped orang itu, sender_action ditetapkan kepada react, dan payload yang memuat message_id dan reaction, sama ada emoji atau bentuk UTF-8nya. Mengulang panggilan dengan emoji lain menukar reaksi, dan sender_action ditetapkan kepada unreact dengan message_id sahaja membuangnya. Kedua-dua panggilan tidak menghasilkan 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>"
  }
}

Apa yang message_reactions perlukan?

Dengan Instagram Login, instagram_business_basic dan instagram_business_manage_messages, serta Advanced Access bagi akaun yang tidak dimiliki atau diurus oleh pembangun. Produk Instagram baharu dalam App Dashboard secara lalai dilanggan kepada message_reactions, dan setiap akaun dilanggan melalui POST /<IG_ID>/subscribed_apps. Panduan Send Messages Meta menyenaraikannya sebagai messaging_reactions, tetapi jadual medannya, lalai dashboard dan rujukan webhook menulis message_reactions.

Adakah easyCoexistence memajukan reaksi?

Tidak. Aplikasi easyCoexistence dan setiap akaun yang disambungkan dilanggan kepada komen, mesej dan sebutan sahaja, jadi acara message_reactions tidak dimajukan ke endpoint anda. DM dan gema yang ditunjuk oleh reaksi melalui mid-nya memang sampai ke situ, ditandatangani dengan rahsia akaun.

Kesilapan biasa

  • Mencari reaksi di dalam message. Peristiwa reaksi tidak mempunyai objek message; baca objek reaction di sebelah sender dan recipient.
  • Membaca reaction atau emoji tanpa menyemak action. Kedua-duanya ditinggalkan pada unreact, jadi kod yang menganggap ia wujud akan gagal apabila reaksi dibuang.
  • Menunggu webhook selepas akaun bereaksi. Meta tidak menghantar apa-apa untuk reaksi akaun itu sendiri, malah tidak gema, jadi rekodkan ia apabila aplikasi anda menghantarnya.
  • Menyalin nama messaging_reactions daripada panduan Send Messages Meta. Medan dalam jadual medannya, lalai dashboard dan rujukan webhook ialah message_reactions.
Menggunakan EasyCoexistence untuk ini

Ejen anda membalas orang dengan send_social_dm dalam tetingkap 24 jam. US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Mengapa reaksi pada siaran karusel menunjuk kepada imej pertama?

Meta melaporkan imej pertama karusel apabila seseorang bereaksi kepada salah satu imejnya, yang mungkin bukan imej yang dipilih orang itu.

Adakah Instagram menghantar webhook apabila perniagaan bereaksi kepada mesej?

Tidak. Meta tidak menghantar notifikasi message_reactions dan tiada gema apabila akaun bereaksi atau membuang reaksi kepada mesej.

Reaksi apa yang boleh dilaporkan oleh webhook Instagram?

Panduan Instagram Messaging Meta menyenaraikan angry, sad, wow, love, like, laugh dan lain-lain bermula Graph API v12.0, dengan emoji itu sendiri dalam reaction.emoji.

Adakah nama medan webhook message_reactions atau messaging_reactions?

message_reactions. Panduan Send Messages Meta menulis messaging_reactions, tetapi jadual medannya, lalai App Dashboard dan rujukan webhook semuanya menggunakan message_reactions.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada