Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Webhook messaging_referral Instagram: pautan ig.me dan rujukan iklan

Medan messaging_referral Instagram memberitahu aplikasi apabila seseorang yang sudah mempunyai perbualan dengan akaun profesional membuka pautan ig.me yang membawa parameter ref. Peristiwa itu mengandungi objek referral peringkat atas: ref, nilai parameter itu; source, SHORTLINKS; dan type, OPEN_THREAD. Rujukan ref pada perbualan baharu tiba dalam peristiwa messages atau messaging_postbacks sebaliknya.

easyCoexistence melanggan setiap akaun Instagram yang disambungkan kepada comments, messages dan mentions, jadi ref pada mesej pertama perbualan baharu dan rujukan iklan Click-to-Direct sampai ke endpoint HTTPS anda di dalam DM yang dimajukan, ditandatangani dengan rahsia akaun itu.

2,083

Jumlah aksara paling banyak yang boleh dimuat parameter ref ig.me, menggunakan huruf, digit, sengkang, garis bawah dan tanda sama dengan sahaja.

OPEN_THREAD

Jenis rujukan untuk pautan ig.me; rujukan iklan Click-to-Direct juga menggunakannya, dengan source ADS.

24 hours

Masa aplikasi boleh membalas selepas rujukan dalam perbualan sedia ada, yang menetapkan semula tetingkap standard.

7 days

Tempoh tetingkap boleh berlangsung daripada mesej pertama yang dihantar selepas klik iklan Click-to-Direct.

Instagram Web

Tempat pautan ig.me tidak disokong, menurut panduan ig.me Meta.

Bila messaging_referral dicetuskan?

Apabila seseorang yang sudah mempunyai perbualan dengan akaun profesional membuka pautan ig.me yang membawa parameter ref. Instagram membuka perbualan sedia ada dan Meta menghantar rujukan itu sendiri, tanpa mesej. Tempat ref tiba bergantung pada perbualan dan tindakan orang itu:

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.

Bagaimana rupa notifikasi rujukan?

Peristiwa mesej yang objek referral-nya berada di sebelah sender, recipient dan timestamp, tanpa mesej atau postback di sekelilingnya. Panduan ig.me Meta memberikan nilai rujukan itu, dalam sampul yang sama seperti peristiwa mesej Instagram yang lain:

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

Apakah maksud setiap medan?

Medan yang didokumenkan Meta untuk rujukan ig.me, dari luar ke dalam:

  • sender.id: ID berskop Instagram bagi orang yang membuka pautan. recipient.id dan entry[].id: akaun profesional.
  • referral.ref: nilai parameter ref pada pautan, seperti yang dibawa pautan itu.
  • referral.source: SHORTLINKS dalam contoh ig.me Meta. Satu jadual dalam panduan Instagram Messaging Meta mengejanya SHORTLINK, dan halaman contohnya menunjukkan pemegang tempat.
  • referral.type: OPEN_THREAD, yang Meta gunakan untuk rujukan ig.me.
  • timestamp: bila peristiwa dicetuskan, dalam milisaat dalam contoh Meta.

Bagaimana membina pautan ig.me dengan ref?

Sebagai https://ig.me/<USERNAME>?ref=<VALUE>, dengan USERNAME ialah nama pengguna akaun profesional, dalam panduan Instagram Login Meta; panduan Instagram Messaging Meta menulisnya sebagai https://ig.me/m/<USERNAME>. Ref boleh mencapai 2,083 aksara huruf, digit, sengkang, garis bawah dan tanda sama. Meta mencadangkan ref untuk menjejak saluran, mengaitkan seseorang dengan sesi dalam aplikasi lain atau menghalakan mereka ke kandungan tertentu, dan mengesyorkan ice breaker, setiap satu dengan ref sendiri, untuk perbualan baharu.

Di mana rujukan iklan tiba?

Pada mesej. Orang yang mengklik iklan yang membuka Instagram Direct dan menghantar mesej menghasilkan peristiwa messages yang message.referral-nya memegang ref iklan jika ditetapkan, ad_id, source ADS, type OPEN_THREAD dan ads_context_data dengan tajuk iklan serta photo_url atau video_url yang diklik. Halaman Instagram Meta mendokumenkan messaging_referral untuk pautan ig.me sahaja.

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

Adakah rujukan membuka tetingkap mesej?

Ya, dalam perbualan sedia ada: panduan ig.me Meta menyatakan rujukan menetapkan semula tetingkap mesej standard 24 jam, jadi aplikasi boleh membalas dalam tempoh 24 jam dari peristiwa itu. Mesej pertama yang dihantar selepas klik iklan Click-to-Direct boleh membuka tetingkap sehingga 7 hari dari mesej itu. Balas dengan POST /<IG_ID>/messages dengan recipient.id ditetapkan kepada sender.id peristiwa itu.

Adakah easyCoexistence memajukan rujukan?

Yang menumpang pada mesej. Setiap akaun Instagram yang disambungkan dilanggan kepada comments, messages dan mentions, jadi ref pada mesej pertama perbualan baharu dan rujukan iklan Click-to-Direct sampai ke endpoint anda di dalam DM yang dimajukan, sebagai message.referral. messaging_referral, untuk perbualan sedia ada, dan messaging_postbacks, untuk ketukan ice breaker, ialah medan berasingan yang Meta hantar kepada aplikasi yang melanggannya.

Kesilapan biasa

  • Menunggu messaging_referral pada perbualan baharu. Di situ ref tiba dalam messages atau messaging_postbacks, bergantung pada sama ada orang itu menaip atau mengetik ice breaker.
  • Meletakkan aksara lain dalam ref. Meta menerima huruf, digit, sengkang, garis bawah dan tanda sama, sehingga 2,083 aksara.
  • Memadankan source dengan satu rentetan tepat. Contoh Meta menunjukkan SHORTLINKS untuk ig.me dan ADS untuk iklan, tetapi satu jadual mengejanya SHORTLINK, jadi buat cabang berdasarkan tempat rujukan berada dan pada ref.
  • Menguji pautan dalam Instagram Web. Meta tidak menyokong pautan ig.me di sana, jadi buka pautan dalam aplikasi Instagram.
Menggunakan EasyCoexistence untuk ini

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

Soalan lazim

Apakah yang terkandung dalam referral.source pada rujukan Instagram?

SHORTLINKS dalam contoh ig.me Meta dan ADS untuk iklan Click-to-Direct, walaupun satu jadual dalam panduan Instagram Messaging Meta mengejanya SHORTLINK. Buat cabang berdasarkan tempat rujukan berada dan pada ref, bukan pada satu rentetan tepat.

Berapa panjang parameter ref ig.me boleh dibuat?

Sehingga 2,083 aksara, hanya menggunakan huruf, digit, sengkang, garis bawah dan tanda sama.

Di mana ref ig.me tiba pada perbualan Instagram baharu?

Pada messages apabila orang itu menaip mesej pertama, atau pada messaging_postbacks apabila mereka mengetik ice breaker. messaging_referral hanya meliputi perbualan sedia ada.

Adakah pautan ig.me berfungsi di Instagram Web?

Tidak. Panduan ig.me Meta menyatakan ia tidak disokong di Instagram Web.

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