Semua yang Perlu Anda Ketahui Tentang Nama Pengguna WhatsApp & BSUID (Mulai Juni 2026)

Mengapa WhatsApp Memperkenalkan Username?

Apa yang Berubah?

Pesan Autentikasi (Kode Verifikasi/OTP) Harus Dikirim via Nomor Telepon

Ada juga satu batasan penting: Pesan autentikasi masih memerlukan nomor telepon.
Anda tidak dapat mengirim pesan autentikasi OTP atau copy-code hanya dengan BSUID. Jika alur tersebut penting bagi bisnis Anda, Anda memerlukan cara yang jelas untuk meminta dan menyimpan nomor telepon pengguna.

Dan dalam beberapa kasus, WhatsApp mungkin masih membagikan nomor telepon dengan bisnis, seperti ketika:

• Pengguna secara aktif memilih untuk membagikannya
• Sudah ada percakapan antara pengguna dan bisnis
• Bisnis tersimpan di kontak WhatsApp pengguna

Jadi bisnis sekarang perlu mendukung kedua situasi sekaligus:

• Pelanggan yang hanya diidentifikasi melalui BSUID
• Pelanggan teridentifikasi melalui nomor telepon dan BSUID

Itulah mengapa ini bukan sekadar pembaruan produk. Ini adalah pembaruan sistem.

Apa itu BSUID (Business Scoped User ID)

Cara Kerja BSUID

• Ini secara otomatis dihasilkan oleh WhatsApp
• Ini muncul dalam payload webhook (sebagai user_id)
• Ini tetap berfungsi bahkan ketika nomor telepon tidak ada
• Ini terkait dengan portofolio bisnis tertentu

Jadi dari sudut pandang sistem, ini menjadi identifikasi pengguna baru dalam percakapan masuk.

Format BSUID (Seperti Apa Bentuknya)

Sebuah BSUID mengikuti struktur tetap:

• Dimulai dengan kode negara ISO 3166 alpha-2 pengguna Kode negara dua huruf
• Diikuti oleh titik (.)
• Kemudian string alfanumerik unik (hingga 128 karakter)

Example:
US.13491208655302741918

Saat menggunakannya di API, nilai keseluruhan harus digunakan persis seperti adanya.
Setiap perubahan atau pemotongan akan menyebabkan permintaan gagal.

Aturan Penting yang Harus Diketahui

• Sebuah BSUID bersifat unik untuk setiap pasangan portofolio bisnis-pengguna (portofolio bisnis sebelumnya dikenal sebagai Business Managers)
• Ini akan dibuat ulang jika pengguna mengubah nomor telepon mereka (yang memicu webhook pesan status sistem)
• Ini terbatas pada portofolio bisnis tertentu (tidak dapat digunakan di berbagai portofolio)
• Ini muncul di webhook bahkan jika pengguna tidak mengaktifkan nama pengguna

Keterbatasan BSUID

BSUID powerful, tetapi bukan pengganti lengkap untuk nomor telepon.

• Anda tidak dapat mengirim pesan autentikasi (OTP, kode verifikasi) menggunakan BSUID
• Alur ini masih memerlukan nomor telepon
• Jadi jika kasus penggunaan Anda bergantung pada OTP, Anda harus mengumpulkan nomor dari pengguna

Apa yang TIDAK Berubah

Mekanisme Pengiriman dan Penerimaan Pesan

• Penggunaan template pesan tetap tidak berubah.
• Dukungan untuk berbagai jenis pesan (teks, gambar, video, dokumen, dll.) tetap tidak berubah.
• Struktur antarmuka API pengiriman pesan sebagian besar tetap konsisten, kecuali parameter pengidentifikasi perlu kompatibel dengan BSUID.
• Bisnis yang sudah memiliki informasi nomor telepon orang dari percakapan yang ada tidak akan kehilangannya dan dapat terus menggunakannya untuk menghubungi kontak mereka.

Aturan Penagihan Percakapan

• Mekanisme jendela percakapan 24 jam tetap tidak berubah.
• Metode penagihan percakapan tetap tidak berubah.
• Terlepas dari apakah pelanggan menggunakan nomor telepon atau nama pengguna, logika penagihan tetap konsisten.

Apa Lagi?

• Nomor telepon akan tetap menjadi bagian dari cara kerja WhatsApp.
• Jika pengguna belum mengadopsi nama pengguna, bisnis akan menerima nomor telepon mereka dan pengidentifikasi berlingkup bisnis.

Ini berarti bisnis harus fokus pada upaya utama mereka dalam identifikasi pelanggan dan asosiasi data; kemampuan komunikasi pesan inti dan logika bisnis akan terus bekerja seperti biasa

Selanjutnya, mari kita lihat tantangan yang akan dihadapi bisnis saat menyesuaikan diri dengan sistem identifikasi baru ini.

Tantangan yang Dihadapi Bisnis

Tantangan 1: Ketidakmampuan Mendapatkan Nomor Telepon Langsung untuk Pengguna Baru

Ketika pengguna baru menghubungi menggunakan nama pengguna, Anda hanya akan menerima BSUID.

Anda tidak akan mendapatkan nomor telepon mereka secara default.

Anda masih dapat membalas dan melanjutkan percakapan menggunakan BSUID. Tetapi jika bisnis Anda membutuhkan nomor telepon (misalnya untuk OTP atau verifikasi), sekarang Anda harus secara eksplisit memintanya di dalam chat dan menunggu persetujuan pengguna.

Tantangan 2: Memetakan BSUID dengan Data Pelanggan yang Ada

Sebagian besar CRM saat ini dibangun berdasarkan nomor telepon.

• profil pelanggan
• riwayat chat
• pesanan
• segmentasi

Semua terikat pada nomor telepon sebagai kunci utama.

Sekarang dengan kehadiran BSUID, Anda perlu memutuskan:

• Apakah Anda menambahkan BSUID sebagai kolom baru?
• Atau membuat lapisan pemetaan terpisah antara nomor telepon dan BSUID?

Ini bukan hanya keputusan teknis, tetapi berdampak pada konsistensi data, logika kueri, dan kompleksitas sistem.

Tantangan 3: Mempertahankan Kelanjutan Percakapan Saat Pelanggan Beralih Antar Pengenal yang Berbeda

Dari sisi pengguna, tidak ada yang berubah. Ini tetap satu percakapan.

Tetapi dari sisi sistem Anda, segalanya bisa rusak.

Contoh:

• Interaksi pertama → Diidentifikasi via BSUID
• Selanjutnya → Pengguna membagikan nomor telepon

Jika sistem Anda tidak menghubungkan keduanya dengan benar, pengguna yang sama bisa diperlakukan sebagai dua pelanggan berbeda.

Konsekuensi:

• Catatan duplikat
• Riwayat chat yang terputus
• Pengalaman pelanggan yang buruk

Tantangan 4: Menangani Alur Verifikasi & OTP

BSUID tidak dapat digunakan untuk pesan autentikasi.

Jadi jika alur Anda bergantung pada:

• OTP
• Verifikasi login
• Penyatuan akun

Anda harus terlebih dahulu mengumpulkan nomor telepon pengguna.

Ini berarti alur saat ini mungkin perlu didesain ulang untuk:

• Secara eksplisit meminta persetujuan
• Mengambil nomor
• Menyimpan dan memetakannya dengan benar

Selanjutnya, mari kita lihat apa yang sebenarnya akan rusak jika tantangan ini tidak ditangani dengan baik.

Apa yang Akan Rusak (Jika Anda Mengabaikan Ini)

Inilah yang mulai rusak:

• Anda mungkin melewatkan percakapan
  Pengguna baru yang datang melalui username tidak akan terpetakan dengan benar di sistem Anda.
  

• Alur pesan rusak
  Pesan layanan dan alur CTWA (Click-to-WhatsApp Ads) mungkin tidak terpicu seperti yang diharapkan.
  

• Riwayat chat terputus
  Pengguna yang sama mungkin muncul sebagai beberapa identitas.
  

• Data CRM menjadi tidak dapat diandalkan
  Profil pelanggan mungkin tidak menyimpan atau memetakan data dengan benar.
  

• Pengguna duplikat bertambah
  Satu pengguna = beberapa catatan di seluruh nomor telepon dan BSUID.
  

• Otomatisasi berhenti bekerja
  Alur kerja yang terkait dengan nomor telepon tidak akan terpicu.
  

• Alur kerja end-to-end rusak
  Dari penangkapan lead hingga tindak lanjut, semuanya mulai berantakan.
  

• Tim penjualan kehilangan visibilitas
  Lead tidak dapat diidentifikasi atau dilacak dengan benar.
  

Inilah mengapa dampaknya lebih besar dari yang terlihat.
Ini bukan hanya masalah data, tetapi memengaruhi seluruh perjalanan pelanggan Anda.

Selanjutnya, mari kita lihat cara mengatasi ini dan menangani identifikasi pelanggan dengan benar.

Solusi Identifikasi Pelanggan

Skenario 1: Pelanggan Baru Memulai Kontak untuk Pertama Kalinya via Username (Hanya BSUID)

Ketika pelanggan baru memulai percakapan menggunakan username, sistem Anda mungkin hanya menerima BSUID.

Dalam kasus ini, BSUID menjadi titik awal profil pelanggan tersebut.

Berikut cara menanganinya:

• Model data Anda harus mendukung lebih dari satu identifikasi untuk pelanggan yang sama.
• CRM Anda harus mampu membuat profil pelanggan menggunakan BSUID.
• Sistem Anda harus mendukung pencarian dan identifikasi menggunakan BSUID.
• Jika bisnis membutuhkan nomor telepon (misalnya saat alamat pengiriman diperlukan atau kode verifikasi perlu dikirim), mintalah pada titik yang tepat dalam percakapan.
• Jika pengguna membagikannya, simpan nomor tersebut dan hubungkan kembali ke profil berbasis BSUID yang sama.

Skenario 2: Pelanggan yang Nomor Teleponnya Sudah Anda Miliki

Jika bisnis Anda sudah memiliki nomor telepon pelanggan, Anda dapat terus menggunakannya.

Bagian ini tidak berubah.

Bahkan jika pengguna mengaktifkan username, Anda masih bisa mengirim pesan menggunakan nomor telepon yang sudah Anda ketahui. Tapi jika pengguna yang sama nanti memulai percakapan menggunakan username, sistem Anda harus bisa menghubungkan BSUID yang baru dengan catatan berbasis nomor telepon yang sudah ada.

Berikut cara menanganinya:

• Model data Anda tetap harus mendukung beberapa identifikasi untuk satu pelanggan.
• Ketika BSUID muncul, hubungkan dengan catatan pelanggan yang sudah ada.
• Sistem Anda harus mendukung pencarian berdasarkan nomor telepon atau BSUID.
• Prioritaskan nomor telepon untuk pesan keluar, terutama untuk alur verifikasi atau autentikasi

Timeline & Rencana Aksi

WhatsApp meluncurkan ini secara bertahap, yang memberi Anda waktu untuk mempersiapkan, tetapi hanya jika Anda mulai lebih awal.

Timeline

• 31 Maret 2026 → BSUID akan mulai muncul di Webhook.
• Mei 2026 → Pengujian BSUID tersedia (Anda dapat mulai mengirim menggunakan BSUID).
• Juni 2026 → Orang di negara uji coba dapat mulai mengadopsi username. Peluncuran username dimulai.
• Sisa tahun 2026 → Orang di seluruh dunia dapat mulai mengadopsi username.

Yang Harus Dilakukan Bisnis

1. Fase Persiapan (Sekarang)

• Pelajari dan pahami mekanisme BSUID dan detail teknisnya.
• Identifikasi di mana nomor telepon digunakan dalam alur kerja.
• Tentukan bagaimana Anda akan menangani nomor telepon vs BSUID.
• Evaluasi cakupan dan beban kerja yang diperlukan untuk memodifikasi sistem yang ada.
• Kembangkan rencana untuk penyesuaian basis data dan kompatibilitas API.
• Mulai penelitian teknis dan perancangan solusi.
• Sinkronkan tim internal (produk, teknik, pemasaran) dan rencanakan strategi nama pengguna bisnis Anda.

2. Fase Implementasi (Sebelum Peluncuran Fitur)

• Perbarui CRM dan basis data untuk mendukung BSUID.
• Selesaikan transformasi kompatibilitas lapisan integrasi API.
• Implementasikan proses permintaan otorisasi nomor telepon.
• Pastikan pesan kode verifikasi dikirim menggunakan nomor telepon.
• Selesaikan verifikasi lingkungan pengujian.
• Siapkan rencana peluncuran bertahap (gray release).

3. Pengujian

• Lakukan pengujian end-to-end dengan skenario kasus nyata.
• Validasi:
  • Pembuatan pengguna berbasis BSUID
  • Alur pengumpulan nomor telepon
  • ,pemetaan antara pengidentifikasi
  • Alur pesan dan otomatisasi

4. Fase Go-Live (Setelah Fitur Diluncurkan)

• Lakukan peluncuran secara bertahap (jangan mengalihkan semuanya sekaligus).
• Pantau kesehatan operasional sistem, seperti akurasi pembuatan profil, tingkat keberhasilan OTP, dan kinerja alur kerja.
• Tanggapi umpan balik pengguna dan tangani anomali.
• Optimalkan logika identifikasi pelanggan.
• Terus tingkatkan akurasi asosiasi data.
• Pantau tingkat otorisasi nomor telepon, dan optimalkan waktu serta pesan yang digunakan untuk permintaan.
• Klaim dan siapkan nama pengguna bisnis Anda.

Daftar Periksa Pra-Peluncuran

Sebelum meluncurkan, pastikan:

• BSUID terintegrasi di seluruh sistem Anda.
• Anda masih bisa mengirim dan menerima pesan tanpa nomor telepon.
• Semua alur kerja diuji untuk kedua identifikasi.
• Chatbot dan perjalanan dapat meminta nomor telepon jika diperlukan.
• Alur kerja yang ada diaudit dan diperbarui untuk menghindari kerusakan.

Prioritas

• Prioritas Tinggi → Penyesuaian struktur CRM dan basis data, modifikasi kompatibilitas API, penyesuaian logika pengiriman kode verifikasi (berdampak pada fungsionalitas inti).
• Prioritas Menengah → Adaptasi sistem dukungan pelanggan, pembaruan sistem pemasaran (berdampak pada efisiensi bisnis).
• Prioritas Rendah → Optimasi pelaporan data, pembersihan data historis (dapat disempurnakan secara bertahap).

Ini bukan sesuatu yang bisa diperbaiki di menit terakhir.
Semakin cepat Anda beradaptasi, semakin lancar transisi Anda.

Tempat Menemukan Lebih Banyak Sumber Daya

Jika Anda menerapkan ini, jangan mengandalkan asumsi, gunakan dokumen resmi.

Berikut adalah sumber daya utama untuk memulai:

• Panduan BSUID
  https://docs.ycloud.com/reference/bsuid
  → Mencakup cara kerja BSUID, format, dan penggunaan dalam API
  
  

• Pembaruan Webhook (Kolom BSUID)
  https://docs.ycloud.com/reference/webhook-updates-bsuid
  → Membantu Anda memahami bagaimana BSUID muncul dalam payload webhook dan perubahan dalam integrasi
  
  

• Dokumen Pengembang Meta (BSUID)
  https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids
  → Referensi resmi untuk pengenalan dan penggunaan BSUID di seluruh API WhatsApp
  
  

Ini harus menjadi referensi utama Anda saat memperbarui sistem.

Menyimpulkan!

Glosarium

Berikut adalah istilah-istilah kunci yang akan Anda lihat di webhooks dan API, dijelaskan dengan istilah sederhana:

• contacts (array baru)
  Daftar pengguna yang terlibat dalam pesan. Anggap ini sebagai "bagian info pelanggan" di webhook.
  

• profile
  Detail dasar tentang pengguna di dalam kontak.
  

• username
  Atribut baru. Nama pengguna WhatsApp pengguna (jika mereka mengaktifkannya).
  Jika pengguna belum mengatur nama pengguna, bidang ini tidak akan muncul.
  
  

• wa_id
  Atribut baru. Nomor telepon pengguna.
  Jika nomor telepon tersedia, Anda akan melihatnya di sini.
  Jika pengguna menggunakan nama pengguna dan nomor tidak dibagikan, ini mungkin tidak ada.
  
  
  

• user_id (BSUID)
  Atribut baru. Bidang paling penting ke depannya.
  Ini adalah BSUID, ID unik yang mewakili pengguna untuk bisnis Anda.
  Ini akan selalu ada dan harus digunakan untuk mengidentifikasi pengguna ketika nomor telepon tidak tersedia.
  
  
  

• parent_user_id
  BSUID tingkat tinggi yang dapat bekerja di beberapa portofolio bisnis (jika diaktifkan).
  Sebagian besar bisnis tidak akan menggunakan ini kecuali mereka mengelola beberapa portofolio.
  
  

Cara sederhana untuk memahami ini:

• wa_id → Nomor telepon (mungkin tersedia atau tidak)
• user_id → BSUID (selalu tersedia, standar baru)
• username → Apa yang ditampilkan pengguna secara publik