Business-scoped user ID

Mengapa kontak tiba tanpa nomor telepon

Seperti apa bentuk BSUID

{
  "from": {
    "bsuid": "US.13491208655302741918",
    "username": "alexr",
    "display_name": "Alex Rivera"
  }
}

• Kirim seluruh nilai, tanpa diubah. Meta menolak BSUID yang dimodifikasi, jadi tidak ada bagian yang boleh dihilangkan: kode negara, titik, dan setiap karakter identifier harus dikirim bersama. Bird memvalidasi formatnya sebelum menerima pengiriman, dan kode negara harus huruf kapital serta merupakan kode ISO 3166 alpha-2 yang valid; awalan huruf kecil atau tidak dikenal akan ditolak, bukan dikoreksi. Batas 128 karakter berlaku untuk identifier setelah kode negara, dan setelah segmen ENT. pada parent BSUID.
• BSUID dicakupkan ke portofolio bisnis. Nomor telepon bisnis mana pun dalam portofolio yang sama dapat mengirim pesan ke BSUID tersebut; nomor di portofolio lain tidak bisa, dan pengiriman akan gagal.
• BSUID tidak permanen. Meta mendokumentasikan bahwa BSUID kontak dibuat ulang ketika mereka mengganti nomor telepon, sehingga BSUID mengidentifikasi mitra percakapan, bukan berfungsi sebagai kunci pelanggan permanen milik Anda.

Bagaimana percakapan biasanya berlangsung

1. Kontak mengirim pesan kepada Anda. Pesan masuk membawa from.bsuid, dan from.phone_number bisa saja tidak ada. Pesan tersebut membuka jendela layanan pelanggan, sehingga Anda dapat membalas secara bebas selama 24 jam berikutnya.
2. Anda meminta nomor telepon. Kirim permintaan info kontak, tombol tunggal yang memungkinkan kontak membagikan nomor telepon. Permintaan yang sama dapat dikirim melalui template lewat tombol request_contact_info, yang menjangkau kontak yang jendelanya sudah tertutup.
3. Kontak mengetuk tombol. Nomor yang dibagikan tiba sebagai kartu kontak masuk dengan origin bernilai contact_request dan nomor telepon di phone_numbers. Kartu kontak yang dibagikan bisa mendeskripsikan orang atau nomor lain. Simpan informasi ini terpisah dari identitas WhatsApp pengirim; gunakan identitas yang benar-benar tercantum pada pesan berikutnya daripada menimpa catatan pelanggan hanya dari kartu tersebut.

Mengirim ke BSUID

{
  "to": "US.13491208655302741918",
  "from": "+13124495648",
  "text": { "body": "Your order shipped." }
}

• from harus berada dalam portofolio tempat BSUID dicakupkan. Ini adalah persyaratan portofolio yang sama yang diterapkan Meta, dan ketidakcocokan akan gagal di WhatsApp, bukan saat penerimaan.
• Template kode verifikasi sekali pakai memerlukan nomor telepon. Template yang dikelola Bird dalam kategori authentication, atau yang membawa tombol kode verifikasi sekali pakai, ditolak saat penerimaan dengan 422 E15014 WhatsAppRecipientNotSupportedForTemplate. Template yang dibuat workspace Anda tidak diperiksa saat penerimaan: Meta mewajibkan nomor telepon untuk template autentikasi one-tap, zero-tap, dan copy-code, sehingga pengiriman seperti itu diterima lalu gagal.
• Nilai yang bukan nomor telepon maupun BSUID dengan format yang benar ditolak saat penerimaan, dengan 422 E15001 WhatsAppInvalidRecipient.
• Harga ditentukan berdasarkan awalan negara BSUID. Nomor telepon menyediakan negara yang digunakan untuk menentukan harga pesan, dan untuk pengiriman BSUID, awalan dua huruf yang menyediakannya.

Membaca dan memfilter berdasarkan BSUID

• Pada pesan, from dan to masing-masing membawa phone_number, bsuid, atau keduanya. Pesan masuk mencantumkan kontak pada from; pesan keluar mencantumkan mereka pada to.
• Pada webhook, alamat yang sama terdapat pada payload event. Lihat event WhatsApp untuk envelope-nya.
• Pada daftar pesan, to dan from masing-masing menerima BSUID maupun nomor telepon, dan masing-masing mencocokkan satu ujung pesan. Filter bsuid mencocokkan kontak di kedua arah. Filter phone_number yang lebih lama sudah tidak direkomendasikan: to dan from menggantikannya dan mencocokkan kedua jenis identitas.

Langkah selanjutnya

• Menerima kartu kontak: jalur tempat nomor yang dibagikan tiba
• Permintaan info kontak WhatsApp: tombol yang memintanya
• Mengirim pesan WhatsApp: envelope permintaan, model 202, dan percobaan ulang yang aman
• Referensi business-scoped user IDs Meta: peluncuran, parent BSUID, dan layanan Meta lainnya