Migrasi BSUID WhatsApp: Checklist Webhook, CRM, dan Identitas Pelanggan
Business-Scoped User ID atau BSUID adalah pengenal backend yang membantu bisnis mengenali pengguna WhatsApp ketika nomor telepon tidak tersedia dengan cara yang sama seperti sebelumnya. Bagi tim IT, perubahan terbesarnya bukan tampilan username. Perubahan terbesarnya adalah hilangnya asumsi bahwa setiap event WhatsApp selalu membawa nomor telepon yang dapat dijadikan primary key pelanggan.
Meta menjelaskan bahwa username dan BSUID mengubah pemrosesan webhook serta permintaan API pada WhatsApp Business Platform. Karena rollout berlangsung bertahap, integrasi perlu mampu menangani masa transisi: sebagian percakapan masih membawa nomor, sebagian membawa BSUID, dan sebagian dapat membawa keduanya sesuai konteks.
Artikel ini membahas kesiapan teknis. Untuk keputusan brand dan reservasi, lihat cara reservasi username WhatsApp Business.
Mengapa desain berbasis nomor telepon perlu ditinjau
Banyak integrasi lama menyimpan nomor telepon di berbagai tempat sekaligus:
- primary key profil pelanggan;
- foreign key pada tiket dan histori chat;
- kunci deduplikasi;
- input routing;
- lookup pesanan;
- target pesan outbound;
- identifier pada analitik.
Jika nomor tidak tersedia pada event tertentu, kegagalan dapat muncul jauh dari webhook: profil ganda, histori terputus, automasi berhenti, atau pesan dikirim ke record yang salah. Migrasi harus memetakan seluruh ketergantungan, bukan hanya menambahkan satu kolom baru.
Model data yang lebih tahan perubahan
Pisahkan tiga konsep berikut:
| Konsep | Contoh | Peran |
|---|---|---|
| Customer ID internal | cus_10482 |
Identitas utama di sistem bisnis |
| Channel identity | BSUID, nomor, username | Identitas pelanggan pada kanal tertentu |
| Contact point | Nomor telepon atau email | Data kontak yang dapat berubah dan memiliki consent |
Customer ID internal sebaiknya tidak bergantung langsung pada nomor telepon. Buat tabel atau layer pemetaan yang dapat menyimpan lebih dari satu channel identity per pelanggan, lengkap dengan sumber, status verifikasi, dan waktu terakhir terlihat.
Contoh konseptual:
customer
- customer_id
- name
- created_at
channel_identity
- identity_id
- customer_id
- channel
- identifier_type
- identifier_value
- business_scope
- first_seen_at
- last_seen_at
- status
contact_point
- contact_id
- customer_id
- type
- value
- consent_status
- verified_at
Struktur aktual harus mengikuti keamanan dan kebijakan data organisasi Anda.
Checklist perubahan webhook
Parsing
- Jangan mewajibkan
wa_idatau nomor pada setiap event. - Terima identifier baru tanpa memotong panjang atau karakter.
- Simpan payload mentah secara aman untuk debugging sesuai kebijakan retensi.
- Perlakukan field baru sebagai kompatibilitas tambahan, bukan alasan mengabaikan event.
Idempotency dan deduplikasi
- Gunakan message ID atau event ID yang sesuai, bukan hanya kombinasi nomor dan waktu.
- Pastikan retry tidak membuat tiket atau profil baru.
- Uji event yang datang tidak berurutan.
Error handling
- Kirim event gagal ke dead-letter queue atau mekanisme serupa.
- Buat alarm ketika persentase event tanpa nomor meningkat.
- Jangan membuang pesan hanya karena lookup pelanggan gagal.
Observability
- Catat jenis identifier yang diterima.
- Pantau keberhasilan mapping ke customer ID.
- Pisahkan error parsing, error lookup, dan error downstream.
- Siapkan dashboard selama rollout.
Migrasi CRM tanpa memecah histori
Mulailah dengan membuat crosswalk antara record lama dan identifier baru saat keduanya tersedia secara sah. Jangan langsung mengganti semua primary key. Jalankan fase dual-read atau dual-write sampai tim yakin bahwa mapping stabil.
Urutan aman yang dapat dipertimbangkan:
- tambahkan dukungan penyimpanan BSUID;
- baca BSUID dari event dan tautkan ke profil yang dapat diverifikasi;
- gunakan internal customer ID untuk histori dan tiket;
- perbarui lookup agar dapat menerima nomor atau BSUID;
- uji outbound pada identifier yang didukung;
- migrasikan automasi dan laporan;
- hentikan asumsi wajib nomor setelah metrik stabil.
Jika sistem memakai beberapa business portfolio, pahami ruang lingkup identifier. Jangan mengasumsikan satu BSUID dapat digunakan untuk menyatukan identitas lintas seluruh entitas tanpa aturan dan dasar data yang jelas.
Kapan nomor telepon masih dibutuhkan?
Nomor dapat tetap dibutuhkan untuk autentikasi, panggilan, pengiriman, atau proses lain. Bedakan antara “dibutuhkan untuk proses” dan “dikumpulkan karena sistem lama mewajibkannya”.
Jika nomor memang diperlukan:
- jelaskan tujuan permintaan;
- minta pada tahap yang relevan;
- gunakan mekanisme contact info yang disediakan platform jika sesuai;
- simpan status consent dan verifikasi;
- jangan menganggap nomor yang diketik di chat otomatis valid.
Dampak pada automasi dan chatbot
Audit setiap alur yang menggunakan nomor sebagai variabel wajib:
- greeting berdasarkan pelanggan lama;
- pencarian pesanan;
- routing VIP;
- verifikasi eligibility;
- pembuatan tiket;
- atribusi kampanye;
- pesan proaktif;
- penyatuan profil lintas kanal.
Untuk pertanyaan umum, alur seharusnya tetap dapat membantu tanpa meminta nomor. Untuk proses yang benar-benar memerlukan contact point, jelaskan alasannya dan sediakan fallback manusia.
Strategi pengujian
Buat test matrix, bukan satu happy path:
| Skenario | Hasil yang diharapkan |
|---|---|
| Event dengan nomor dan BSUID | Profil dipetakan tanpa duplikasi |
| Event hanya dengan BSUID | Pesan masuk dan tiket tetap dibuat |
| BSUID belum dikenal | Profil sementara dibuat atau masuk antrean resolusi |
| Pelanggan membagikan nomor kemudian | Contact point ditambahkan tanpa mengganti histori |
| Event duplikat | Tidak membuat tiket ganda |
| Lookup CRM gagal | Percakapan tetap dapat ditangani agen |
| Identifier berubah | Mapping diperbarui dan histori tetap terhubung |
Lakukan pengujian pada staging dengan payload yang telah dianonimkan. Hindari memindahkan data pelanggan produksi ke lingkungan pengujian tanpa kontrol.
Rollout dan rollback
Gunakan feature flag untuk parser dan routing baru. Mulai dari persentase trafik kecil atau satu nomor bisnis. Siapkan metrik pembanding: event processed, mapping success, duplicate profile rate, ticket creation success, dan outbound delivery.
Rollback tidak boleh berarti kehilangan pesan. Jika mapping baru bermasalah, sistem harus tetap menyimpan event dan memungkinkan agen memproses percakapan sementara tim memperbaiki hubungan identitas.
Klaim produk yang harus diverifikasi
Versi lama artikel Maxchat menyebut dukungan auto-mapping dan pengelolaan username secara langsung. Klaim tersebut tidak boleh diterbitkan kembali sebelum Product/Engineering mengonfirmasi implementasi, versi, batasan, dan ketersediaannya. Draft ini sengaja memisahkan praktik arsitektur umum dari kemampuan produk Maxchat.
Untuk membahas kesiapan integrasi WhatsApp Business Platform Anda, hubungi tim Maxchat.
Pertanyaan umum
Apakah BSUID sama dengan username?
Tidak. Username adalah identitas yang dapat dikenali pengguna. BSUID adalah identifier backend untuk kebutuhan sistem bisnis.
Apakah nomor telepon tidak akan pernah tersedia?
Ketersediaan nomor bergantung pada interaksi, pilihan pengguna, serta mekanisme platform. Integrasi sebaiknya tidak menganggap nomor selalu ada.
Apakah BSUID sebaiknya menjadi primary key CRM?
Lebih aman menggunakan customer ID internal sebagai identitas utama, lalu menyimpan BSUID sebagai channel identity yang memiliki scope dan lifecycle sendiri.
Apa indikator migrasi berhasil?
Tidak ada pesan yang hilang, histori tetap terhubung, profil ganda terkendali, automasi tetap berjalan, dan error dapat ditelusuri.
Sumber
- Meta for Developers, WhatsApp Usernames
- WhatsApp Help Center, About sharing your phone number with businesses
- WhatsApp Help Center, How to reserve and manage usernames on WhatsApp Business Platform