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 OTP atau pesan autentikasi kode salin hanya dengan BSUID. Jika alur itu 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 ke 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 diidentifikasi 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 bekerja bahkan ketika nomor telepon hilang
• Ini terkait dengan portofolio bisnis tertentu

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

Format BSUID (Seperti Apa Bentuknya)

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, seluruh nilai harus digunakan persis seperti aslinya.
Perubahan atau pemotongan apa pun akan menyebabkan permintaan gagal.

Aturan Penting yang Harus Diketahui

• BSUID bersifat unik untuk setiap pasangan portofolio bisnis-pengguna (portofolio bisnis sebelumnya dikenal sebagai Business Managers)
• BSUID akan dihasilkan ulang jika pengguna mengubah nomor teleponnya (yang akan memicu webhook pesan status sistem)
• BSUID terbatas pada portofolio bisnis tertentu (tidak dapat digunakan di berbagai portofolio)
• BSUID muncul di webhook bahkan jika pengguna belum 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 akan dapat terus menggunakannya untuk mengirim pesan ke 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 masih akan menjadi bagian dari cara kerja WhatsApp.
• Jika pengguna belum mengadopsi nama pengguna, bisnis akan menerima baik nomor telepon mereka maupun 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 sebagaimana adanya.

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

Tantangan yang Dihadapi Bisnis

Tantangan 1: Ketidakmampuan untuk Langsung Mendapatkan Nomor Telepon Pengguna Baru

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

Anda tidak akan mendapatkan nomor telepon mereka secara default.

Anda masih bisa membalas dan melanjutkan percakapan menggunakan BSUID. Tetapi jika bisnis Anda memerlukan 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

Semuanya terikat pada nomor telepon sebagai kunci utama.

Sekarang dengan kehadiran BSUID, Anda perlu memutuskan:

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

Ini bukan hanya keputusan teknis, tetapi juga memengaruhi konsistensi data, logika query, dan kompleksitas sistem.

Tantangan 3: Menjaga Kesinambungan Percakapan Ketika Pelanggan Beralih Antar Pengidentifikasi Berbeda

Dari sisi pengguna, tidak ada yang berubah. Ini masih 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 dapat diperlakukan sebagai dua pelanggan berbeda.

Konsekuensi:

• Rekaman duplikat
• Riwayat chat yang rusak
• 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 Anda 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 bermasalah:

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

• Alur pesan terganggu
  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 andal
  Profil pelanggan mungkin tidak menyimpan atau memetakan data dengan benar.
  

• Pengguna duplikat meningkat
  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 terganggu
  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 yang Memulai Kontak untuk Pertama Kali 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, ketika 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 dapat mengirim pesan menggunakan nomor telepon yang sudah diketahui. Tetapi jika pengguna yang sama nantinya memulai percakapan menggunakan username, sistem Anda harus dapat menghubungkan BSUID yang baru dengan catatan berbasis nomor telepon yang sudah ada.

Berikut cara menanganinya:

• Model data Anda tetap harus mendukung banyak 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 memulai 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-orang di negara uji coba dapat mulai mengadopsi username. Peluncuran username dimulai.
• Sisa 2026 → Orang-orang di seluruh dunia dapat mulai mengadopsi username.

Yang Harus Dilakukan Bisnis

1. Fase Persiapan (Sekarang)

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

2. Fase Implementasi (Sebelum Peluncuran Fitur)

• Perbarui CRM dan database 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. Uji

• Lakukan pengujian end-to-end dengan skenario kasus nyata.
• Validasi:
  • Pembuatan pengguna berbasis BSUID
  • Alur pengumpulan nomor telepon
  • Pemetaan antar identifier
  • Alur pesan dan otomatisasi

4. Fase Go-Live (Setelah Fitur Diluncurkan)

• Lakukan peluncuran secara bertahap (jangan mengganti semua 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 go live, pastikan:

• BSUID telah terintegrasi di seluruh sistem Anda.
• Anda masih dapat mengirim dan menerima pesan tanpa nomor telepon.
• Semua alur kerja telah diuji untuk kedua jenis pengenal.
• Chatbot dan journey dapat meminta nomor telepon saat diperlukan.
• Alur kerja yang ada telah diaudit dan diperbarui untuk menghindari masalah.

Prioritas

• Prioritas Tinggi → Penyesuaian struktur CRM dan database, 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.

Temukan Sumber Daya Tambahan

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

Berikut adalah sumber daya utama untuk memulai:

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

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

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

Ini harus menjadi referensi utama Anda saat memperbarui sistem.

Penutup!

Glosarium

Berikut istilah-istilah kunci yang akan Anda temui di webhook 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 berbagai portofolio bisnis (jika diaktifkan).
  Sebagian besar bisnis tidak akan menggunakan ini kecuali mereka mengelola beberapa portofolio.
  
  

Cara sederhana untuk memahaminya:

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