ID pengguna khusus bisnis

ID pengguna khusus bisnis (BSUID) memungkinkan Anda mengirim pesan ke pengguna WhatsApp tanpa nomor telepon mereka. ID ini mengidentifikasi pengguna dalam portofolio bisnis Meta Anda.

Nama pengguna WhatsApp

Pengguna WhatsApp yang memiliki nama pengguna dapat mengirim pesan kepada Anda tanpa membagikan nomor telepon. Pesan mereka menyertakan from.bsuid; from.phone_number bisa tidak tersedia. Pengguna tanpa nama pengguna juga dapat memiliki BSUID.

Meta menyertakan nomor telepon jika pengguna ada di buku kontak Meta Anda atau telah bertukar pesan atau panggilan dengan nomor bisnis Anda dalam 30 hari terakhir. Aturan 30 hari berlaku per nomor bisnis.

from.username dan from.display_name bersifat opsional. Anda tidak dapat mengirim pesan ke salah satu nilai tersebut.

Format BSUID

BSUID terdiri dari kode negara ISO 3166 alpha-2 dalam huruf kapital, titik, dan hingga 128 huruf atau angka. Contoh: US.13491208655302741918.

Simpan dan kirim nilai lengkap tanpa mengubahnya. Gunakan nomor pengirim dari portofolio bisnis yang sama. Meta menolak pesan yang dikirim dari portofolio lain.

BSUID berubah saat pengguna mengganti nomor telepon. Karena itu, simpan BSUID dengan ID pelanggan Anda sendiri.

BSUID induk berlaku di seluruh portofolio yang didaftarkan oleh bisnis terkelola. Format ini menambahkan ENT. setelah kode negara: US.ENT.11815799212886844830. Batas 128 karakter berlaku untuk bagian setelah ENT.. Bird menerima kedua format.

Meminta nomor telepon

Contoh API pesan ini hanya menampilkan kolom yang diperlukan untuk percakapan ini.

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918"
  },
  "to": {
    "phone_number": "+14155550100"
  },
  "text": {
    "body": "Can I book a repair?"
  }
}

{
  "direction": "outbound",
  "from": {
    "phone_number": "+14155550100"
  },
  "to": {
    "bsuid": "US.13491208655302741918"
  },
  "interactive": {
    "type": "request_contact_info",
    "body_text": "Share your number."
  }
}

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918",
    "phone_number": "+14155550101"
  },
  "contact_cards": [
    {
      "origin": "contact_request",
      "phone_numbers": [
        {
          "phone_number": "+14155550101"
        }
      ]
    }
  ]
}

Jika pengguna menutup permintaan, Anda tidak menerima pesan atau webhook. Tetapkan batas waktu agar aplikasi Anda dapat melanjutkan tanpa nomor tersebut.

Mengirim pesan

Isi to dengan BSUID dan from dengan nomor bisnis WhatsApp Anda:

{
  "to": "US.13491208655302741918",
  "from": "+14155550100",
  "text": { "body": "Your repair is booked." }
}

Jika pesan masuk hanya menyertakan BSUID, balas ke BSUID tersebut dari nomor bisnis yang sama. Nomor telepon dari data Anda sendiri mungkin tidak memiliki jendela layanan yang terbuka sehingga menyebabkan 422 E15044.

• Templat autentikasi memerlukan nomor telepon.
• Nomor telepon atau BSUID yang tidak valid mengembalikan 422 E15001.
• Harga pesan bergantung pada kode negara BSUID.

Jendela layanan pelanggan juga berlaku untuk BSUID. Respons 202 berarti API telah menerima permintaan Anda. Periksa status pesan untuk memastikan pesan terkirim.

Mencari pesan

Pada pesan dan webhook, from mengidentifikasi pengirim dan to mengidentifikasi penerima. Masing-masing dapat berisi phone_number, bsuid, atau keduanya.

Untuk melihat daftar pesan, filter berdasarkan:

• from atau to untuk pengirim atau penerima, menggunakan nomor telepon atau BSUID mereka.
• bsuid untuk pesan yang dikirim ke atau diterima dari pengguna WhatsApp yang sama.

Filter phone_number sudah usang. Gunakan from atau to sebagai gantinya.

Panduan terkait

• Menerima kartu kontak
• Permintaan informasi kontak WhatsApp
• Mengirim pesan WhatsApp
• Referensi Meta tentang ID pengguna khusus bisnis