Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Instagram message_reactions webhook'u: react ve unreact payload'u

Instagram'ın message_reactions webhook alanı, bir kişi profesyonel hesapla olan sohbetindeki bir mesaja tepki verdiğinde ya da tepkisini kaldırdığında uygulamayı bilgilendirir. Olay, bir reaction nesnesi içeren messaging dizisinde yer alır: mid, tepki verilen mesajın ID'si; action, react ya da unreact; ve yalnızca react olduğunda reaction, örneğin love, ile emoji, emojinin kendisi.

easyCoexistence, bağlı her Instagram hesabını yorumlara, mesajlara ve bahsetmelere abone eder; bu olayları geldikçe, hesabın gizli anahtarıyla imzalanmış olarak HTTPS uç noktanıza iletir ve her mesajı mid'iyle birlikte gönderir.

react / unreact

reaction.action'ın iki değeri: bir tepkinin eklenmesi ya da bir tepkinin kaldırılması.

v12.0

Meta'nın bu webhook'ta angry, sad, wow, love, like, laugh ve diğer tepkileri desteklemeye başladığı Graph API sürümü.

No echo

Hesabın kendisi bir kişinin mesajına tepki verdiğinde ya da tepkisini kaldırdığında Meta bildirim göndermez.

Default

message_reactions, uygulama panelinde oluşturulan yeni bir Instagram ürününün başlangıçta abone olduğu alanlardan biridir.

100/sec

Send API çağrıları için hesap başına saniye başına sınır: metin, bağlantı, tepki ve çıkartmalar.

message_reactions ne zaman tetiklenir?

Bir kişi, profesyonel hesapla olan sohbetindeki bir mesaja tepki verdiğinde ve tepkisini kaldırdığında, uygulama ve hesap alana abone olduktan sonra. Meta'nın Instagram Messaging rehberi diğer yön konusunda açık: hesap kendisi tepki verdiğinde ya da tepkisini kaldırdığında bildirim gönderilmez ve messages da bunun için bir echo iletmez.

Bir tepki bildirimi nasıl görünür?

Nesnesi instagram olarak ayarlanmış bir POST; entry içinde bir messaging dizisi bulunur. Bir DM'den farklı olarak olay bir message nesnesi taşımaz: tepki, gönderen, alıcı ve zaman damgasının yanındaki kendi reaction nesnesinde yer alır. Meta'nın Instagram Login için örneği:

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

Her alan ne anlama geliyor?

Meta'nın bir tepki olayı için belgelediği alanlar, dıştan içe doğru:

  • entry[].id ve recipient.id: profesyonel hesap. sender.id: tepkiyi veren kişinin Instagram kapsamlı ID'si.
  • timestamp: olayın tetiklendiği an; Meta örneklerinde milisaniye cinsinden. entry[].time ise Meta'nın bildirimi gönderdiği zamandır.
  • reaction.mid: tepki verilen mesajın ID'si; mesajın messages olayındaki aynı mid'i.
  • reaction.action: bir tepki eklendiğinde react, kaldırıldığında unreact.
  • reaction.reaction: tepkinin adı, örneğin love; Meta angry, sad, wow, love, like, laugh ve diğer tepkileri listeler.
  • reaction.emoji: Unicode dizgisi olarak emoji, örneğin love için \u{2764}\u{FE0F}.
  • unreact olduğunda reaction ve emoji alanları çıkarılır.

Bir unreact nasıl görünür?

Aynı olay, action değeri unreact olarak ve reaction ile emoji olmadan, çünkü adlandırılacak bir şey kalmamıştır. Onu kaldırdığı tepkiyle reaction.mid ve sender.id üzerinden eşleştirin ve kayıtlarınızda o kişinin tepkisini mesajdan çıkarın.

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

mid hangi mesajı işaret eder?

Kişinin tepki verdiği mesajı, messages olayında taşıdığı aynı mid ile; hesabın kendi mesajlarının echo'ları dahil. mid'leri saklayan bir işleyici tepkiyi sohbetin doğru satırına bağlayabilir. Meta bir boşluğa dikkat çekiyor: kaydırmalı bir gönderideki tek bir görsele verilen tepki, seçilen görsel olmayabilen karuselin ilk görselini bildirir.

Bir hesap bir mesaja nasıl tepki verir?

POST /<IG_ID>/messages ile: recipient.id kişinin Instagram kapsamlı ID'sine ayarlanmış, sender_action react olarak ayarlanmış ve message_id ile reaction içeren bir payload; reaction bir emoji ya da UTF-8 biçimidir. Çağrıyı başka bir emojiyle tekrarlamak tepkiyi değiştirir; yalnızca message_id ile sender_action unreact olarak ayarlanırsa tepki kaldırılır. İki çağrı da webhook üretmez.

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 neye ihtiyaç duyar?

Instagram Login ile instagram_business_basic ve instagram_business_manage_messages, ve geliştiricinin sahip olmadığı ya da yönetmediği hesaplar için Advanced Access. Uygulama panelinde oluşturulan yeni bir Instagram ürünü message_reactions'a abone olarak başlar; her hesap POST /<IG_ID>/subscribed_apps ile abone edilir. Meta'nın Send Messages rehberi bunu messaging_reactions olarak listeler; ancak alanlar tablosu, uygulama paneli varsayılanları ve webhook referansı message_reactions diyor.

easyCoexistence tepkileri iletiyor mu?

Hayır. easyCoexistence'ın uygulaması ve bağlı her hesap yalnızca yorumlara, mesajlara ve bahsetmelere abonedir; bu yüzden message_reactions olayları uç noktanıza iletilmez. Tepkilerin mid değeriyle işaret ettiği DM'ler ve echo'lar ise hesabın gizli anahtarıyla imzalanarak uç noktanıza ulaşır.

Yaygın hatalar

  • Tepkiyi message içinde aramak. Bir tepki olayında message nesnesi yoktur; sender ve recipient'in yanındaki reaction nesnesini okuyun.
  • action'ı kontrol etmeden reaction ya da emoji okumak. Bu ikisi unreact'te çıkarılır; bu yüzden tepki kaldırıldığında varsayım yapan kod bozulur.
  • Hesap tepki verdikten sonra webhook beklemek. Meta, hesabın kendi tepkileri için hiçbir webhook göndermez, echo bile göndermez; bu yüzden uygulamanız gönderdiğinde bunları kaydedin.
  • Meta'nın Send Messages rehberindeki messaging_reactions adını kopyalamak. Alanlar tablosundaki, uygulama paneli varsayılanlarındaki ve webhook referansındaki alan adı message_reactions.
Bunu EasyCoexistence'la yapmak

Agent'ınız 24 saatlik pencere içinde bir kişiye send_social_dm ile yanıt verir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arası, bağlantı eklendikçe düşer; ilk 3 gün ücretsiz.

Sık sorulan sorular

Kaydırmalı bir gönderideki tepki neden ilk görseli işaret ediyor?

Meta, biri karuselin bir görseline tepki verdiğinde ilk görseli bildirir; kişinin seçtiği görsel bu olmayabilir.

Hesap bir mesaja tepki verdiğinde Instagram webhook gönderir mi?

Hayır. Hesap bir mesaja tepki verdiğinde ya da tepkisini kaldırdığında Meta ne message_reactions bildirimi ne de echo gönderir.

Instagram webhook'u hangi tepkileri bildirebilir?

Meta'nın Instagram Messaging rehberi, Graph API v12.0'dan itibaren angry, sad, wow, love, like, laugh ve diğerlerini listeler; emojinin kendisi reaction.emoji içinde yer alır.

Webhook alanı message_reactions mı yoksa messaging_reactions mı?

message_reactions. Meta'nın Send Messages rehberi messaging_reactions yazar; ancak alanlar tablosu, uygulama paneli varsayılanları ve webhook referansı hepsi message_reactions kullanır.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi