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

Instagram messaging_referral webhook'u: ig.me bağlantıları ve reklam yönlendirmeleri

Instagram'ın messaging_referral webhook alanı, profesyonel hesapla zaten konuşması olan bir kişi ref parametresi taşıyan bir ig.me bağlantısını açtığında uygulamaya bildirim gönderir. Olay, üst düzeyde bir referral nesnesi içerir: ref, parametrenin değeri; source, SHORTLINKS; ve type, OPEN_THREAD. Yeni bir konuşmadaki ref ise bunun yerine messages veya messaging_postbacks olayının içinde gelir.

easyCoexistence, bağlı her Instagram hesabını yorumlara, mesajlara ve bahsetmelere abone eder; böylece yeni konuşmanın ilk mesajındaki ref ile Click-to-Direct reklam yönlendirmesi, iletilen DM içinde HTTPS uç noktanıza ulaşır ve o hesabın gizli anahtarıyla imzalanır.

2,083

ig.me ref parametresinin alabileceği en fazla karakter sayısı; yalnızca harf, rakam, tire, alt çizgi ve eşittir işareti kullanılabilir.

OPEN_THREAD

ig.me bağlantıları için yönlendirme türü; Click-to-Direct reklamının yönlendirmesi de bu türü kullanır, ancak source değeri ADS olur.

24 hours

Mevcut bir konuşmadaki yönlendirmeden sonra uygulamanın yanıt verebileceği süre; standart pencereyi sıfırlar.

7 days

Click-to-Direct reklamına tıklandıktan sonra gönderilen ilk mesajdan itibaren pencerenin en fazla ne kadar sürebileceği.

Instagram Web

Meta'nın ig.me kılavuzuna göre ig.me bağlantılarının desteklenmediği yerler.

messaging_referral ne zaman tetiklenir?

Profesyonel hesapla zaten konuşması olan bir kişi, ref parametresi taşıyan bir ig.me bağlantısını açtığında. Instagram mevcut konuşmayı açar ve Meta, mesaj olmadan yönlendirmeyi kendiliğinden gönderir. Yönlendirmenin nerede geleceği konuşmaya ve kişinin ne yaptığına bağlıdır:

Existing threadmessaging_referral: a referral object beside sender, with no message.
New thread, ice breaker tappedmessaging_postbacks: postback.referral beside title and payload.
New thread, message typedmessages: message.referral beside mid.
Click-to-Direct admessages: message.referral with source ADS, ad_id and ads_context_data.

Yönlendirme bildirimi nasıl görünür?

referral nesnesinin sender, recipient ve timestamp alanlarının yanında yer aldığı, çevresinde mesaj ya da postback bulunmayan bir mesajlaşma olayıdır. Meta'nın ig.me kılavuzu, yönlendirmenin değerlerini diğer Instagram mesajlaşma olaylarıyla aynı zarf içinde verir:

A messaging_referral notification
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "referral": {
            "ref": "<REF_PARAMETER_VALUE>",
            "source": "SHORTLINKS",
            "type": "OPEN_THREAD"
          }
        }
      ]
    }
  ]
}

Her alan ne anlama gelir?

Meta'nın bir ig.me yönlendirmesi için belgelediği alanlar, dıştan içe doğru:

  • sender.id: bağlantıyı açan kişinin Instagram kapsamlı kimliği. recipient.id ve entry[].id: profesyonel hesap.
  • referral.ref: bağlantının ref parametresinin değeri, bağlantının taşıdığı biçimiyle.
  • referral.source: Meta'nın ig.me örneklerinde SHORTLINKS. Meta'nın Instagram Messaging kılavuzundaki bir tablo bunu SHORTLINK olarak yazar; örnekler sayfası ise yer tutucu gösterir.
  • referral.type: Meta'nın ig.me yönlendirmeleri için kullandığı OPEN_THREAD.
  • timestamp: olayın tetiklendiği zaman; Meta'nın örneklerinde milisaniye cinsinden.

ref'li bir ig.me bağlantısı nasıl oluşturulur?

https://ig.me/<USERNAME>?ref=<VALUE> biçiminde; burada USERNAME profesyonel hesabın kullanıcı adıdır (Meta'nın Instagram Login kılavuzunda). Instagram Messaging kılavuzu ise https://ig.me/m/<USERNAME> biçimini yazar. ref, harf, rakam, tire, alt çizgi ve eşittir işaretinden oluşan en fazla 2.083 karakter olabilir. Meta, kanalları izlemek, bir kişiyi başka bir uygulamadaki bir oturumla ilişkilendirmek ya da kişileri belirli içeriğe yönlendirmek için ref önerir; yeni konuşmalar için ise her biri kendi ref'ine sahip buz kırıcıları önerir.

Reklam yönlendirmeleri nereye gelir?

Mesajlara. Instagram Direct'i açan ve mesaj gönderen bir reklama tıklayan kişi, message.referral alanında şu bilgileri içeren bir messages olayı üretir: varsa reklamın ref'i, ad_id, source ADS, type OPEN_THREAD ve reklamın başlığı ile tıklanan photo_url ya da video_url değerini içeren ads_context_data. Meta'nın Instagram sayfaları messaging_referral'ı yalnızca ig.me bağlantıları için belgeler.

A Click-to-Direct ad referral, inside messages
"message": {
  "mid": "<MESSAGE_ID>",
  "referral": {
    "ref": "<AD_REF_IF_SET>",
    "ad_id": "<AD_ID>",
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ads_context_data": {
      "ad_title": "<AD_TITLE>",
      "photo_url": "<IMAGE_URL_CLICKED>",
      "video_url": "<THUMBNAIL_URL_FOR_THE_AD_VIDEO>"
    }
  }
}

Yönlendirme mesajlaşma penceresini açar mı?

Mevcut konuşmada evet: Meta'nın ig.me kılavuzuna göre yönlendirme standart 24 saatlik mesajlaşma penceresini sıfırlar, böylece uygulama olaydan itibaren 24 saat içinde yanıt verebilir. Click-to-Direct reklamına tıkladıktan sonra gönderilen ilk mesaj, o mesajdan itibaren en fazla 7 güne kadar uzanan bir pencere açabilir. POST /<IG_ID>/messages ile yanıt verin ve recipient.id değerini olayın sender.id değerine ayarlayın.

easyCoexistence yönlendirmeleri iletir mi?

Mesajların içinde taşınanları. Bağlı her hesap yorumlara, mesajlara ve bahsetmelere abone olur; bu nedenle yeni konuşmanın ilk mesajındaki ref ile Click-to-Direct reklam yönlendirmesi, iletilen DM içinde message.referral olarak uç noktanıza ulaşır. Mevcut konuşmalar için messaging_referral ve buz kırıcı dokunuşları için messaging_postbacks, Meta'nın bunlara abone olan bir uygulamaya ayrıca ilettiği ayrı alanlardır.

Yaygın hatalar

  • Yeni bir konuşmada messaging_referral beklemek. Orada ref, kişinin yazıp yazmadığına ya da bir buz kırıcıya dokunup dokunmadığına bağlı olarak messages veya messaging_postbacks içinde gelir.
  • ref'e başka karakterler koymak. Meta; harf, rakam, tire, alt çizgi ve eşittir işaretini, en fazla 2.083 karakter olmak üzere kabul eder.
  • source'u tek bir tam metinle eşleştirmek. Meta'nın örnekleri ig.me için SHORTLINKS, reklamlar için ADS gösterir; ancak tablolardan biri SHORTLINK yazar. Dallanmayı yönlendirmenin nerede bulunduğuna ve ref'e göre yapın.
  • Bağlantıları Instagram Web'de test etmek. Meta, ig.me bağlantılarını orada desteklemez; bu nedenle bunları Instagram uygulamasında açın.
Bunu EasyCoexistence'la yapmak

send_social_dm, yanıtı 24 saatlik pencere içinde gönderir. Bağlantı başına aylık US$ 9 ile US$ 0,75 arası; bağlantı ekledikçe düşer. İlk 3 gün ücretsiz.

Sık sorulan sorular

referral.source bir Instagram yönlendirmesinde ne içerir?

Meta'nın ig.me örneklerinde SHORTLINKS, Click-to-Direct reklamında ADS. Ancak Meta'nın Instagram Messaging kılavuzundaki bir tablo SHORTLINK yazar. Tek bir tam metne bakmak yerine yönlendirmenin nerede olduğuna ve ref'e göre dallanın.

Bir ig.me ref parametresi en fazla ne kadar uzun olabilir?

En fazla 2.083 karakter; yalnızca harf, rakam, tire, alt çizgi ve eşittir işareti kullanılabilir.

Yeni bir Instagram konuşmasında ig.me ref'i nereye gelir?

Kişi ilk mesajı yazdığında messages üzerinde; bir buz kırıcıya dokunduğunda messaging_postbacks üzerinde. messaging_referral yalnızca mevcut konuşmaları kapsar.

ig.me bağlantıları Instagram Web'de çalışır mı?

Hayır. Meta'nın ig.me kılavuzuna göre Instagram Web'de desteklenmezler.

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