Maxchat

Migrasi BSUID WhatsApp: Checklist Webhook, CRM, dan Identitas Pelanggan

12 Nov 2026

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_id atau 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:

  1. tambahkan dukungan penyimpanan BSUID;
  2. baca BSUID dari event dan tautkan ke profil yang dapat diverifikasi;
  3. gunakan internal customer ID untuk histori dan tiket;
  4. perbarui lookup agar dapat menerima nomor atau BSUID;
  5. uji outbound pada identifier yang didukung;
  6. migrasikan automasi dan laporan;
  7. 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

Tag

Mantap! Kamu telah berhasil berlangganan.
Mantap! Selanjutnya, selesaikan pembayaran untuk akses penuh.
Selamat datang kembali! Kamu telah berhasil masuk.
Sukses! Akun kamu telah aktif, sekarang kamu bisa mengakses semua konten.