Nama pengguna WhatsApp dan BSUID: apa yang berubah bagi OTP, CRM, dan webhook

ID pengguna berbasis bisnis (BSUID) adalah pengenal yang kini disertakan Meta dalam setiap webhook WhatsApp sehingga bisnis dapat mengirim pesan ke pengguna tanpa perlu mengetahui nomor telepon mereka. Hal ini dilakukan karena WhatsApp memperkenalkan nama pengguna: setelah pengguna mengaktifkannya, bisnis yang sudah lama tidak berhubungan mungkin tidak lagi menerima nomor telepon tersebut. Panduan dari tim engineering BroadNet ini menjelaskan formatnya, lini masa, apa yang masih memerlukan nomor telepon, serta cara melakukan migrasi pada webhook, data CRM, dan alur OTP.

Poin-poin utama

• BSUID telah muncul dalam webhook WhatsApp sejak awal April 2026, untuk setiap pengguna, baik mereka menggunakan nama pengguna maupun tidak.
• Sebuah BSUID terlihat seperti US.13491208655302741918: kode negara ISO 3166 alpha-2, sebuah titik, lalu hingga 128 karakter alfanumerik.
• ID ini unik untuk setiap pasangan portofolio bisnis dan pengguna, dan akan dibuat ulang jika pengguna mengubah nomor telepon mereka.
• Sejak Juli 2026, Anda dapat mengirim pesan ke BSUID, kecuali untuk templat autentikasi one-tap, zero-tap, dan copy-code, yang masih memerlukan nomor telepon.
• Meta menyatakan bahwa mitra dan bisnis yang terintegrasi secara langsung harus mendukung BSUID agar tidak kehilangan kemampuan memproses pesan dari pengguna yang memakai nama pengguna.
• Gunakan nomor telepon E.164 yang terverifikasi sebagai jangkar identitas untuk OTP, fallback SMS, dan pemeriksaan penipuan. Perlakukan BSUID sebagai kunci saluran WhatsApp.

Apa itu ID pengguna berbasis bisnis?

Meta mendefinisikan BSUID sebagai "pengenal pengguna unik yang dapat digunakan untuk mengirim pesan ke pengguna WhatsApp saat Anda tidak mengetahui nomor telepon mereka" (Meta, business-scoped user IDs). Formatnya adalah negara pengguna sebagai kode ISO 3166 alpha-2, sebuah titik, dan hingga 128 karakter alfanumerik, contohnya US.13491208655302741918.

Tiga properti penting untuk desain sistem:

• Cakupan. Sebuah BSUID bersifat unik untuk satu portofolio bisnis dan satu pengguna. Orang yang sama memiliki BSUID yang berbeda untuk setiap portofolio bisnis yang mereka hubungi, sehingga Anda tidak dapat menggunakannya untuk mencocokkan pelanggan di berbagai portofolio yang tidak terkait.
• Stabilitas. ID ini dibuat ulang saat pengguna mengubah nomor telepon mereka. Meta akan mengirimkan webhook pesan sistem dengan tipe user_changed_user_id, dan webhook user_id_update terpisah, saat hal itu terjadi.
• BSUID Induk. Bisnis yang dikelola dengan beberapa portofolio dapat meminta kontak Meta mereka untuk mendaftar dalam BSUID induk, yang berisi ENT (contohnya US.ENT.11815799212886844830) dan berlaku di seluruh portofolio yang terdaftar.

Mengapa WhatsApp memperkenalkan nama pengguna?

Untuk privasi. Meta mengumumkan pada 29 Juni 2026 bahwa orang dapat memesan username untuk digunakan "akhir tahun ini", dan ketika pengguna telah mengaktifkannya, orang atau bisnis yang mereka kirimi pesan untuk pertama kalinya tidak akan lagi melihat nomor telepon mereka (Tentang Meta). Dokumentasi pengembang Meta menyatakan bahwa username akan diluncurkan secara bertahap pada tahun 2026.

Bisnis juga dapat memiliki username. Mulai 29 Juni 2026, sebuah bisnis dapat mengklaim username yang telah dipesan WhatsApp untuk mereka melalui WhatsApp Manager, Meta Business Suite, atau Username API, dan username yang telah disetujui akan menjadi aktif saat fitur tersebut diluncurkan. Username bisnis tidak menyembunyikan nomor telepon bisnis.

Bagaimana lini masanya?

Apakah Anda akan kehilangan nomor telepon pelanggan?

Terkadang. BSUID muncul di semua webhook pesan. Nomor telepon (wa_id, dan 'from' pada pesan masuk) hanya disertakan jika setidaknya salah satu hal berikut benar, menurut Meta:

• Anda mengirim pesan atau menelepon nomor telepon pengguna dalam waktu 30 hari sebelum webhook dipicu;
• Anda menerima pesan atau panggilan dari nomor telepon pengguna dalam waktu 30 hari tersebut; atau
• Pengguna ada di buku kontak Anda.

Tinjauan balik 30 hari dievaluasi per nomor telepon bisnis, sehingga pelanggan yang dikenal oleh lini penjualan Anda mungkin tidak dikenal oleh lini dukungan Anda. Buku kontak adalah fitur yang dihosting oleh Meta yang menyimpan nomor telepon dan BSUID setelah interaksi pertama, sehingga webhook berikutnya dapat terus membawa nomor tersebut bahkan setelah pengguna menggunakan nama pengguna. Fitur ini aktif secara default dan dapat dinonaktifkan di Meta Business Suite di bawah pengaturan Bisnis, info Bisnis. Biarkan tetap aktif kecuali Anda memiliki alasan untuk menonaktifkannya.

Apa yang masih membutuhkan nomor telepon?

Meta menyatakan secara eksplisit: BSUID "dapat digunakan untuk mengirim jenis pesan apa pun kecuali templat autentikasi satu ketukan, nol ketukan, dan salin kode, yang memerlukan nomor telepon pengguna". Di luar WhatsApp, apa pun yang berjalan di jaringan seluler juga memerlukan nomor tersebut.

Seperti apa tampilan webhook sebelum dan sesudahnya?

Sebelum BSUID, blok kontak dalam webhook pesan menyertakan nomor telepon dalam wa_id, dan sebagian besar integrasi menggunakannya sebagai kunci pelanggan. Contoh objek kontak baru dari Meta menambahkan nama pengguna, BSUID dan, jika diaktifkan, induk BSUID; wa_id hanya tersedia jika nomor tersebut dapat dibagikan:

1"contacts": [
2  {
3    "profile": {
4      "name": "<USER_DISPLAY_NAME>",
5      "username": "<USERNAME>"
6    },
7    "wa_id": "<USER_PHONE_NUMBER>",
8    "user_id": "<BSUID>",
9    "parent_user_id": "<PARENT_BSUID>"
10  }
11]

Pesan masuk juga menyertakan from_user_id (dan from_parent_user_id jika diaktifkan), dan webhook status menyertakan recipient_user_id, yang menurut Meta selalu diatur ke BSUID pengguna. Untuk mengirim, masukkan BSUID ke dalam parameter penerima yang baru. Anda dapat mengatur parameter to (nomor telepon), parameter recipient (BSUID), atau keduanya; jika keduanya ada, nomor telepon akan diprioritaskan:

1{
2  "messaging_product": "whatsapp",
3  "recipient_type": "individual",
4  "recipient": "<BSUID>",
5  "type": "text",
6  "text": {
7    "body": "<BODY_TEXT>"
8  }
9}

Respons pengiriman kemudian menyertakan user_id dalam array kontaknya, dan wa_id menjadi opsional. Jika parser Anda mengasumsikan wa_id selalu ada, maka akan terjadi kegagalan pada pengguna pertama yang menggunakan nama pengguna. Anda dapat menempelkan payload asli ke dalam webhook payload inspector kami untuk memeriksa field mana yang sebenarnya diterima oleh integrasi Anda.

Apa yang tidak lagi berfungsi untuk OTP?

Templat autentikasi dengan tombol one-tap, zero-tap, atau copy-code tidak dapat dikirim ke BSUID. Jika pengguna yang menggunakan nama pengguna menghubungi Anda melalui WhatsApp dan Anda tidak memiliki nomor telepon mereka, Anda tidak dapat mengirimkan WhatsApp OTP jenis tersebut. Hal ini memiliki dua konsekuensi bagi alur verifikasi:

• Kumpulkan dan verifikasi nomor telepon saat pendaftaran, dalam format E.164, dan simpan sebagai alamat verifikasi akun. Jangan mengandalkan webhook WhatsApp untuk memberikannya kepada Anda di kemudian hari. Lihat apa itu E.164.
• Pertahankan saluran yang bekerja pada nomor itu sendiri. SMS OTP, OTP suara, dan pemeriksaan jaringan senyap semuanya berjalan pada nomor telepon, itulah sebabnya desain multichannel dengan fallback otomatis tetap bertahan tanpa perubahan setelah perubahan ini. Panduan OTP multichannel kami dan produk BroadNet OTP mencakup pola tersebut.

Apa yang tidak lagi berfungsi pada CRM dan deduplikasi pelanggan?

Sebagian besar CRM menggunakan nomor telepon sebagai kunci kontak WhatsApp karena SMS, suara, dan WhatsApp dulunya berbagi data tersebut. Setelah adanya nama pengguna, kontak masuk baru mungkin tiba hanya dengan BSUID. Jika Anda membuat rekaman CRM baru untuk hal tersebut, Anda akan secara bertahap menduplikasi pelanggan. Empat aturan berikut menjaga data tetap bersih:

1. 1Modelkan BSUID sebagai identitas saluran, bukan sebagai ID pelanggan. Satu pelanggan dapat memiliki beberapa BSUID (satu untuk setiap portofolio bisnis) dan satu yang baru setelah perubahan nomor.
2. 2Simpan tabel pemetaan BSUID, portofolio, nomor telepon jika diketahui, waktu pertama kali terlihat dan terakhir kali terlihat, serta perbarui tabel tersebut pada setiap webhook, termasuk user_id_update.
3. 3Lakukan penggabungan berdasarkan bukti, bukan berdasarkan tebakan: nomor telepon yang terverifikasi, login, atau referensi pesanan yang diberikan pelanggan dalam chat.
4. 4Jangan pernah menganggap tidak adanya wa_id sebagai pelanggan baru. Itu hanya berarti nomor tersebut tidak dapat dibagikan pada peristiwa tersebut.

Bagaimana cara Anda melakukan migrasi? Daftar periksa langkah demi langkah

1. 1Perbarui parser webhook untuk membaca user_id, from_user_id, recipient_user_id, dan nama pengguna, serta memperlakukan wa_id dan 'from' sebagai opsional.
2. 2Tambahkan kolom BSUID (dan BSUID induk jika Anda adalah bisnis terkelola) di mana pun Anda menyimpan kontak WhatsApp.
3. 3Backfill: untuk setiap peristiwa masuk sejak awal April 2026, hubungkan BSUID ke nomor telepon yang sudah Anda miliki.
4. 4Tangani pesan sistem user_changed_user_id dan webhook user_id_update dengan menghubungkan kembali BSUID yang baru ke pelanggan.
5. 5Tambahkan parameter penerima ke jalur pengiriman Anda, dan gunakan parameter tersebut sebagai cadangan saat Anda tidak memiliki nomor telepon.
6. 6Kirim OTP ke nomor telepon, jangan pernah ke BSUID, dan gunakan SMS atau suara sebagai saluran cadangan.
7. 7Reservasi nama pengguna bisnis Anda di WhatsApp Manager, Meta Business Suite, atau melalui Username API.
8. 8Lakukan pengujian dengan akun yang telah mengaktifkan nama pengguna sebelum nama pengguna tersebut menjangkau pelanggan Anda.

Jika BroadNet adalah penyedia WhatsApp Anda, minta akses uji coba dan konfirmasikan bagaimana kolom BSUID muncul dalam webhook untuk akun Anda sebelum Anda mengubah kode produksi. Pusat pengembang dan halaman WhatsApp Business API kami menyediakan detail lengkapnya, dan perutean omnichannel menangani cadangan SMS yang kini menjadi sandaran alur autentikasi.

Pertanyaan yang sering diajukan

Apa itu WhatsApp BSUID?

ID pengguna dalam lingkup bisnis: sebuah pengenal yang Meta berikan kepada setiap pengguna WhatsApp untuk setiap portofolio bisnis, sehingga bisnis dapat mengirim pesan kepada pengguna tanpa perlu mengetahui nomor telepon mereka. ID ini muncul sebagai user_id dalam webhook.

Seperti apa tampilan BSUID?

Sebuah kode negara alpha-2 ISO 3166, tanda titik, lalu hingga 128 karakter alfanumerik, contohnya US.13491208655302741918. BSUID induk untuk bisnis yang dikelola mencakup ENT, contohnya US.ENT.11815799212886844830.

Apakah saya akan kehilangan nomor telepon pelanggan saat mereka menggunakan username?

Hanya pada beberapa webhook. Nomor tersebut tetap disertakan jika Anda telah bertukar pesan atau melakukan panggilan dengan nomor tersebut dalam 30 hari terakhir, atau jika pengguna tersebut ada dalam buku kontak Anda. Jika tidak, wa_id akan dihilangkan dan Anda hanya akan menerima BSUID.

Dapatkah saya mengirim pesan ke BSUID?

Ya, sejak Juli 2026, dengan menggunakan parameter penerima (recipient) pada send API. Semua jenis pesan dapat digunakan kecuali templat autentikasi one-tap, zero-tap, dan copy-code, yang memerlukan nomor telepon pengguna.

Bisakah saya mengirim templat autentikasi (OTP) ke BSUID?

Tidak. Templat autentikasi one-tap, zero-tap, dan copy-code memerlukan nomor telepon. Pastikan untuk memiliki nomor telepon terverifikasi untuk setiap akun dan gunakan SMS atau voice OTP sebagai cadangan.

Apakah BSUID dapat digunakan di seluruh portofolio bisnis?

Tidak. Sebuah BSUID bersifat unik untuk satu pasangan portofolio bisnis dan pengguna. Bisnis yang dikelola dapat bertanya kepada Meta mengenai BSUID induk, yang dapat bekerja di seluruh portofolio yang terdaftar bersama.

Apakah BSUID pernah berubah?

Ya. BSUID akan dibuat ulang saat pengguna mengubah nomor telepon mereka, dan Meta akan memberikan sinyal melalui pesan sistem user_changed_user_id dan webhook user_id_update.

Bagaimana cara mendaftarkan nama pengguna bisnis saya?

Sejak 29 Juni 2026, melalui WhatsApp Manager, Meta Business Suite atau Username API. Username yang telah disetujui akan menjadi aktif saat fitur username diluncurkan, dan fitur ini tidak menyembunyikan nomor telepon bisnis Anda.

Sumber

• Meta for Developers, Business-scoped user IDs (format, lini masa, field webhook, buku kontak, parameter pengiriman, pengecualian templat autentikasi), diakses pada 26 September 2026.
• About Meta, Saatnya mendaftarkan username WhatsApp Anda, 29 Juni 2026, diakses pada 26 September 2026.