Webhook messaging_referral Instagram: tautan ig.me dan referral iklan
Field messaging_referral Instagram memberi tahu aplikasi ketika seseorang yang sudah memiliki percakapan dengan akun profesional membuka tautan ig.me yang membawa parameter ref. Event tersebut berisi objek referral level atas: ref, nilai parameter; source, SHORTLINKS; dan type, OPEN_THREAD. Ref pada percakapan baru justru tiba di dalam event messages atau messaging_postbacks.
easyCoexistence berlangganan setiap akun Instagram yang terhubung ke comments, messages, dan mentions, sehingga ref pada pesan pertama percakapan baru dan referral iklan Click-to-Direct sampai ke endpoint HTTPS Anda di dalam DM yang diteruskan, ditandatangani dengan secret akun tersebut.
Jumlah karakter terbanyak yang dapat dimuat parameter ref ig.me, hanya menggunakan huruf, angka, tanda hubung, garis bawah, dan tanda sama dengan.
Tipe referral untuk tautan ig.me; referral iklan Click-to-Direct juga memakainya, dengan source ADS.
Waktu yang dimiliki aplikasi untuk membalas setelah referral pada percakapan yang sudah ada, yang mengatur ulang jendela pesan standar.
Berapa lama jendela tersebut dapat bertahan dari pesan pertama yang dikirim setelah mengklik iklan Click-to-Direct.
Kondisi saat tautan ig.me tidak didukung, menurut panduan ig.me dari Meta.
Kapan messaging_referral terpicu?
Ketika seseorang yang sudah memiliki percakapan dengan akun profesional membuka tautan ig.me yang membawa parameter ref. Instagram membuka percakapan yang sudah ada dan Meta mengirim referral dengan sendirinya, tanpa pesan. Di mana ref tiba bergantung pada percakapan dan tindakan orang tersebut:
Seperti apa notifikasi referral?
Event pesan yang objek referral-nya berada di samping sender, recipient, dan timestamp, tanpa message maupun postback di sekitarnya. Panduan ig.me dari Meta memberikan nilai referral, di dalam amplop yang sama dengan event pesan Instagram lainnya:
{
"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"
}
}
]
}
]
}Apa arti setiap field?
Field yang didokumentasikan Meta untuk referral ig.me, dari luar ke dalam:
- sender.id: ID berbasis Instagram dari orang yang membuka tautan. recipient.id dan entry[].id: akun profesional.
- referral.ref: nilai parameter ref dari tautan, sebagaimana tautan membawanya.
- referral.source: SHORTLINKS pada contoh ig.me dari Meta. Satu tabel di panduan Instagram Messaging-nya menulisnya SHORTLINK, dan halaman contohnya menampilkan placeholder.
- referral.type:
OPEN_THREAD, yang digunakan Meta untuk referral ig.me. - timestamp: waktu event dipicu, dalam milidetik pada contoh Meta.
Bagaimana cara membuat tautan ig.me dengan ref?
Dengan format https://ig.me/<USERNAME>?ref=<VALUE>, dengan USERNAME adalah handle akun profesional, menurut panduan Instagram Login dari Meta; panduan Instagram Messaging-nya menulis https://ig.me/m/<USERNAME>. Ref dapat berisi hingga 2,083 karakter berupa huruf, angka, tanda hubung, garis bawah, dan tanda sama dengan. Meta menyarankan ref untuk melacak saluran, mengaitkan seseorang dengan sesi di aplikasi lain, atau mengarahkan mereka ke konten tertentu, dan merekomendasikan ice breaker, masing-masing dengan ref sendiri, untuk percakapan baru.
Ke mana referral iklan tiba?
Pada pesan. Orang yang mengklik iklan yang membuka Instagram Direct dan mengirim pesan menghasilkan event messages yang message.referral-nya berisi ref iklan jika ada yang diatur, ad_id, source ADS, type OPEN_THREAD, dan ads_context_data dengan judul iklan serta photo_url atau video_url yang diklik. Halaman Instagram Meta hanya mendokumentasikan messaging_referral untuk tautan ig.me.
"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>"
}
}
}Apakah referral membuka jendela pesan?
Ya, pada percakapan yang sudah ada: panduan ig.me Meta menyatakan referral mengatur ulang jendela pesan standar 24 jam, sehingga aplikasi dapat membalas dalam 24 jam sejak event. Pesan pertama yang dikirim setelah mengklik iklan Click-to-Direct dapat membuka jendela hingga 7 hari sejak pesan tersebut. Balas dengan POST /<IG_ID>/messages dan recipient.id diisi dengan sender.id dari event.
Apakah easyCoexistence meneruskan referral?
Yang menumpang pada pesan. Setiap akun Instagram yang terhubung berlangganan comments, messages, dan mentions, sehingga ref pada pesan pertama percakapan baru dan referral iklan Click-to-Direct sampai ke endpoint Anda di dalam DM yang diteruskan, sebagai message.referral. messaging_referral, untuk percakapan yang sudah ada, dan messaging_postbacks, untuk ketukan ice breaker, adalah field terpisah yang dikirim Meta ke aplikasi yang berlangganan kepadanya.
Kesalahan umum
- Menunggu messaging_referral pada percakapan baru. Di sana ref tiba di messages atau messaging_postbacks, bergantung pada apakah orang tersebut mengetik atau mengetuk ice breaker.
- Memasukkan karakter lain ke dalam ref. Meta hanya menerima huruf, angka, tanda hubung, garis bawah, dan tanda sama dengan, hingga 2,083 karakter.
- Mencocokkan source dengan satu string persis. Contoh Meta menampilkan SHORTLINKS untuk ig.me dan ADS untuk iklan, tetapi salah satu tabelnya tertulis SHORTLINK, jadi cabangkan berdasarkan letak referral dan ref.
- Menguji tautan di Instagram Web. Meta tidak mendukung tautan ig.me di sana, jadi bukalah di aplikasi Instagram.
send_social_dm membalas di dalam jendela 24 jam. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apa isi referral.source dalam referral Instagram?
SHORTLINKS pada contoh ig.me dari Meta dan ADS untuk iklan Click-to-Direct, meskipun satu tabel di panduan Instagram Messaging dari Meta menulisnya SHORTLINK. Cabangkan berdasarkan letak referral dan ref, bukan pada satu string persis.
Berapa panjang parameter ref ig.me?
Hingga 2,083 karakter, hanya menggunakan huruf, angka, tanda hubung, garis bawah, dan tanda sama dengan.
Di mana ref ig.me tiba pada percakapan Instagram baru?
Pada messages ketika orang tersebut mengetik pesan pertama, atau pada messaging_postbacks ketika mereka mengetuk ice breaker. messaging_referral hanya mencakup percakapan yang sudah ada.
Apakah tautan ig.me berfungsi di Instagram Web?
Tidak. Panduan ig.me dari Meta menyatakan tautan tersebut tidak didukung di Instagram Web.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada