ID pengguna Instagram: IG_ID, IGSID dan ID berlingkup aplikasi
API Instagram menggunakan tiga jenis ID pengguna. IG_ID adalah ID akun profesional: GET /me mengembalikannya sebagai user_id dengan Instagram Login, webhook membawanya sebagai entry.id, dan path seperti /<IG_ID>/media memakainya. IGSID, atau ID berlingkup Instagram, mewakili orang yang mengirim pesan atau berkomentar pada akun tersebut. ID berlingkup aplikasi adalah field id yang dikembalikan /me.
easyCoexistence memberi setiap akun Instagram yang terhubung satu account_id untuk alatnya, di samping IG_ID, dan meneruskan event Meta beserta IGSID yang dibawanya, sehingga Claude, ChatGPT, atau kode Anda sendiri dapat membalas komentar dan DM melalui API resmi Meta.
Field /me yang berisi ID akun profesional Instagram, yaitu id dalam notifikasi webhook akun tersebut.
Pada /me dengan Instagram Login, ID berlingkup aplikasi milik pengguna aplikasi.
IGSID bersifat spesifik untuk orang tersebut dan akun Instagram yang mereka ajak berinteraksi.
Webhook DM yang diterima membawa IGSID orang tersebut; recipient.id berisi ID akun.
Dibutuhkan untuk User Profile API; Meta mengaturnya saat orang tersebut mengirim pesan ke akun atau menekan ice breaker atau menu.
Apa itu IG_ID?
ID akun profesional Instagram, objek tempat sebagian besar panggilan API dilakukan. Dengan Instagram Login, GET /me?fields=user_id,username mengembalikannya sebagai user_id, dan panduan Meta menyebut nilainya sama dengan id pada notifikasi webhook akun, yaitu entry.id. Dengan Facebook Login, sebuah Halaman mengembalikannya di field instagram_business_account. Path seperti /<IG_ID>/media, /<IG_ID>/conversations dan /<IG_ID>/insights memakainya.
Apa itu IGSID?
ID berlingkup Instagram, dibuat saat seseorang berkomentar di postingan, Reel atau Story akun, atau mengirim pesan kepadanya. Meta membatasi ID ini pada orang dan akun yang mereka ajak berinteraksi, sehingga orang yang sama memiliki IGSID berbeda untuk setiap akun profesional, tetapi tetap sama di seluruh aplikasi: Meta menyebutkan bahwa ini memungkinkan bisnis memetakan interaksi satu orang di berbagai aplikasi. Inilah ID yang dipakai untuk membalas, mencari percakapan, dan mencari orang.
Apa itu ID berlingkup aplikasi?
id pada GET /me dengan Instagram Login, yang oleh panduan Meta disebut ID berlingkup aplikasi milik pengguna aplikasi; contoh panggilannya memakai user_id, bukan id, pada path berikutnya. Pertukaran kode saat login juga mengembalikan user_id, yang oleh panduan login disebut ID pengguna berlingkup Instagram milik pengguna aplikasi. Karena panduan memulai mengaitkan user_id dari /me dengan notifikasi webhook, nilai itulah yang disimpan sebagai IG_ID.
Di mana setiap ID muncul?
Referensi dan contoh webhook Meta menempatkannya seperti di bawah. Seseorang muncul sebagai IGSID baik saat berkomentar maupun menulis DM, dan akun sebagai IG_ID: penerima pada DM yang diterima, pengirim pada DM yang dikirim:
Bagaimana mencari orang dari IGSID?
Dengan User Profile API: GET /<IGSID> di graph.instagram.com, dengan instagram_business_basic dan instagram_business_manage_messages. Dibutuhkan persetujuan orang tersebut, yang oleh Meta hanya diaktifkan saat mereka mengirim pesan ke akun atau menekan item ice breaker atau item menu persisten. URL profile_pic kedaluwarsa dalam beberapa hari, dan orang yang memblokir akun tidak dapat dicari.
GET https://graph.instagram.com/<IGSID>
?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
&access_token=<ACCESS_TOKEN>Bisakah satu jenis ID diubah menjadi jenis lain?
Rute yang didokumentasikan Meta berupa pencarian. Dari IGSID, User Profile API memberikan username orang tersebut. Dari username, Business Discovery mengembalikan id akun bisnis atau kreator lain, dengan Facebook Login atau Unified Login. Dari token, GET /me memberikan IG_ID. IGSID hanya milik satu akun profesional, sehingga IGSID orang yang sama yang dilihat akun lain berbeda dari IGSID tersebut.
ID apa yang digunakan easyCoexistence?
Milik Meta, ditambah satu milik kami sendiri. list_social_accounts mengembalikan account_id, ID easyCoexistence untuk koneksi yang dipakai alat lain, dan external_id, yaitu IG_ID; get_social_credentials mengembalikan IG_ID sebagai account_id_on_meta. Event yang diteruskan datang dengan platform, account_id, external_id, dan entry Meta tanpa perubahan, dan send_social_dm menerima IGSID orang tersebut sebagai recipient_id.
Kesalahan umum
- Menyimpan user_id dari pertukaran kode sebagai ID akun. Bacalah user_id dari GET /me, yang oleh Meta dikaitkan dengan id pada notifikasi webhook.
- Menggunakan ulang IGSID di seluruh akun profesional. IGSID berlingkup satu akun, sehingga orang yang sama memiliki IGSID lain di tempat lain.
- Mencari orang yang berkomentar tetapi tidak pernah menulis. Meta hanya mengaktifkan persetujuan saat orang tersebut mengirim pesan ke akun atau menekan item ice breaker atau menu.
- Menyimpan URL profile_pic. Meta menyebut URL ini kedaluwarsa dalam beberapa hari, jadi minta ulang saat dibutuhkan.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
IGSID sama dengan ID pengguna Instagram?
Tidak. IGSID mengidentifikasi seseorang bagi satu akun profesional, sedangkan IG_ID mengidentifikasi akun profesional itu sendiri.
Mengapa ID webhook saya tidak sama dengan ID dari login?
Pertukaran kode mengembalikan user_id yang oleh Meta disebut berlingkup Instagram, sedangkan notifikasi webhook membawa user_id yang dikembalikan GET /me. Simpan yang berasal dari /me.
Bisakah saya mendapatkan username Instagram seseorang dari IGSID?
Bisa, melalui User Profile API, setelah orang tersebut mengirim pesan ke akun atau menekan item ice breaker atau menu persisten.
Apakah IGSID berubah antar aplikasi?
Tidak. Meta menyebutkan bahwa ini memungkinkan bisnis memetakan interaksi orang yang sama di berbagai aplikasi, meskipun IGSID berbeda untuk setiap akun profesional.
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