Platform WhatsApp Business

ID pengguna lingkup bisnis

Updated: 11 Agu 2026
Pembaruan 11 Agustus 2025! Lihat entri catatan perubahan untuk detailnya.
Mulai 29 Juni 2026 Anda bisa mulai memesan nama pengguna bisnis Anda. Lihat nama pengguna yang dipesan untuk detail selengkapnya.
Untuk memulai pengujian, lihat pengujian webhook.
WhatsApp akan mulai meluncurkan nama pengguna secara bertahap pada tahun 2026. Kami merekomendasikan semua bisnis dan mitra WhatsApp Business Platform mulai menguji dan membangun terintegrasi dengan ID pengguna lingkup Bisnis (BSUID) untuk memastikan kelancaran transisi dalam alur kerja Anda.
Adopsi nama pengguna adalah opsional untuk pengguna dan bisnis. Jika nama pengguna diadopsi oleh pengguna WhatsApp, nama pengguna mereka akan ditampilkan, bukan nomor telepon mereka di aplikasi. Nama pengguna bisnis tidak dimaksudkan untuk privasi. Jika Anda menggunakan nama pengguna bisnis, itu tidak akan menyebabkan nomor telepon bisnis Anda disembunyikan di aplikasi.
Untuk mendukung nama pengguna, meta mulai membagikan pengidentifikasi pengguna backend baru pada April 2026, yang disebut ID pengguna lingkup bisnis, atau BSUID. BSUID mengidentifikasi pengguna WhatsApp secara unik dan terikat dengan bisnis tertentu. Mendukung ID pengguna lingkup bisnis (BSUID) diperlukan untuk semua mitra dan bisnis yang terintegrasi langsung di Platform WhatsApp Business — serta pengiklan CTWA. Karena Anda tidak dapat mengontrol apakah pengguna Anda mengadopsi nama pengguna, Anda harus mendukung BSUID agar tidak kehilangan kemampuan untuk memproses pesan mereka.
Dokumen ini menjelaskan bagaimana penambahan nama pengguna akan memengaruhi permintaan API, tanggapan API, dan payload webhook. Perubahan tambahan untuk mendukung nama pengguna sebelum fitur tersedia akan direkam di sini.
Perubahan apa pun yang dijelaskan dalam dokumen ini dapat berubah.

Nama pengguna milik pengguna

Nama pengguna milik pengguna adalah nama opsional unik yang dapat diatur pengguna WhatsApp untuk menampilkan nama pengguna mereka, bukan nomor telepon mereka di aplikasi. Nama pengguna dapat digunakan sebagai ganti nama profil saat mempersonalisasi konten pesan untuk pengguna individu.
Pengguna WhatsApp dibatasi hanya 1 nama pengguna, tetapi dapat menggantinya secara berkala. Mengganti nama pengguna tidak memengaruhi nomor telepon pengguna atau ID pengguna lingkup bisnis, dan tidak memengaruhi kemampuan pengguna untuk berkomunikasi dengan pengguna WhatsApp lainnya atau bisnis di Platform WhatsApp Business. Nama pengguna memiliki batasan format yang sama dengan nama pengguna bisnis.
Nama pengguna ditetapkan ke properti username dalam tanggapan API dan payload webhooks. Setelah diaktifkan, nama pengguna milik pengguna WhatsApp akan muncul di semua webhooks pesan masuk, dan semua webhooks status pesantersampaikan dan dibaca.

ID pengguna lingkup bisnis

BSUID adalah pengidentifikasi pengguna unik yang dapat digunakan untuk mengirim pesan ke pengguna WhatsApp ketika Anda tidak mengetahui nomor telepon mereka. BSUID akan ditetapkan ke parameter user_id dan muncul di semua webhooks pesan, terlepas dari apakah pengguna telah mengaktifkan fitur nama pengguna atau belum. Dalam webhooks pesan status, BSUID pengguna disertakan dalam blok contacts (user_id) dan blok statuses (recipient_user_id), terlepas dari apakah pesan asli dikirim ke nomor telepon pengguna atau BSUID mereka. Pengecualiannya adalah pesan status failed: blokir contacts dihilangkan seluruhnya, dan recipient_user_id akan dihilangkan jika pesan dikirim ke nomor telepon pengguna.
BSUID dicakupkan dalam portofolio bisnis individu. Artinya, setiap nomor telepon bisnis yang dimiliki oleh portofolio tertentu dapat digunakan untuk mengirim pesan ke BSUID yang memiliki lingkup yang sama dengan portofolio tersebut, dan upaya untuk mengirim pesan ke BSUID menggunakan nomor telepon yang dimiliki oleh portofolio lain akan gagal.
BSUID akan:
  • dibuat secara otomatis
  • diberi awalan dengan kode negara dua huruf ISO 3166 alpha-2 dan tanda titik, diikuti dengan hingga 128 karakter alfanumerik (misalnya, US.13491208655302741918)
  • unik untuk setiap pasangan pengguna dan portofolio bisnis (portofolio bisnis sebelumnya dikenal sebagai Pengelola Bisnis)
  • dibuat ulang jika pengguna mengganti nomor telepon (yang memicu webhook pesan sistem)
BSUID dapat digunakan untuk mengirim jenis pesan apa pun kecuali untuk template autentikasi satu ketuk, tanpa ketuk, dan salin kode, yang memerlukan nomor telepon pengguna.
Saat membuat permintaan API dengan BSUID, gunakan seluruh nilai BSUID: kode negara, periode, dan semua karakter alfanumerik. Menghapus atau mengubah kode negara, periode, atau karakter alfanumerik akan menyebabkan permintaan Anda gagal.
Jika Anda adalah bisnis terkelola dengan beberapa portofolio bisnis, dan ingin menggunakan BSUID yang akan berfungsi di semua portofolio bisnis tersebut, lihat ID pengguna lingkup bisnis induk.

ID pengguna lingkup bisnis induk

Jika Anda adalah bisnis terkelola dan ingin mendaftarkan portofolio bisnis Anda untuk menerima BSUID induk, Anda dapat meminta kontak Meta Anda untuk memeriksa apakah Anda memenuhi syarat. Jika Anda memenuhi syarat, dan portofolio bisnis Anda terdaftar, BSUID induk akan disertakan dalam semua webhooks pesan, yang ditetapkan ke properti parent_user_id baru.
BSUID induk bisa digunakan untuk mengirim pesan kepada pengguna sebagai ganti BSUID reguler. Secara fungsional, BSUID induk memiliki properti yang sama dengan BSUID reguler, tetapi dapat digunakan oleh semua nomor telepon bisnis dalam set portofolio terdaftar. BSUID induk mengikuti format yang sama dengan BSUID reguler, tetapi menyertakan ENT di antara kode negara dan pengidentifikasi alfanumerik (contoh: US.ENT.11815799212886844830).
Perhatikan bahwa Anda masih dapat mengirim pesan kepada pengguna menggunakan BSUID regulernya yang terlingkup ke portofolio bisnis Anda.
Jika Anda mendaftar untuk menerima BSUID induk:
  • Portofolio bisnis Anda akan membagikan BSUID induk dengan portofolio bisnis lain yang telah didaftarkan di akun BSUID induk yang sama. Pengguna WhatsApp akan diidentifikasi oleh induk BSUID yang sama di semua portofolio bisnis yang terdaftar.
  • Payload webhook Anda akan menyertakan BSUID dan BSUID induk untuk setiap interaksi pengguna WhatsApp.
  • Kemampuan atau izin akun lain tidak akan terpengaruh. Portofolio bisnis Anda mempertahankan kontrol akses, penagihan, dan kemandirian administratif yang ada.
  • Semua portofolio bisnis yang terdaftar di akun BSUID induk yang sama akan terlihat melalui Parent BSUID Accounts API ke semua portofolio bisnis lain yang terdaftar.

Mendapatkan akun BSUID induk

BSUID induk untuk pengguna tertentu dikaitkan dengan akun BSUID induk. Semua portofolio bisnis yang terdaftar di akun tersebut dapat menggunakan BSUID induknya. Gunakan Parent BSUID Accounts API untuk mendapatkan ID akun BSUID induk dan daftar portofolio bisnis yang terdaftar di dalamnya.
Minta syntax:
curl 'https://api.facebook.com/<BUSINESS_ID>/parent-bsuid-accounts' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
Sintaksis tanggapan:
{
  "parent_bsuid_account_id": "<PARENT_BSUID_ACCOUNT_ID>",
  "enrolled_business_portfolios": [
    "<BUSINESS_PORTFOLIO_ID>",
    "<BUSINESS_PORTFOLIO_ID>"
  ]
}
  • parent_bsuid_account_id — ID akun BSUID induk yang dibagikan di seluruh portofolio bisnis Anda yang terdaftar.
  • enrolled_business_portfolios — Array ID portofolio bisnis yang terdaftar di akun BSUID induk. Setiap nomor telepon bisnis dalam portofolio ini dapat menggunakan BSUID induk akun.

Nomor telepon

Jika pengguna WhatsApp mengaktifkan fitur nama pengguna, nomor telepon mereka tidak akan disertakan dalam webhooks, kecuali Anda sebelumnya telah berinteraksi dengan pengguna, seperti yang dijelaskan di bawah ini. Oleh karena itu, terlepas dari apakah pengguna telah mengaktifkan fitur tersebut atau tidak, BSUID pengguna akan disertakan dalam webhooks yang biasanya menyertakan nomor telepon mereka, yang ditetapkan ke properti user_id baru.
Untuk mengurangi peluang kehilangan konteks percakapan dengan pengguna yang sudah ada yang mengaktifkan fitur nama pengguna, nomor telepon pengguna akan disertakan di webhooks jika salah satu dari kondisi berikut terpenuhi:
  • Anda telah mengirim pesan atau menelepon nomor telepon pengguna dalam 30 hari terakhir webhook aktif
  • Anda telah menerima pesan atau telepon dari nomor telepon pengguna dalam 30 hari terakhir webhook telah aktif
  • Pengguna ada dalam buku kontak Anda
Perhatikan bahwa kondisi lookback 30 hari di atas dievaluasi per nomor telepon bisnis. Jika Anda mengirim pesan kepada pengguna dari salah satu nomor telepon bisnis Anda, webhooks yang terkait dengan nomor telepon bisnis lain dalam portofolio Anda tidak akan menyertakan nomor telepon pengguna kecuali nomor spesifik tersebut juga telah mengirim atau menerima pesan atau telepon ke atau dari nomor telepon pengguna dalam 30 hari terakhir.
BSUIDs mulai muncul di webhooks pada awal April 2026. Namun, API kami tidak akan mendukung pengiriman pesan yang ditujukan ke BSUID hingga Juli 2026. Setelah API kami mendukung BSUID pada bulan Juli, Anda akan dapat mengirim pesan kepada pengguna menggunakan BSUID, nomor telepon, atau keduanya.
Jika Anda adalah penyedia solusi dan menyediakan layanan berkirim pesan WhatsApp ke pelanggan bisnis Anda, pelanggan Anda akan dapat menggunakan aplikasi Anda untuk mengirim pesan ke pengguna menggunakan nomor telepon bisnis portofolio mereka dan semua BSUID yang terlingkup dalam portofolio mereka. Namun, jika Anda mencoba menggunakan salah satu BSUID pelanggan bisnis Anda dengan nomor telepon bisnis Anda sendiri, upaya tersebut akan gagal karena BSUID hanya terbatas pada portofolio (dan pada dasarnya, aset yang dimiliki portofolio).
Jika Anda tidak yakin dengan kepemilikan aset:

Meminta nomor telepon dari pengguna

Untuk mempermudah permintaan nomor telepon dari pengguna WhatsApp, tersedia jenis tombol REQUEST_CONTACT_INFO yang dapat ditambahkan ke template utility dan marketing, atau dikirim sebagai pesan interaktif.
Jika pengguna mengetuk tombol ini, nomor telepon WhatsApp-nya akan dibagikan dalam utas pesan, dan webhook kontak akan terpicu yang berisi nomor telepon pengguna. Perhatikan bahwa jika pengguna WhatsApp membagikan kontak menggunakan fitur bagikan kontak di aplikasi WhatsApp, webhook juga akan menyertakan vCard kontak.
Jika Anda menggunakan fitur buku kontak, nomor telepon mereka juga akan otomatis ditambahkan ke buku kontak Anda. Untuk bisnis yang telah mengaktifkan Penyimpanan Lokal, Meta mengekstrak nomor telepon pengguna dari kartu kontak yang dibagikan (vCard) dan menyimpannya di buku kontak Anda di pusat data Meta. Hanya nomor telepon yang diambil dan disimpan; data vCard lainnya tidak disimpan setelah melewati masa penggunaan data standar.

Menggunakan template

Untuk menambahkan tombol minta informasi kontak ke template utilitas atau marketing, sertakan tombol REQUEST_CONTACT_INFO di array components saat membuat template:
curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "name": "<TEMPLATE_NAME>",
  "language": "<TEMPLATE_LANGUAGE>",
  "category": "utility",
  "components": [
    {
      "type": "body",
      "text": "<BODY_TEXT>"
    },
    {
      "type": "buttons",
      "buttons": [
        {
          "type": "REQUEST_CONTACT_INFO"
        }
      ]
    }
  ]
}'
Tombol minta informasi kontak tidak dapat dikustomisasi, jadi Anda tidak perlu menyertakan nilai parameter apa pun saat mengirim template:
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipient": "<BSUID>",
  "type": "template",
  "template": {
    "name": "<TEMPLATE_NAME>",
    "language": {
      "code": "<TEMPLATE_LANGUAGE>"
    }
  }
}'

Menggunakan pesan interaktif

Anda juga dapat mengirimkan tombol minta informasi kontak sebagai pesan interaktif:
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipient": "<BSUID>",
  "type": "interactive",
  "interactive": {
    "type": "request_contact_info",
    "body": {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "request_contact_info"
    }
  }
}'

Webhook kontak

Saat pengguna membagikan informasi kontak mereka — baik dengan mengetuk tombol REQUEST_CONTACT_INFO atau dengan membagikan kontak langsung dalam obrolan — webhook kontak akan dipicu.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<USER_DISPLAY_NAME>",
                  "username": "<USERNAME>"
                },
                "user_id": "<BSUID>"
              }
            ],
            "messages": [
              {
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "contacts",
                "from_user_id": "<BSUID>",               <!-- ADDED -->
                "contacts": [
                  {
                    "vcard": "<VCARD>",                   <!-- ADDED -->
                    "origin": "<ORIGIN>",                 <!-- ADDED -->
                    "phones": [
                      {
                        "phone": "<USER_PHONE_NUMBER>",
                        "wa_id": "<USER_WA_ID>",
                        "type": "<USER_PHONE_NUMBER_TYPE>"
                      }
                    ]
                  }
                ]
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
  • from_user_id — Properti baru. Akan diatur ke BSUID pengguna.
  • origin — Properti baru. Menunjukkan bagaimana informasi kontak dibagikan. Nilai bisa berupa:
    • contact_request — Pengguna membagikan informasi kontaknya dengan mengetuk tombol REQUEST_CONTACT_INFO.
    • other — Pengguna membagikan kontak langsung di obrolan (bukan melalui tombol REQUEST_CONTACT_INFO).
  • vcard — Kartu kontak virtual pengguna dalam format vCard. Akan diatur ke vCard pengguna jika origin adalah other. Akan dihilangkan jika origin adalah contact_request.

Buku kontak

Untuk mendukung kontinuitas pesan thread, tersedia fitur buku kontak yang menyimpan informasi kontak pengguna WhatsApp. Buku kontak disediakan dan di-hosting oleh Meta; tidak diperlukan pekerjaan integrasi.
Setelah fitur ini tersedia, jika Anda mengirim pesan/menelepon ke nomor telepon pengguna, atau menerima pesan/telepon dari nomor telepon pengguna, nomor telepon dan BSUID pengguna tersebut akan ditambahkan ke buku kontak Anda. Setelah data ini direkam, data akan digunakan untuk mengisi payload webhook agar menyertakan nomor telepon pengguna, terlepas apakah pengguna telah mengaktifkan fitur nama pengguna atau belum.
Buku kontak memiliki cakupan pada level portofolio bisnis, sehingga setiap interaksi antara nomor telepon bisnis dalam portofolio bisnis dan pengguna akan memicu nomor telepon pengguna dan BSUID agar disimpan dalam buku kontak. Hanya interaksi yang terjadi setelah buku kontak diluncurkan yang akan memicu penyimpanan; interaksi sebelumnya tidak akan direkam secara retroaktif, dan informasi kontak dari pengguna tersebut tidak akan disertakan dalam webhook.
Data buku kontak akan disimpan hingga Anda menonaktifkan fitur, atau menonaktifkan akun Anda. Jika Anda mau, Anda bisa menonaktifkan fitur ini di panel Meta Business Suite > Pengaturan bisnis > Info bisnis. Jika Anda menonaktifkan buku alamat, penyimpanan informasi pengguna akan dihentikan, dan informasi pengguna yang telah disimpan akan dihapus. Jika Anda mengaktifkan kembali buku kontak di lain waktu, buku kontak akan mulai menyimpan informasi pengguna lagi, tetapi informasi yang disimpan sebelumnya tidak dapat dipulihkan.
Batasan:
  • Jika Anda menggunakan Penyimpanan Lokal dan pengguna membagikan nomor teleponnya dengan mengetuk tombol bagikan informasi kontak, Meta akan mengambil nomor telepon pengguna dari kartu kontak yang dibagikan (vCard) dan menyimpannya ke buku kontak Anda di pusat data Meta. Hanya nomor telepon yang diambil dan disimpan; data vCard lainnya tidak disimpan setelah melewati masa penyimpanan data standar untuk penyimpanan lokal.
  • Buku kontak dicakup dalam portofolio bisnis. Artinya, jika Anda memiliki beberapa portofolio yang terdaftar di akun BSUID induk yang sama, nomor telepon dan BSUID pengguna harus dicatat di buku kontak setiap portofolio secara terpisah. Informasi kontak pengguna tidak dibagikan atau disinkronkan di seluruh portofolio yang terdaftar.

Menghapus entri buku kontak

Gunakan Contact Book API untuk menghapus entri pengguna tertentu dari buku kontak Anda. Setelah dihapus, nomor telepon pengguna dan BSUID tidak akan lagi disertakan dalam payload webhook untuk nomor telepon bisnis apa pun dalam portofolio bisnis, kecuali nomor telepon berada dalam cache 30 hari atau interaksi baru memicu entri buku kontak baru.
Minta syntax:
curl -X DELETE 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/contact_book?messaging_product=whatsapp&bsuid=<BSUID>' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
Atur bsuid ke BSUID entri buku kontak yang akan dihapus. Harus menggunakan format BSUID standar (contoh, US.13491208655302741918). BSUID harus dimiliki oleh portofolio bisnis yang sama dengan nomor telepon bisnis. BSUID induk tidak didukung.
Sintaksis tanggapan:
{
  "messaging_product": "whatsapp",
  "success": <SUCCESS?>,
  "deleted": <DELETED?>
}
  • success — Boolean. Akan diatur ke true jika permintaan berhasil diproses.
  • deleted — Boolean. Akan diatur ke true jika entri buku kontak ada dan telah dihapus, atau false jika tidak ada entri yang ditemukan untuk BSUID yang ditentukan.

Kode negara

Jika pengguna WhatsApp mengaktifkan fitur nama pengguna, nomor telepon mereka (dan dengan demikian, kode telepon negara) mungkin tidak muncul di webhooks. Dalam hal ini, BSUID pengguna akan muncul, diawali dengan kode negara dua huruf ISO 3166 alpha-2 dari pengguna (misalnya: US.13491208655302741918).

Nama pengguna bisnis

Bisnis juga akan dapat mengadopsi nama pengguna bisnis. Jika Anda menggunakan nama pengguna bisnis, nomor telepon bisnis Anda tidak akan disembunyikan di klien WhatsApp atau WhatsApp Business.
Nama pengguna bisnis pemetaan ke nomor telepon bisnis tunggal di seluruh WhatsApp; yaitu, nomor telepon hanya dapat memiliki satu nama pengguna pada waktu tertentu, dan tidak ada dua nomor telepon WhatsApp (konsumen atau bisnis) yang dapat memiliki nama pengguna yang sama.
Nama pengguna bisnis harus mengikuti format berikut:
  • hanya boleh berisi huruf abjad Inggris (a-z), digit (0-9), karakter titik (.), dan garis bawah (_)
  • karakter non-Inggris (seperti ñ, é, ü) tidak didukung dan akan menyebabkan permintaan gagal
  • panjangnya harus antara 3-35 karakter
  • harus mengandung setidaknya satu huruf Inggris (a-z, A-Z)
  • tidak boleh dimulai atau diakhiri dengan tanda titik atau memiliki 2 tanda titik berturut-turut
  • Tidak boleh dimulai dengan www.
  • tidak harus diakhiri dengan domain (misalnya, . com, . org, . jaring, . int, . edu, . Pemerintah, . Mil, . Arpa, . HTML, . htm, . SMS, . xml)
  • huruf besar/kecil diabaikan saat membandingkan nama pengguna, tetapi karakter titik dan garis bawah tidak; contoh: myID dan myid adalah *nama pengguna yang sama, tetapi myid, my.id, dan my_id semuanya berbeda

Nama pengguna yang direservasi

Mulai 29 Juni 2026, Anda akan memiliki opsi untuk mengklaim nama pengguna yang telah dipesan WhatsApp untuk Anda. Atau, Anda dapat mengadopsi nama pengguna lain yang selaras dengan persyaratan merek Anda. Nama pengguna yang dipesan bisa diklaim melalui Pengelola WhatsApp, Meta Business Suite, atau melalui Username API. Nama pengguna yang diklaim dan disetujui akan menjadi aktif setelah fitur nama pengguna tersedia.
Jika nama pengguna yang direservasi sudah digunakan dengan Halaman Facebook atau akun Instagram Anda, Anda harus menautkan nomor telepon bisnis Anda ke Halaman Facebook atau akun Instagram Anda sebelum Anda dapat mengeklaim nama pengguna tersebut.
Anda dapat menautkan nomor telepon Anda saat mengeklaim nama pengguna di Meta Business Suite atau Pengelola WhatsApp, atau dengan mengakses Halaman Facebook atau akun Instagram Anda dan menambahkan nomor telepon Anda secara langsung.
Untuk menautkan halaman atau akun, Anda harus memiliki kontrol penuh atas halaman atau akun tersebut, atau akses parsial dasar dengan izin manage_phone. Lihat Tentang izin portofolio bisnis dan aset bisnis untuk informasi tentang kontrol/akses dan izin.

Prioritas tampilan jendela obrolan

Prioritas berikut akan diikuti (dalam urutan prioritas yang menurun) untuk menampilkan informasi profil bisnis di jendela obrolan di aplikasi. Nomor telepon bisnis Anda akan selalu muncul di profil bisnis Anda.
  • Nama kontak yang disimpan
  • Nama bisnis terverifikasi atau nama Akun Bisnis Resmi
  • Nama pengguna
  • Nomor telepon

Dukungan

Mengadopsi atau mengubah nama pengguna bisnis

Mulai 29 Juni 2026, Anda akan dapat mengadopsi atau mengubah nama pengguna bisnis menggunakan Facebook Business Suite, WhatsApp Manager, aplikasi WhatsApp Business, atau melalui Usname API.
Minta syntax:
curl -X POST 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "username": "<DESIRED_USERNAME>",
  "transfer_action": "<TRANSFER_ACTION>"
}'
Diperlukan parameter usname. transfer_action adalah pilihan.
  • usname — Nama pengguna yang diinginkan. Harus mengikuti format nama pengguna bisnis.
  • transfer_action — Mengontrol apa yang terjadi ketika nama pengguna yang diminta sedang digunakan pada nomor telepon bisnis lain dalam portofolio bisnis yang sama (misalnya, ketika Anda ingin memindahkan nama pengguna yang ada ke nomor telepon yang lain). Nilai bisa berupa:
    • none (default) — Jangan mentransfer nama pengguna. Jika nama pengguna sudah digunakan pada nomor telepon bisnis lain dalam portofolio bisnis yang sama, permintaan gagal dengan kode error 147005.
    • force_transfer — Transfer nama pengguna dari nomor telepon bisnis lain ke nomor telepon bisnis ini. Nama pengguna dihapus dari nomor telepon lain dan ditetapkan ke nomor ini.
Sintaksis tanggapan, saat berhasil:
{
  "status": "<STATUS>"
}
  • status — Status nama pengguna yang diminta terbaru. Nilai bisa berupa:
    • approved — Nama pengguna yang diminta telah disetujui dan akan terlihat oleh pengguna WhatsApp setelah fitur nama pengguna tersedia.
    • reserved — Nama pengguna yang diminta telah dipesan dan disetujui tetapi belum terlihat oleh pengguna WhatsApp. Akan muncul di pengguna WhatsApp setelah fitur tersebut tersedia untuk semua orang.
Sintaksis tanggapan, saat gagal:
{
  "error": {
    "message": "<MESSAGE>",
    "type": "<TYPE>",
    "code": <CODE>,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "<DETAILS>"
    },
    "error_subcode": <ERROR_SUBCODE>,
    "fbtrace_id": "<FBTRACE_ID>"
  }
}
KodeDetailKemungkinan alasan dan solusi
10
Aplikasi tidak memiliki izin untuk tindakan ini
Konfirmasikan bahwa pengguna sistem yang tokennya digunakan dalam permintaan memiliki akses aset bisnis yang sesuai pada Akun WhatsApp Business: Kontrol penuh atau Akses parsial untuk Nomor telepon.
33
ID Tidak Valid
(1) ID nomor telepon bisnis tidak valid, (2) Akun WhatsApp Business yang terkait dengan nomor telepon bisnis telah dihapus, atau (3) pengguna yang tokennya digunakan dalam permintaan belum memberi aplikasi ini izin whatsapp_business_management (yang memerlukan Akses Lanjutan jika Anda adalah provider solusi)
100
Parameter Tidak Valid
147001
Nama pengguna tidak tersedia
Nama pengguna telah diklaim, tidak lulus pemeriksaan internal kami, atau tidak tersedia di platform. Coba minta nama pengguna lain.
147002
Akun tidak memenuhi syarat untuk meminta nama pengguna
Portofolio bisnis yang memiliki Akun WhatsApp Business dan nomor telepon bisnis harus memiliki batas pengiriman pesan yang lebih tinggi.
147003
Akun Facebook tidak tertaut
Anda harus menautkan nomor telepon ke Halaman Facebook yang sudah menggunakan nama pengguna yang diminta.
147004
Akun Instagram tidak tertaut
Anda harus menautkan nomor telepon ke akun Instagram yang sudah menggunakan nama pengguna yang diminta
147005
Diperlukan pengalihan nama pengguna
Nama pengguna yang diminta saat ini digunakan pada nomor telepon bisnis lain dalam portofolio bisnis Anda. Untuk mentransfernya ke nomor telepon ini, kirim ulang permintaan dengan transfer_action disetel ke force_transfer.
133010
Akun tidak terdaftar
Nomor telepon bisnis harus terlebih dahulu didaftarkan untuk penggunaan API.

Mendapatkan nama pengguna saat ini

Gunakan Username API untuk mendapatkan status nama pengguna bisnis yang terkait dengan nomor telepon bisnis, atau informasi tentang nama pengguna.
Minta syntax:
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
Sintaksis tanggapan:
{
  "username": "<USERNAME>",
  "status": "<STATUS>"
}
  • username — Nama pengguna saat ini. Akan dihilangkan jika nomor telepon bisnis tidak memiliki nama pengguna.
  • status — Status nama pengguna. Nilai bisa berupa:
    • approved — Nama pengguna disetujui dan dapat dilihat oleh pengguna WhatsApp.
    • reserved — Nama pengguna telah direservasi untuk nomor telepon bisnis tetapi tidak terlihat oleh pengguna WhatsApp. Ini akan terlihat begitu fitur nama pengguna tersedia untuk semua orang.

Mendapatkan nama pengguna yang direservasi

Gunakan Username Suggestions API untuk mendapatkan daftar nama pengguna yang telah dipesan untuk portofolio bisnis Anda.
Gunakan Username API untuk mengeklaim nama pengguna yang diinginkan dari daftar, yang kemudian harus disetujui. Setelah disetujui dan nama pengguna tersedia di negara Anda, nama pengguna akan beralih ke status "aktif", yang berarti nama pengguna bisnis akan mulai muncul di profil bisnis Anda, dan pengguna akan dapat mencarinya menggunakan pencarian yang sesuai.
Minta syntax:
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username_suggestions' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
Sintaksis tanggapan:
{
  "data": [
   {
     "username_suggestions": [
       "<RESERVED_USERNAME>",
       <!-- Additional usernames would follow, if any -->
     ]
   }
 ],
}
  • username_suggestions — Array nama pengguna yang direservasi, jika ada. Nama pengguna ini memiliki peluang persetujuan yang lebih tinggi.

Menghapus nama pengguna

Gunakan Username API untuk menghapus nama pengguna bisnis yang terkait dengan nomor telepon bisnis.
Minta syntax:
curl -X DELETE 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
Sintaksis tanggapan:
{
  "success": <SUCCESS?>
}
  • success — Boolean. Akan diatur ke true jika nama pengguna berhasil dihapus, jika gagal, akan diatur ke false.

Webhook business_username_updates

Webhook business_us name_updates baru akan ditambahkan. Webhook ini akan terpicu ketika status nama pengguna bisnis berubah.
Beri setiap aplikasi Anda langganan ke kolom webhooks ini agar diberi tahu tentang perubahan nama pengguna.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "changes": [
        {
          "field": "business_username_updates",
          "value": {
            "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
            "username": "<USERNAME>",
            "status": "<STATUS>"
          }
        }
      ]
    }
  ]
}
  • id — ID Akun WhatsApp Business.
  • time — Cap waktu Unix yang menunjukkan kapan webhook dipicu.
  • display_phone_number — Nomor tampilan nomor telepon bisnis (nomor yang ditampilkan di profil Anda dalam aplikasi).
  • username — Nama pengguna yang statusnya telah berubah. Ditiadakan jika status diatur ke deleted.
  • status — Nilai dapat berupa:
    • approved — Menunjukkan nama pengguna disetujui dan dapat dilihat oleh pengguna WhatsApp. Dipicu ketika status nama pengguna berubah dari reserved menjadi approved, atau nama pengguna diubah melalui aplikasi WhatsApp Business.
    • deleted — Menunjukkan nama pengguna telah dihapus melalui aplikasi WhatsApp Business.
    • reserved — Menunjukkan nama pengguna telah direservasi untuk nomor telepon bisnis tetapi tidak terlihat oleh pengguna WhatsApp. Ini akan terlihat begitu fitur nama pengguna tersedia untuk semua orang.

Pesan

Mengirim permintaan pesan

Perubahan ini akan berlaku untuk permintaan Messages API.
Sintaksis contoh ini mengirim pesan text, tetapi perubahannya berlaku untuk semua jenis pesan.
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<USER_PHONE_NUMBER>",    <!-- CHANGED -->
  "recipient": "<BSUID>",         <!-- ADDED -->
  "type": "text",
  "text": {
    "body": "<BODY_TEXT>"
  }
}'
Anda dapat menyertakan to (nomor telepon) dan recipient (BSUID atau BSUID induk) dalam permintaan Anda. Jika Anda melakukannya, to (nomor telepon) akan diutamakan. Jika mau, Anda juga dapat menggunakan salah satunya:
Untuk mengirim pesan hanya dengan menggunakan nomor telepon pengguna:
  • atur to ke nomor telepon pengguna
  • hilangkan properti recipient
Untuk mengirim pesan hanya dengan menggunakan BSUID pengguna atau BSUID induk:
  • atur recipient ke BSUID pengguna atau BSUID induk
  • hilangkan properti to

Mengirim tanggapan pesan

Perubahan ini berlaku untuk tanggapan Messages API.
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<USER_PHONE_NUMBER_OR_BSUID>",    <!-- CHANGED -->
      "wa_id": "<USER_PHONE_NUMBER>",             <!-- CHANGED -->
      "user_id": "<BSUID>"                        <!-- ADDED -->
    }
  ],
  "messages": [
    {
      "id": "<WHATSAPP_MESSAGE_ID>"
    }
  ]
}
  • input — Nilai baru (BSUID atau BSUID induk).
    • Akan menampilkan nomor telepon pengguna, jika pesan dikirim ke nomor telepon pengguna.
    • Akan menampilkan BSUID pengguna atau BSUID induk, jika perintah dikirim ke BSUID pengguna atau BSUID induk.
    • Akan menampilkan ID grup, jika dikirim ke grup.
  • wa_id — Perilaku baru (dapat dihilangkan). Akan menampilkan nomor telepon pengguna, jika pesan dikirim ke nomor telepon pengguna. Jika tidak, akan dihilangkan.
  • user_id — Properti baru.
    • Akan menampilkan BSUID pengguna atau BSUID induk, jika pesan dikirim ke BSUID pengguna atau BSUID induk.
    • Akan dihilangkan jika pesan dikirim ke nomor telepon pengguna, termasuk saat nomor telepon dan BSUID pengguna atau BSUID induk disertakan dalam permintaan (nomor telepon diutamakan).
Contoh tanggapan untuk permintaan kirim pesan yang dikirim ke nomor telepon pengguna (BSUID atau BSUID induk pengguna tidak digunakan dalam permintaan):
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}
Contoh tanggapan untuk permintaan kirim pesan yang dikirim ke BSUID pengguna (nomor telepon pengguna tidak digunakan dalam permintaan):
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "US.13491208655302741918",
      "user_id": "US.13491208655302741918"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}
Contoh tanggapan untuk permintaan kirim pesan yang dikirim ke nomor telepon pengguna dan BSUID (nomor telepon pengguna lebih diutamakan):
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}

Kode kesalahan

Menambahkan tanggapan kode kesalahan baru ke Messages API.
  • Kode kesalahan — 131062
  • Detail — Business-scoped User ID (BSUID) recipients are not supported for this message.

Marketing Messages API untuk WhatsApp

Mengirim permintaan pesan marketing

Marketing Messages API untuk WhatsApp akan mendukung nomor telepon, BSUID, dan BSUID induk. Mengirim pesan ke nomor telepon direkomendasikan, terutama agar Anda dapat terus menerima nomor telepon di webhooks.
Perubahan ini akan berlaku untuk permintaan Marketing Messages API.
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/marketing_messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<USER_PHONE_NUMBER>",    <!-- CHANGED -->
  "recipient": "<BSUID>",         <!-- ADDED -->
  "type": "template",
  "template": {
    <EXPECTED_TEMPLATE_PARAMETERS>
  }
}'
Anda dapat menyertakan to (nomor telepon) dan recipient (BSUID atau BSUID induk) dalam permintaan Anda. Jika Anda melakukannya, to (nomor telepon) akan diutamakan. Jika mau, Anda juga dapat menggunakan salah satunya:
Untuk mengirim pesan hanya dengan menggunakan nomor telepon pengguna:
  • atur to ke nomor telepon pengguna
  • hilangkan properti recipient
Untuk mengirim pesan hanya dengan menggunakan BSUID pengguna atau BSUID induk:
  • atur recipient ke BSUID pengguna atau BSUID induk
  • hilangkan properti to

Mengirim tanggapan pesan marketing

Perubahan ini berlaku untuk tanggapan Marketing Messages API.
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<USER_PHONE_NUMBER_OR_ID>",    <!-- CHANGED -->
      "wa_id": "<USER_PHONE_NUMBER>",          <!-- CHANGED -->
      "user_id": "<BSUID>"                     <!-- ADDED -->
    }
  ],
  "messages": [
    {
      "id": "<WHATSAPP_MESSAGE_ID>",
      "message_status": "<PACING_STATUS>"
    }
  ]
}
  • input — Nilai baru (BSUID atau BSUID induk).
    • Akan menampilkan nomor telepon pengguna, jika pesan dikirim ke nomor telepon pengguna.
    • Akan menampilkan BSUID pengguna atau BSUID induk, jika perintah dikirim ke BSUID pengguna atau BSUID induk.
    • Akan menampilkan ID grup, jika pesan dikirim ke grup.
  • wa_id — Akan menampilkan nomor telepon pengguna, jika pesan dikirim ke nomor telepon pengguna. Jika tidak, akan dihilangkan.
  • user_id — Properti baru.
    • Akan menampilkan BSUID pengguna atau BSUID induk, jika pesan dikirim ke BSUID pengguna atau BSUID induk.
    • Akan dihilangkan jika pesan dikirim ke nomor telepon pengguna, termasuk saat nomor telepon dan BSUID pengguna atau BSUID induk disertakan dalam permintaan (nomor telepon diutamakan).
Contoh tanggapan untuk mengirim pesan template ke nomor telepon pengguna:
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA",
      "message_status": "accepted"
    }
  ]
}
Contoh tanggapan untuk mengirim pesan template ke BSUID pengguna:
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "US.13491208655302741918",
      "user_id": "US.13491208655302741918"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA",
      "message_status": "accepted"
    }
  ]
}

Pengujian webhook

Anda dapat menguji payload webhook yang menunjukkan skenario penggunaan nama pengguna dunia nyata menggunakan panel Dasbor Aplikasi > Kasus penggunaan (ikon pensil) > Terhubung dengan pelanggan melalui WhatsApp > Kustomisasi > Konfigurasi (Dasbor Aplikasi > WhatsApp > Konfigurasi untuk aplikasi yang dibuat sebelum Desember 2025). Klik tautan Uji di samping webhook pesan untuk mengirim webhook pesan uji ke endpoint webhook Anda.
Alat uji mendukung webhooks pesan masuk dan webhooks pesan status untuk pesan terkirim, dengan skenario berikut:
  • Pengguna belum menggunakan nama pengguna — Payload webhooks akan menyertakan kolom BSUID dan kolom nomor telepon, tetapi tidak ada nama pengguna. Ini mewakili status default untuk sebagian besar pengguna saat peluncuran.
  • Pengguna telah menggunakan nama pengguna dan nomor telepon tidak tersedia — Payload webhook akan menyertakan kolom nama pengguna dan BSUID, tetapi kolom nomor telepon akan dihilangkan. Integrasi Anda harus menangani skenario ini dengan baik. Lihat Nomor telepon untuk kondisi yang mendasari penyertaan nomor telepon.
  • Pengguna telah menggunakan nama pengguna dan nomor telepon tersedia — Payload webhook akan mencakup semua kolom: nama pengguna, BSUID, dan nomor telepon.
  • BSUID induk ada — Untuk bisnis dengan beberapa portofolio yang terdaftar di akun BSUID induk yang sama, payload webhook akan menyertakan BSUID induk selain BSUID level portofolio.

Referensi cepat pengidentifikasi webhook

Tabel berikut merangkum pengidentifikasi pengguna mana yang akan disertakan dalam webhooks pesan, berdasarkan jenis webhooks dan apakah pengguna telah menggunakan nama pengguna.

Webhooks status pesan keluar

Pengidentifikasi ini berlaku untuk webhooks pesan status terkirim, tersampaikan, dan dibaca.
PengidentifikasiDikirim ke nomor teleponDikirim ke BSUID
wa_id
Selalu disertakan
Disertakan jika nomor telepon tersedia sesuai kondisi Nomor telepon
user_id
Selalu disertakan
Selalu disertakan
recipient_user_id
Selalu disertakan
Selalu disertakan
parent_user_id
Disertakan jika ID BSUID induk diaktifkan
Disertakan jika ID BSUID induk diaktifkan
recipient_parent_user_id
Disertakan jika ID BSUID induk diaktifkan
Disertakan jika ID BSUID induk diaktifkan
username
Disertakan dalam tersampaikan/dibaca jika pengguna memiliki nama pengguna
Disertakan dalam tersampaikan/dibaca jika pengguna memiliki nama pengguna

Webhooks pesan masuk

Pengidentifikasi ini berlaku untuk webhook pesan masuk, termasuk pesan yang diinisiasi oleh pengguna dan balasan pengguna.
PengidentifikasiPengguna memiliki nama penggunaPengguna tidak memiliki nama pengguna
wa_id
Disertakan jika nomor telepon tersedia sesuai kondisi Nomor telepon
Selalu disertakan
user_id
Selalu disertakan
Selalu disertakan
parent_user_id
Disertakan jika ID BSUID induk diaktifkan
Disertakan jika ID BSUID induk diaktifkan
username
Selalu disertakan
Tidak disertakan

Situs web pesan

Webhooks pesan status

Perubahan ini akan berlaku untuk webhooks pesan status terkirim, tersampaikan, dibaca, dan gagal.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },

            <!-- Contacts will be included for sent, delivered, and read status -->
            "contacts": [                                      <!-- ADDED -->
              {
                "profile": {
                  "name": "<USER_DISPLAY_NAME>",               <!-- ADDED --><!-- Only included if user has enabled the username feature -->
                  "username": "<USERNAME>"                     <!-- ADDED -->

                },
                "wa_id": "<USER_PHONE_NUMBER>",                <!-- ADDED -->
                "user_id": "<BSUID>",                          <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"             <!-- ADDED -->
              }
            ],

            "statuses": [
              {
                "id": "<WHATSAPP_MESSAGE_ID>",
                "status": "<STATUS>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "recipient_id": "<USER_PHONE_NUMBER>",         <!-- CHANGED -->
                "recipient_user_id": "<BSUID>",                <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "recipient_parent_user_id": "<PARENT_BSUID>"   <!-- ADDED -->
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
  • contacts — Array baru. Hanya disertakan untuk pesan status terkirim, tersampaikan, dan dibaca. Akan dihilangkan seluruhnya untuk webhooks pesan status failed.
    • name — Properti baru. Nilai akan diatur ke nama tampilan pengguna WhatsApp.
    • username — Properti baru.
      • Akan diatur ke nama pengguna WhatsApp, jika pengguna telah mengaktifkan fitur nama pengguna.
      • Akan dihilangkan seluruhnya untuk webhooks pesan status sent, atau jika pengguna belum mengaktifkan fitur nama pengguna.
    • wa_id — Properti baru.
      • Akan diatur ke nomor telepon pengguna jika nomor telepon dapat disertakan berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
      • Akan dihilangkan jika nomor telepon tidak dapat disertakan berdasarkan kondisi tersebut.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna WhatsApp.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, properti akan dihilangkan seluruhnya.
  • statuses
    • recipient_id — Perilaku baru (dapat dihilangkan).
      • Akan diatur ke nomor telepon pengguna, jika Anda mengirim pesan ke nomor telepon pengguna.
      • Akan diatur ke ID grup, jika Anda mengirim pesan ke grup.
      • Akan dihilangkan jika Anda mengirim pesan ke BSUID atau BSUID induk pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan dalam bagian Nomor telepon.
    • recipient_user_id — Properti baru. Akan selalu diatur ke BSUID pengguna, terlepas dari apakah pesan dikirim ke nomor telepon atau BSUID pengguna. Untuk pesan status failed, akan dihilangkan jika pesan dikirim ke nomor telepon pengguna.
    • recipient_parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan seluruhnya.
Contoh webhooks pesan status tersampaikan yang menjelaskan pesan yang dikirim dari bisnis yang telah mengaktifkan BSUID induk ke nomor telepon pengguna WhatsApp yang telah mengaktifkan fitur nama pengguna:
{
 "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Pablo M.",
                  "username": "pablomorales"
                },
                "wa_id": "16505551234",
                "user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.11815799212886844830"
              }
            ],
            "statuses": [
              {
                "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=",
                "status": "delivered",
                "timestamp": "1750030073",
                "recipient_id": "16505551234",
                "recipient_user_id": "US.13491208655302741918",
                "recipient_parent_user_id": "US.ENT.11815799212886844830",
                "pricing": {
                  "billable": true,
                  "pricing_model": "PMP",
                  "type": "regular",
                  "category": "marketing"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
Contoh webhooks pesan status tersampaikan yang menjelaskan pesan yang dikirim dari bisnis yang telah mengaktifkan BSUID induk, ke BSUID pengguna WhatsApp yang telah mengaktifkan fitur nama pengguna. Dalam contoh ini, kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan dalam bagian Nomor telepon (jadi wa_id dan recipient_id tidak disertakan).
{
 "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Pablo M.",
                  "username": "pablomorales"
                },
                "user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.11815799212886844830"
              }
            ],
            "statuses": [
              {
                "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=",
                "status": "delivered",
                "timestamp": "1750030073",
                "recipient_user_id": "US.13491208655302741918",
                "recipient_parent_user_id": "US.ENT.11815799212886844830",
                "pricing": {
                  "billable": true,
                  "pricing_model": "PMP",
                  "type": "regular",
                  "category": "marketing"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
Contoh webhook pesan status gagal yang menjelaskan pesan yang dikirim ke nomor telepon pengguna WhatsApp. Perhatikan bahwa array contacts dihilangkan untuk pesan status yang gagal, recipient_user_id dihilangkan karena pesan dikirim ke nomor telepon, dan array errors disertakan dalam blok statuses:
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "statuses": [
              {
                "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=",
                "status": "failed",
                "timestamp": "1750030073",
                "recipient_id": "16505551234",
                "errors": [
                  {
                    "code": 131049,
                    "title": "This message was not delivered to maintain healthy ecosystem engagement.",
                    "message": "This message was not delivered to maintain healthy ecosystem engagement.",
                    "error_data": {
                      "details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
                    },
                    "href": "/documentation/business-messaging/whatsapp/support/error-codes"
                  }
                ]
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Webhooks pesan masuk

Perubahan ini berlaku untuk webhooks pesan masuk (teks, gambar, interaktif, dan seterusnya), termasuk pesan masuk yang dikirim oleh pengguna dalam obrolan Grup.
Contoh sintaksis di bawah ini adalah untuk pesan teks masuk, tetapi perubahannya sama untuk semua jenis pesan masuk.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_PROFILE_NAME>",

                  <!-- Only included if user has enabled the username feature -->
                  "username": "<USERNAME>"                 <!-- ADDED -->
                },
                "wa_id": "<WHATSAPP_USER_ID>",             <!-- CHANGED -->
                "user_id": "<BSUID>",                      <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"         <!-- ADDED -->
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER>",    <!-- CHANGED -->
                "from_user_id": "<BSUID>",                 <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "from_parent_user_id": "<PARENT_BSUID>",   <!-- ADDED --><!-- Only included if incoming message sent in a group -->
                "group_id": "<GROUP_ID>",

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "text",
                "text": {
                  "body": "<MESSAGE_TEXT_BODY>"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
  • contacts
    • profile
      • username — Properti baru.
        • Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna.
        • Akan dihilangkan jika pengguna belum menggunakan nama pengguna.
    • wa_id — Perilaku baru (dapat dihilangkan).
      • Akan diatur ke nomor telepon pengguna jika nomor telepon dapat disertakan berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
      • Akan dihilangkan jika nomor telepon tidak dapat disertakan berdasarkan kondisi tersebut.
    • user_id — Properti baru, diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna, jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • messages
    • from — Perilaku baru (dapat dihilangkan).
      • Akan diatur ke nomor telepon pengguna jika nomor telepon dapat disertakan berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
      • Akan dihilangkan jika nomor telepon tidak dapat disertakan berdasarkan kondisi tersebut.
    • from_user_id — Properti baru, diatur ke BSUID pengguna.
    • from_parent_user_id — Properti baru, diatur ke BSUID induk pengguna, jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
Contoh pesan teks masuk dari pengguna yang telah mengaktifkan fitur nama pengguna, ke bisnis yang telah mengaktifkan BSUID induk. Dalam skenario ini, kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102290129340398",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550783881",
              "phone_number_id": "106540352242922"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Sheena Nelson",
                  "username": "realsheenanelson"
                },
                "user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.11815799212886844830"
              }
            ],
            "messages": [
              {
                "from_user_id": "US.13491208655302741918",
                "from_parent_user_id": "US.ENT.11815799212886844830",
                "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=",
                "timestamp": "1749416383",
                "type": "text",
                "text": {
                  "body": "Does it come in another color?"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Webhooks pesan sistem

Perubahan ini berlaku untuk webhooks pesan sistem. Trigger baru telah ditambahkan: webhook pesan sistem sekarang akan dipicu saat pengguna WhatsApp mengubah nomor teleponnya menggunakan aplikasi konsumen WhatsApp. Anda akan menerima salah satu dari dua jenis pesan sistem, tergantung pada pengidentifikasi yang berubah dan apakah nomor telepon dapat dibagikan dengan Anda.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "system",
                "system": {
                  "body": "User...",                       <!-- CHANGED -->
                  "wa_id": "<NEW_WHATSAPP_USER_ID>",       <!-- CHANGED -->
                  "user_id": "<NEW_BSUID>",                <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                  "parent_user_id": "<NEW_PARENT_BSUID>",  <!-- ADDED -->
                  "type": "<SYSTEM_CHANGE_TYPE>"           <!-- CHANGED -->
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
  • system
    • body — String baru. Akan diatur ke User A changed from <OLD_PHONE_NUMBER> to <NEW_PHONE_NUMBER>.
    • wa_id — Perilaku baru (dapat dihilangkan).
      • Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
      • Akan diatur ke nomor telepon pengguna jika pengguna belum mengaktifkan fitur nama pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID baru pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk baru pengguna, jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
    • previous_user_id — Properti baru. Akan diatur ke BSUID yang dimiliki pengguna sebelum perubahan. Perubahan nomor telepon juga menumbuhkan BSUID, jadi ini cara Anda bergabung dengan identitas baru ke yang sudah Anda miliki di berkas. Tidak ada saat BSUID sebelumnya tidak tersedia.
    • previous_parent_user_id — Properti baru. Akan diatur ke BSUID induk yang dimiliki pengguna sebelum perubahan, jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
    • type — Nilai baru (user_changed_number). Akan diatur ke user_changed_number ketika pengguna WhatsApp mengubah nomor telepon mereka, yang juga regenerasi BSUID mereka.
Anda akan menerima pesan sistem user_changed_user_id ketika BSUID pengguna berubah dan tidak ada nomor telepon yang dapat dibagikan dengan Anda. Ini mengidentifikasi pengguna hanya oleh BSUID, dan membawa BSUID yang mereka miliki sebelum perubahan:
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "messages": [
              {
                <!-- Omitted when no phone number can be shared -->
                "from": "<WHATSAPP_USER_PHONE_NUMBER>",

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "system",
                "system": {
                  "body": "User changed from <OLD_BSUID> to <NEW_BSUID>",

                  <!-- Omitted when no phone number can be shared -->
                  "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>",

                  "user_id": "<NEW_BSUID>",
                  "previous_user_id": "<OLD_BSUID>",

                  <!-- Only included if parent BSUIDs enabled -->
                  "parent_user_id": "<NEW_PARENT_BSUID>",
                  "previous_parent_user_id": "<OLD_PARENT_BSUID>",
                  "type": "user_changed_user_id"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
  • system
    • body — Akan diatur ke User changed from <OLD_BSUID> to <NEW_BSUID>.
    • wa_id — Akan dihilangkan jika nomor telepon pengguna tidak dapat dibagikan kepada Anda, berdasarkan kondisi yang dijelaskan dalam bagian Nomor telepon. Ini adalah kasus yang biasa untuk jenis pesan ini.
    • user_id — Akan diatur ke BSUID baru pengguna.
    • previous_user_id — Properti baru. Akan diatur ke BSUID yang dimiliki pengguna sebelum perubahan.
    • parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
    • previous_parent_user_id — Properti baru. Akan diatur ke BSUID induk yang dimiliki pengguna sebelum perubahan, jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
    • type — Nilai baru (user_changed_user_id).

Webhooks user_preferences

Perubahan ini akan berlaku untuk webhooks user_preferences.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>",

                  <!-- Only included if user has enabled the usernames feature -->
                  "username": "<USERNAME>"                 <!-- ADDED -->
                },
                "wa_id": "<WHATSAPP_USER_ID>",             <!-- CHANGED -->
                "user_id": "<BSUID>",                      <!-- ADDED --><!-- Only included if you have enabled parent BSUIDs -->
                "parent_user_id": "<PARENT_BSUID>"         <!-- ADDED -->
              }
            ],
            "user_preferences": [
              {
                "wa_id": "<WHATSAPP_USER_ID>",             <!-- CHANGED -->
                "user_id": "<BSUID>",                      <!-- ADDED --><!-- Only included if you have enabled parent BSUIDs -->
                "parent_user_id": "<PARENT_BSUID>",        <!-- ADDED -->

                "detail": "<PREFERENCE_DESCRIPTION>",
                "category": "marketing_messages",
                "value": "<PREFERENCE>",
                "timestamp": <WEBHOOK_SENT_TIMESTAMP>
              }
            ]
          },
          "field": "user_preferences"
        }
      ]
    }
  ]
}
  • contacts
    • profile
      • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Properti dihilangkan jika pengguna telah menonaktifkan fitur nama pengguna.
    • wa_id — Perilaku baru (dapat dihilangkan).
      • Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
      • Akan diatur ke nomor telepon pengguna jika pengguna belum mengaktifkan fitur nama pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • user_preferences
    • wa_id — Perilaku baru (dapat dihilangkan). Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Webhooks user_id_update

Tidak ada bidang webhook user_id_update Perubahan BSUID dikirimkan di kolom messages sebagai pesan sistem. Lihat webhook pesan sistem.
user_id_update bukan bidang webhook yang dapat berlangganan, sehingga tidak muncul di Dasbor Aplikasi dan Anda tidak dapat berlangganan aplikasi Anda untuk itu.
BSUID pengguna diregenerasi ketika pengguna mengubah nomor telepon mereka. Perubahan itu dikirimkan pada langganan messages yang ada sebagai system messages webhook, di mana:
  • messages[].type adalah system
  • system.type adalah user_changed_number jika nomor telepon baru pengguna dapat dibagikan kepada Anda, atau user_changed_user_id jika hanya perubahan BSUID yang dapat dilaporkan
  • system.user_id adalah BSUID baru pengguna
  • system.parent_user_id adalah BSUID induk baru pengguna, jika Anda telah mengaktifkan BSUID induk
  • system.previous_user_id dan system.previous_parent_user_id membawa nilai dari sebelum perubahan
Untuk mengetahui perubahan BSUID, berlangganan aplikasi Anda ke bidang mesages dan tangani pesan masuk yang type adalah system. Tangani kedua nilai system.type: mana yang Anda terima tergantung pada pengidentifikasi yang berubah dan apakah nomor telepon dapat dibagikan dengan Anda.

Groups API

Mendapatkan info grup

Perubahan ini berlaku untuk tanggapan Group API.
{
  "participants": [
    {
      "wa_id": "<USER_PHONE_NUMBER>"        <!-- CHANGED -->
      "user_id": "<BSUID>",                 <!-- ADDED --><!-- Only returned if the you have enabled parent BSUIDs -->
      "parent_user_id": "<PARENT_BSUID>",   <!-- ADDED --><!-- Only returned if the user has enabled the usernames feature -->
      "username": "<USERNAME>"              <!-- ADDED -->

    }
  ],
  "subject": "<GROUP_SUBJECT>",
  "id": "<GROUP_ID>",
  "messaging_product": "whatsapp"
}
  • wa_id — Perilaku baru (dapat dihilangkan).
    • Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
    • Akan diatur ke nomor telepon pengguna jika pengguna belum mengaktifkan fitur nama pengguna.
  • user_id — Properti baru. Akan diatur ke BSUID pengguna.
  • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • username — Properti baru.
    • Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna.
    • Akan dihilangkan jika pengguna tidak menggunakan, atau telah menonaktifkan, fitur nama pengguna.

Mendapatkan permintaan bergabung ke grup

Perubahan ini berlaku untuk tanggapan Join Requests API.
{
  "data": [
    {
      "join_request_id": "<JOIN_REQUEST_ID>",
      "creation_timestamp": "<JOIN_REQUEST_TIMESTAMP>",
      "wa_id": "<USER_PHONE_NUMBER>",                    <!-- CHANGED -->
      "user_id": "<BSUID>",                              <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
      "parent_user_id": "<PARENT_BSUID>",                <!-- ADDED --><!-- Only included if user has enabled usernames feature -->
      "username": "<USERNAME>"                           <!-- ADDED -->
    }
  ],
  "paging": {
    "cursors": {
      "before": "<BEFORE_CURSOR>",
      "after": "<AFTER_CURSOR>"
    }
  }
}
  • wa_id — Perilaku baru (dapat dihilangkan).
    • Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
    • Akan diatur ke nomor telepon pengguna jika pengguna belum mengaktifkan fitur nama pengguna.
  • user_id — Properti baru. Akan diatur ke BSUID pengguna.
  • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Akan dihilangkan jika pengguna belum mengaktifkan fitur nama pengguna.

Mengeluarkan anggota grup

Perubahan ini berlaku untuk permintaan Participants API.
curl -g -X DELETE 'https://graph.facebook.com/<API_VERSION>/<GROUP_ID>/participants' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "participants": [
    {
      "user": "<USER_PHONE_NUMBER>",   <!-- CHANGED -->
      "user_id": "<BSUID>"            <!-- ADDED -->
    }
  ]
}'
  • user — Nomor telepon pengguna.
  • user_id — Properti baru. BSUID pengguna.
Sertakan user atau user_id, tetapi jangan keduanya.

Webhooks Groups API

Webhooks pesan status untuk grup

Perubahan ini akan berlaku untuk webhooks pesan statusdelivered dan read untuk pesan yang dikirim ke grup.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },

           <!-- Contacts will be included for delivered and read status -->
           "contacts": [                             <!-- ADDED -->
                {
                  "profile": {
                    "name": "<USER_DISPLAY_NAME>",   <!-- ADDED --><!-- Only included if user has enabled usernames feature -->
                    "username": "<USERNAME>"         <!-- ADDED -->
                  },
                  "wa_id": "<USER_PHONE_NUMBER>",    <!-- ADDED -->
                  "user_id": "<BSUID>",              <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                  "parent_user_id": "<PARENT_BSUID>"
                },
                # Additional contact objects would follow, if aggregated
                {
                  ...
                }
              ],

            "statuses": [
              {
                "id": "<WHATSAPP_MESSAGE_ID>",
                "status": "<STATUS>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "recipient_id": "<GROUP_ID>",
                "recipient_type": "group",
                "recipient_participant_id": "<GROUP_PARTICIPANT_USER_PHONE_NUMBER>", <!-- CHANGED -->
                "recipient_participant_user_id": "<BSUID>",                <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "recipient_participant_parent_user_id": "<PARENT_BSUID>",  <!-- ADDED --><!-- Omitted for v24.0+ unless webhook is for a free entry point conversation -->
                "conversation": {
                  "id": "<CONVERSATION_ID>",
                  "expiration_timestamp": "<CONVERSATION_EXPIRATION_TIMESTAMP>",
                  "origin": {
                    "type": "<CONVERSATION_CATEGORY>"
                  }
                },

                "pricing": {
                  "billable": <IS_BILLABLE?>,
                  "pricing_model": "<PRICING_MODEL>",
                  "type": "<PRICING_TYPE>",
                  "category": "<PRICING_CATEGORY>"
                }
              },
              # Additional status objects would follow, if aggregated
              {
                ...
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
  • contacts — Array baru. Hanya disertakan untuk pesan status tersampaikan dan dibaca. Akan dihilangkan seluruhnya untuk webhooks pesan status yang gagal.
    • name — Properti baru. Nilai akan diatur ke nama tampilan pengguna WhatsApp.
    • username — Properti baru. Akan diatur ke nama pengguna WhatsApp jika pengguna telah menggunakan nama pengguna. Akan dihilangkan untuk webhooks pesan status terkirim, atau jika pengguna belum mengaktifkan fitur nama pengguna.
    • wa_id — Properti baru.
      • Akan dihilangkan jika pengguna telah mengadopsi nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon.
      • Akan diatur ke nomor telepon pengguna, jika Anda mengirim pesan ke nomor telepon pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna WhatsApp.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • recipient_participant_id — Diubah. Akan diatur ke nomor telepon pengguna, jika pesan dikirim ke nomor telepon mereka. Jika tidak, akan dihilangkan.
  • recipient_participant_user_id — Properti baru. Akan selalu diatur ke BSUID pengguna, terlepas dari apakah pesan dikirim ke nomor telepon atau BSUID pengguna. Untuk pesan status failed, akan dihilangkan jika pesan dikirim ke nomor telepon pengguna.
  • recipient_participant_parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Webhooks group_participants_update

Perubahan ini berlaku untuk webhook group_participants_update.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "groups": [
              {
                "timestamp": <WEBHOOK_TRIGGER_TIMESTAMP>,
                "group_id": "<GROUP_ID>",

                <!-- Only if business removes participant from group -->
                "type": "group_participants_remove",
                "request_id": "REQUEST_ID",
                "removed_participants": [
                  {
                    "input": "<USER_PHONE_NUMBER_OR_BSUID>", <!-- CHANGED -->
                  }
                ],

                "initiated_by": "business"

                <!-- Only if user removes themself from group -->
                "type": "group_participants_remove",
                "request_id": "REQUEST_ID",
                "removed_participants": [
                  {
                    "wa_id": "<USER_PHONE_NUMBER>"       <!-- CHANGED -->
                    "user_id": "<BSUID>",                <!-- ADDED -->
                    "parent_user_id": "<PARENT_BSUID>",  <!-- ADDED -->
                    "username": "<USERNAME>"             <!-- ADDED -->
                  }
                ],

                "initiated_by": "participant"

                <!-- Only if user joins group via invite link -->
                "type": "group_participants_add",
                "reason": "invite_link",
                "added_participants": [
                  {
                    "wa_id": "<USER_PHONE_NUMBER>"       <!-- CHANGED -->
                    "user_id": "<BSUID>",                <!-- ADDED -->
                    "parent_user_id": "<PARENT_BSUID>",  <!-- ADDED -->
                    "username": "<USERNAME>"             <!-- ADDED -->
                  }
                ]

                <!-- Only if join request created -->
                "type": "group_join_request_created",
                "join_request_id": "<JOIN_REQUEST_ID>",
                "wa_id": "<USER_PHONE_NUMBER>",          <!-- CHANGED -->
                "user_id": "<BSUID>",                    <!-- ADDED -->
                "parent_user_id": "<PARENT_BSUID>",      <!-- ADDED -->
                "username": "<USERNAME>"                 <!-- ADDED --><!-- Only if join request revoked -->
                "type": "group_join_request_revoked",
                "join_request_id": "<JOIN_REQUEST_ID>",
                "wa_id": "<USER_PHONE_NUMBER>"           <!-- CHANGED -->
                "user_id": "<BSUID>",                    <!-- ADDED -->
                "parent_user_id": "<PARENT_BSUID>",      <!-- ADDED -->
                "username": "<USERNAME>"                 <!-- ADDED -->
              }
            ]
          },
          "field": "group_participants_update"
        }
      ]
    }
  ]
}
  • input — Nilai baru (nomor telepon atau BSUID).
    • Akan diatur ke nomor telepon pengguna jika Anda menghapus pengguna dari grup menggunakan nomor telepon mereka.
    • Akan diatur ke BSUID pengguna jika Anda mengeluarkan pengguna dari grup menggunakan BSUID mereka.
  • wa_id — Perilaku baru (dapat dihilangkan).
    • Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
  • user_id — Properti baru. Akan diatur ke BSUID pengguna.
  • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.

Memblokir Users API

Memblokir atau membuka blokir permintaan pengguna

Perubahan ini berlaku untuk permintaan POST dan DELETE Blokir Pengguna. Ini adalah contoh sintaksis permintaan pengguna yang diblokir, tetapi perubahan juga berlaku untuk permintaan yang dibuka blokirnya.
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/block_users' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "block_users": [
    {
      "user": "<USER_PHONE_NUMBER>"
    },
    {
      "user_id": "<BSUID>"   <!-- ADDED -->
    }
  ]
}'
Anda dapat menyertakan user (nomor telepon) dan user_id (BSUID) dalam permintaan Anda. Jika Anda melakukannya, user (nomor telepon) akan diutamakan. Jika mau, Anda juga dapat menggunakan salah satunya:
Untuk memblokir atau membuka blokir pengguna hanya menggunakan nomor telepon mereka:
  • Atur user ke nomor telepon pengguna
  • Hilangkan objek user_id
Untuk memblokir atau membuka blokir pengguna hanya menggunakan BSUID:
  • Atur user_id ke BSUID pengguna
  • Hilangkan objek user
BSUID induk tidak didukung untuk memblokir atau membuka blokir pengguna. Jika Anda mencoba menggunakan BSUID induk, permintaan akan gagal.

Memblokir atau membuka blokir tanggapan permintaan

Perubahan ini akan berlaku untuk tanggapan permintaan POST dan DELETE Blokir Pengguna.
{
  "messaging_product": "whatsapp",
  "block_users": {
    "added_users": [
      {
        "input": "<USER_PHONE_NUMBER>",  <!-- CHANGED -->
        "wa_id": "<USER_PHONE_NUMBER>",  <!-- CHANGED -->
        "user_id": "<BSUID>"             <!-- ADDED -->
      }
    ]
  }
}
  • input — Nilai baru (BSUID).
    • Akan diatur ke BSUID pengguna jika Anda menggunakan BSUID pengguna untuk memblokir atau membuka blokir pengguna.
    • Akan diatur ke nomor telepon pengguna jika Anda menggunakan nomor telepon pengguna untuk memblokir atau membuka blokir pengguna.
  • wa_id — Perilaku baru (dapat dihilangkan).
    • Akan dihilangkan jika Anda menggunakan BSUID pengguna untuk memblokir atau membuka blokir pengguna.
    • Akan diatur ke nomor telepon pengguna jika Anda menggunakan nomor telepon mereka saat memblokir atau membuka blokir pengguna.
  • user_id — Properti baru.
    • Akan diatur ke BSUID pengguna jika Anda menggunakan BSUID pengguna untuk memblokir atau membuka blokir pengguna.
    • Akan dihilangkan jika Anda menggunakan nomor telepon pengguna untuk memblokir atau membuka blokir pengguna.

Mendapatkan pengguna yang diblokir

Perubahan ini berlaku untuk tanggapan GET Block Users.
Sintaksis tanggapan:
{
  "data": [
    {
      "messaging_product": "whatsapp",
      "wa_id": "<USER_PHONE_NUMBER>",    <!-- CHANGED -->
      "user_id": "<BSUID>",             <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
      "parent_user_id": "<PARENT_BSUID>" <!-- ADDED -->
    }
  ],
  "paging": {
    "cursors": {
      "after": "<AFTER_CURSOR>",
      "before": "<BEFORE_CURSOR>"
    }
  }
}
  • wa_id — Akan diatur ke nomor telepon pengguna jika tersedia. Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
  • user_id — Properti baru. Akan diatur ke BSUID pengguna.
  • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Calling API

Permintaan telepon yang diinisiasi oleh bisnis

Perubahan tersebut berlaku untuk permintaan Calling API yang diinisiasi oleh bisnis.
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/calls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "to": "<USER_PHONE_NUMBER>",    <!-- CHANGED -->
  "recipient": "<BSUID>",         <!-- ADDED -->
  "action": "connect",
  "session": {
    "sdp_type": "offer",
    "sdp": "<RFC_4566_SDP>"
  }
}'
Anda dapat menyertakan to (nomor telepon) dan recipient (BSUID atau BSUID induk) dalam permintaan Anda. Jika Anda melakukannya, to (nomor telepon) akan diutamakan. Jika mau, Anda juga dapat menggunakan salah satunya:
Untuk memanggil pengguna hanya menggunakan nomor telepon mereka:
  • atur to ke nomor telepon pengguna
  • hilangkan properti recipient
Untuk memanggil pengguna hanya menggunakan BSUID atau BSUID induk:
  • atur recipient ke BSUID pengguna atau BSUID induk
  • hilangkan properti to

Mendapatkan izin telepon

Perubahan ini berlaku untuk permintaan izin dapatkan telepon. Tidak ada perubahan pada tanggapan.
Dapatkan izin telepon menggunakan nomor telepon pengguna:
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/call_permissions?user_wa_id=<USER_PHONE_NUMBER>' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
  • user_wa_id — Diatur ke nomor telepon pengguna.
Dapatkan izin telepon menggunakan BSUID pengguna atau BSUID induk:
curl 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/call_permissions?recipient=<BSUID>' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
  • recipient — Diatur ke BSUID pengguna atau BSUID induk.

Mengirim permintaan izin telepon

Webhooks permintaan izin menelepon

Perubahan ini akan berlaku untuk webhook pesan interaktif balasan izin telepon masuk.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_PROFILE_NAME>",

                  <!-- Only included if user has enabled the usernames feature -->
                  "username": "<USERNAME>"                <!-- ADDED -->

                },
                "wa_id": "<WHATSAPP_USER_ID>",            <!-- CHANGED -->
                "user_id": "<BSUID>",                     <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"        <!-- ADDED -->

              }
            ],
            "messages": [
              {
                "context": {
                  "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
                  "id": "<CONTEXTUAL_WHATSAPP_MESSAGE_ID>"
                },
                "from": "<WHATSAPP_USER_PHONE_NUMBER>",   <!-- CHANGED -->
                "from_user_id": "<BSUID>",                <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "from_parent_user_id": "<PARENT_BSUID>"   <!-- ADDED -->

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "interactive",
                "interactive": {
                  "type":  "call_permission_reply",
                  "call_permission_reply": {
                    "response": "<RESPONSE>",
                    "expiration_timestamp": "<EXPIRATION_TIMTESTAMP>",
                    "response_source": "<RESPONSE_SOURCE>"
                  }
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}
  • contacts
    • profile
      • username — Properti baru. Akan diatur ke nama pengguna jika pengguna telah menggunakan nama pengguna. Akan dihilangkan jika pengguna tidak menggunakan nama pengguna.
    • wa_id — Properti baru.
      • Akan dihilangkan jika pengguna telah mengadopsi nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon.
      • Akan diatur ke nomor telepon pengguna jika pengguna belum menggunakan nama pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • messages
    • from — Perilaku baru (dapat dihilangkan).
      • Akan diatur ke nomor telepon pengguna jika pengguna belum mengaktifkan fitur nama pengguna.
      • Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon.
    • from_user_id — Properti baru. Akan diatur ke BSUID pengguna.

Webhooks telepon terhubung yang diinisiasi oleh bisnis

Perubahan ini berlaku untuk webhook telepon terhubung yang diinisiasi oleh pelaku bisnis.
{
  "entry": [
    {
      "changes": [
        {
          "field": "calls",
          "value": {
            "contacts": [                                  <!-- ADDED -->
              {
                "profile": {
                  <!-- Only included if user has enabled the usernames feature -->
                  "username": "<USERNAME>"                 <!-- ADDED -->
                },
                "wa_id": "<USER_PHONE_NUMBER>",            <!-- ADDED -->
                "user_id": "<BSUID>",                      <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"         <!-- ADDED -->
              }
            ],
            "calls": [
              {
                "biz_opaque_callback_data": "<DATA>",
                "session": {
                  "sdp_type": "answer",
                  "sdp": "<SDP>"
                },
                "from": "<BUSINESS_PHONE_NUMBER>",
                "id": "<WHATSAPP_CALL_ID>",
                "to": "<USER_PHONE_NUMBER>",               <!-- CHANGED -->
                "to_user_id": "<BSUID>",                   <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "to_parent_user_id": "<PARENT_BSUID>",     <!-- ADDED -->

                "event": "connect",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "direction": "BUSINESS_INITIATED"
              }
            ],
            "metadata": {
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>",
              "display_phone_number": "<BUSINESS_PHONE_NUMBER>"
            },
            "messaging_product": "whatsapp"
          }
        }
      ],
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>"
    }
  ],
  "object": "whatsapp_business_account"
}
  • contacts — Array baru.
    • profile
      • username — Properti baru.
        • Akan diatur ke nama pengguna WhatsApp jika pengguna telah menggunakan nama pengguna.
        • Akan dihilangkan untuk webhooks pesan status terkirim, atau jika pengguna tidak menggunakan nama pengguna.
    • wa_id — Properti baru.
      • Akan dihilangkan jika pengguna telah mengadopsi nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon.
      • Akan diatur ke nomor telepon pengguna, jika Anda mengirim pesan ke nomor telepon pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna WhatsApp.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • calls
    • to — Perilaku baru (dapat dihilangkan). Akan diatur ke nomor telepon pengguna jika pengguna telah menggunakan nama pengguna dan kami dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan dalam bagian Nomor telepon. Jika tidak, akan dihilangkan.
    • to_user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • to_parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, properti akan dihilangkan seluruhnya.

Webhooks telepon terhubung yang diinisiasi oleh pengguna

Perubahan ini akan berlaku untuk webhooks telepon terhubung yang diinisiasi oleh pengguna.
{
  "entry": [
    {
      "changes": [
        {
          "field": "calls",
          "value": {
            "metadata": {
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>",
              "display_phone_number": "<BUSINESS_PHONE_NUMBER>"
            },
            "calls": [
              {
                "session": {
                  "sdp_type": "offer",
                  "sdp": "<SDP>"
                },
                "from": "<USER_PHONE_NUMBER>",             <!-- CHANGED -->
                "from_user_id": "<BSUID>",                 <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "from_parent_user_id": "<PARENT_BSUID>",   <!-- ADDED -->

                "id": "<WHATSAPP_CALL_ID>",
                "to": "<BUSINESS_PHONE_NUMBER>",
                "event": "connect",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "direction": "USER_INITIATED"
              }
            ],
            "contacts": [
              {
                "wa_id": "<USER_PHONE_NUMBER>",            <!-- CHANGED -->
                "profile": {
                  "name": "<USER_DISPLAY_NAME>",           <!-- ADDED --><!-- Only included if user has enabled usernames feature -->
                  "username": "<USERNAME>"                 <!-- ADDED -->

                },
                "user_id": "<BSUID>"                       <!-- ADDED -->,

                <!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"         <!-- ADDED -->
              }
            ],
            "messaging_product": "whatsapp"
          }
        }
      ],
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>"
    }
  ],
  "object": "whatsapp_business_account"
}
  • calls
    • from — Perilaku baru (dapat dihilangkan). Akan dihilangkan jika nama pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • from_user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • from_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • contacts
    • wa_id — Perilaku baru (dapat dihilangkan).
      • Akan dihilangkan jika pengguna telah mengadopsi nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • name — Properti baru. Akan diatur ke nama profil pengguna.
    • username — Properti baru. Jika pengguna telah menggunakan nama pengguna, properti akan diatur ke nama pengguna. Jika tidak, akan dihilangkan.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Webhooks telepon diakhiri yang diinisiasi oleh bisnis

Perubahan ini berlaku untuk webhook telepon diakhiri yang diinisiasi oleh bisnis.
{
  "entry": [
    {
      "changes": [
        {
          "field": "calls",
          "value": {
            "calls": [
              {
                "biz_opaque_callback_data": "<BUSINESS_OPAQUE_DATA>",
                "from": "<BUSINESS_PHONE_NUMBER>",
                "id": "<WHATSAPP_CALL_ID>",
                "to": "<USER_PHONE_NUMBER>",              <!-- CHANGED -->
                "to_user_id": "<BSUID>",                  <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "to_parent_user_id": "<PARENT_BSUID>",    <!-- ADDED -->

                "event": "terminate",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "direction": "BUSINESS_INITIATED",
                "status": "COMPLETED"
              }
            ],
            "metadata": {
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>",
              "display_phone_number": "<BUSINESS_PHONE_NUMBER>"
            },
            "contacts": [                                 <!-- ADDED -->
              {
                "profile": {
                <!-- Only included if user has enabled the usernames feature -->
                "username": "<USERNAME>"                 <!-- ADDED -->
                },
                "wa_id": "<USER_PHONE_NUMBER>",           <!-- ADDED -->
                "user_id": "<BSUID>",                     <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"        <!-- ADDED -->
              }
            ],
            "messaging_product": "whatsapp"
          }
        }
      ],
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>"
    }
  ],
  "object": "whatsapp_business_account"
}
  • calls
    • to — Perilaku baru (dapat dihilangkan). Akan diatur ke nomor telepon pengguna jika pengguna telah menggunakan nama pengguna dan kami dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan dalam bagian Nomor telepon. Jika tidak, akan dihilangkan.
    • to_user_id — Properti baru. Ini akan diatur ke BSUID pengguna.
    • to_parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • contacts — Array baru.
    • profile
      • username — Properti baru. Jika pengguna telah menggunakan nama pengguna, properti akan diatur ke nama pengguna. Jika tidak, akan dihilangkan.
    • wa_id — Properti baru. Akan diatur ke nomor telepon pengguna, jika panggilan yang diakhiri dilakukan ke nomor telepon pengguna. Jika tidak, akan dihilangkan.
    • user_id — Properti baru. Ini akan diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Webhooks telepon diakhiri yang diinisiasi oleh pengguna

Perubahan ini akan berlaku untuk webhooks telepon dihentikan yang diinisiasi oleh pengguna.
{
  "entry": [
    {
      "changes": [
        {
          "field": "calls",
          "value": {
            "metadata": {
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>",
              "display_phone_number": "<BUSINESS_PHONE_NUMBER>"
            },
            "calls": [
              {
                "duration": <CALL_DURATION>,
                "start_time": "<CALL_START_TIMESTAMP>",
                "biz_opaque_callback_data": "<BUSINESS_OPAQUE_DATA>",
                "end_time": "<CALL_END_TIMESTAMP>",
                "from": "<USER_PHONE_NUMBER>",             <!-- CHANGED -->
                "from_user_id": "<BSUID>",                 <!-- ADDED --><!-- Only included if you have enabled parent BSUIDs -->
                "from_parent_user_id": "<PARENT_BSUID>",   <!-- ADDED -->

                "id": "<WHATSAPP_CALL_ID>",
                "to": "<BUSINESS_PHONE_NUMBER>",
                "event": "terminate",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "direction": "USER_INITIATED",
                "status": "COMPLETED"
              }
            ],
            "contacts": [
              {
                "profile": {
                  "name": "<USER_PROFILE_NAME>"            <!-- ADDED --><!-- Only included if user has enabled the usernames feature -->
                  "username": "<USERNAME>"                 <!-- ADDED -->
                },
                "wa_id": "<USER_PHONE_NUMBER>",            <!-- CHANGED -->
                "user_id": "<BSUID>",                      <!-- ADDED --><!-- Only included if you have enabled parent BSUIDs -->
                "parent_user_id": "<PARENT_BSUID>"         <!-- ADDED -->
              }
            ],
            "messaging_product": "whatsapp"
          }
        }
      ],
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>"
    }
  ],
  "object": "whatsapp_business_account"
}
  • calls
    • from — Perilaku baru (dapat dihilangkan). Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • from_user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • from_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • contacts
    • profile
      • name — Properti baru. Ini akan diatur ke nama profil pengguna.
      • username — Properti baru. Jika pengguna telah menggunakan nama pengguna, properti akan diatur ke nama pengguna. Jika tidak, akan dihilangkan.
    • wa_id — Akan dihilangkan jika pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan dalam bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • user_id — Properti baru. Ini akan diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Webhooks status telepon yang diinisiasi oleh bisnis

Perubahan ini akan berlaku untuk webhooks status telepon yang diinisiasi oleh pelaku bisnis.
{
  "entry": [
    {
      "changes": [
        {
          "field": "calls",
          "value": {
            "statuses": [
              {
                "biz_opaque_callback_data": "<BUSINESS_OPAQUE_DATA>",
                "id": "<WHATSAPP_CALL_ID>",
                "type": "call",
                "status": "<STATUS>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "recipient_id": "<USER_PHONE_NUMBER>",         <!-- CHANGED -->
                "recipient_user_id": "<BSUID>",                <!-- ADDED --><!-- Only included if you have enabled parent BSUIDs -->
                "recipient_parent_user_id": "<PARENT_BSUID>"   <!-- ADDED -->
              }
            ],
            "metadata": {
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>",
              "display_phone_number": "<BUSINESS_PHONE_NUMBER>"
            },
            "contacts": [                                      <!-- ADDED -->
              {
                "profile": {
                  <!-- Only included if user has enabled the usernames feature -->
                  "username": "<USERNAME>"                     <!-- ADDED -->
                },
                "wa_id": "<USER_PHONE_NUMBER>",                <!-- ADDED -->
                "user_id": "<BSUID>",                          <!-- ADDED --><!-- Only included if you have enabled parent BSUIDs -->
                "parent_user_id": "<PARENT_BSUID>"             <!-- ADDED -->
              }
            ],
            "messaging_product": "whatsapp"
          }
        }
      ],
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>"
    }
  ],
  "object": "whatsapp_business_account"
}
  • statuses
    • recipient_id — Perilaku baru (dapat dihilangkan).
      • Akan dihilangkan jika pengguna telah mengadopsi nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • recipient_user_id — Properti baru. Ini akan diatur ke BSUID pengguna.
    • recipient_parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • contacts — Array baru.
    • profile
      • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.
    • wa_id — Properti baru. Akan diatur ke nomor telepon pengguna jika telepon dilakukan ke nomor telepon pengguna. Jika tidak, akan dihilangkan.
    • user_id — Properti baru. Ini akan diatur ke BSUID pengguna.
    • parent_user_id — Properti baru. Akan diatur ke BSUID induk pengguna jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Undangan SIP untuk telepon yang diinisiasi oleh bisnis

Perubahan ini berlaku untuk telepon yang diinisiasi oleh bisnis yang dilakukan menggunakan SIP.
<!-- BEGIN CHANGE -->
INVITE sip:<BSUID_OR_PHONE_NUMBER>@wa.meta.vc;transport=tls SIP/2.0
<!-- END CHANGE -->

Record-Route: <sip:+159.65.244.171:5061;transport=tls;lr;ftag=Kc9QZg4496maQ;nat=yes>
Via: SIP/2.0/TLS 159.65.244.171:5061;received=2803:6081:798c:93f8:5f9b:bfe8:300:0;branch=z9hG4bK0da2.36614b8977461b486ceabc004c723476.0;i=617261
Via: SIP/2.0/TLS 137.184.87.1:35181;rport=56533;received=137.184.87.1;branch=z9hG4bKQNa6meey5Dj2g
Max-Forwards: 69
From: <sip:+17125550259@meta-voip.example.com>;tag=Kc9QZg4496maQ

<!-- BEGIN CHANGE -->
To: <sip:<BSUID_OR_PHONE_NUMBER>@wa.meta.vc>
<!-- END CHANGE -->

Call-ID: dc2c5b33-1b81-43ee-9213-afb56f4e56ba
CSeq: 96743476 INVITE
Contact: <sip:mod_sofia@137.184.87.1:35181;transport=tls;swrad=137.184.87.1~56533~3>
User-Agent: SignalWire
Allow: INVITE, ACK, BYE, CANCEL, OPTIONS, MESSAGE, INFO, UPDATE, REGISTER, REFER, NOTIFY
Supported: timer, path, replaces
Allow-Events: talk, hold, conference, refer
Session-Expires: 600;refresher=uac
Min-SE: 90
Content-Type: application/sdp
Content-Disposition: session
Content-Length: 2427
X-Relay-Call-ID: dc2c5b33-1b81-43ee-9213-afb56f4e56ba
Remote-Party-ID: <sip:+17125550259@meta-voip.example.com>;party=calling;screen=yes;privacy=off
Content-Type: application/sdp
Content-Length:  2427

<!-- SDP omitted for brevity -->
  • <BSUID_OR_PHONE_NUMBER> — Akan menjadi BSUID pengguna atau BSUID induk jika telepon dilakukan ke BSUID pengguna atau BSUID induk, atau nomor telepon pengguna jika dikirim ke nomor teleponnya.

Undangan SIP untuk telepon yang diinisiasi oleh pengguna

Perubahan ini berlaku untuk telepon yang diinisiasi oleh pengguna yang dilakukan menggunakan SIP.
INVITE sip:+17015558857@meta-voip.example.com;transport=tls SIP/2.0
Via: SIP/2.0/TLS [2803:6080:e888:51aa:d4a4:c5e0:300:0]:33819;rport=33819;received=2803:6080:e888:51aa:d4a4:c5e0:300:0;branch=z9hG4bKPjNvs.IZBnUa1W4l8oHPpk3SUMmcx3MMcE;alias
Max-Forwards: 70

<!-- BEGIN CHANGE -->
From: "<BSUID_OR_PHONE_NUMBER>" <sip:<BSUID_OR_PHONE_NUMBER>@wa.meta.vc>;tag=bbf1ad6e-79bb-4d9c-8a2c-094168a10bea
<!-- END CHANGE -->

To: <sip:+17015558857@meta-voip.example.com>

<!-- BEGIN CHANGE -->
Contact: <sip:<BSUID_OR_PHONE_NUMBER>@wa.meta.vc;transport=tls;ob>;isfocus
<!-- END CHANGE -->

Call-ID: outgoing:wacid.HBgLMTIxOTU1NTA3MTQVAgASGCAzODg1NTE5NEU1NTBEMTc1RTFFQUY5NjNCQ0FCRkEzRhwYCzE3MDE1NTU4ODU3FQIAAA==
CSeq: 2824 INVITE
Route: <sip:onevc-sip-proxy-dev.fbinfra.net:8191;transport=tls;lr>
X-FB-External-Domain: wa.meta.vc

<!-- BEGIN ADDITION -->
x-wa-meta-user-id: <BSUID>
x-wa-meta-parent-user-id: <PARENT_BSUID>
x-wa-meta-username: <USERNAME><!-- END ADDITION -->

Allow: INVITE, ACK, BYE, CANCEL, NOTIFY, OPTIONS
User-Agent: Facebook SipGateway
Content-Type: application/sdp
Content-Length: 1028

<!-- SDP omitted for brevity -->
  • <BSUID> — Akan diatur ke BSUID pengguna.
  • <BSUID_OR_PHONE_NUMBER> — Akan menjadi BSUID pengguna atau BSUID induk jika panggilan dilakukan ke BSUID pengguna atau BSUID induk, atau jika pengguna telah menggunakan nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan dalam bagian Nomor telepon. Jika tidak, properti akan menjadi nomor telepon pengguna.
  • <PARENT_BSUID> — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • <USERNAME> — Akan menjadi nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.

Tanggapan SIP OK untuk telepon yang diinisiasi oleh bisnis

SIP/2.0 200 OK
Via: SIP/2.0/TLS 54.172.60.1:5061;received=2803:6080:f934:8894:7eb5:24f9:300:0;branch=z9hG4bK1e5a.0da2ace9cc912d9e5f2595ca4acb9847.0
Via: SIP/2.0/UDP 172.25.10.217:5060;rport=5060;branch=z9hG4bK5cdada8c-cbf0-4369-b02d-cc97d3c36f2b_c3356d0b_54-457463274351249162
Record-Route: <sip:onevc-sip-proxy.fbinfra.net:8191;transport=tls;lr>
Record-Route: <sip:wa.meta.vc;transport=tls;lr>
Record-Route: <sip:54.172.60.1:5061;transport=tls;lr;r2=on>
Record-Route: <sip:54.172.60.1;lr;r2=on>
Call-ID: f304a1d2cafb8139c1f9ff93a7733586@0.0.0.0

<!-- BEGIN CHANGE -->
From: "<BSUID_OR_PHONE_NUMBER>" <sip:<BSUID_OR_PHONE_NUMBER>@meta-voip.example.com>;tag=28460006_c3356d0b_5cdada8c-cbf0-4369-b02d-cc97d3c36f2b
<!-- END CHANGE -->

To: <sip:12195550714@wa.meta.vc>;tag=0d185053-2615-46c7-8ff2-250bda494cf1
CSeq: 2 INVITE
Allow: INVITE, ACK, BYE, CANCEL, NOTIFY, OPTIONS
Supported: timer
X-FB-External-Domain: wa.meta.vc

<!-- BEGIN CHANGE -->
<sip:<BSUID_OR_PHONE_NUMBER>@wa.meta.vc;transport=tls;ob;X-FB-Sip-Smc-Tier=collaboration.sip_gateway.sip.prod>;isfocus
<!-- END CHANGE --><!-- BEGIN ADDITION -->
x-wa-meta-user-id: <BSUID>
x-wa-meta-parent-user-id: <PARENT_BSUID>
x-wa-meta-username: <USERNAME><!-- END ADDITION -->

Content-Type: application/sdp
Content-Length:   645

<!-- SDP omitted for brevity -->
  • <BSUID> — Akan diatur ke BSUID pengguna.
  • <BSUID_OR_PHONE_NUMBER> — Akan menjadi BSUID pengguna atau BSUID induk jika panggilan dilakukan ke BSUID pengguna atau BSUID induk, atau jika pengguna telah menggunakan nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan dalam bagian Nomor telepon. Jika tidak, properti akan menjadi nomor telepon pengguna.
  • <PARENT_BSUID> — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • <USERNAME> — Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.

Tanggapan SIP BYE untuk panggilan yang dimulai bisnis dan pengguna

BYE sip:+12195550714@103.30.244.182:5061;transport=tls SIP/2.0
Via: SIP/2.0/TLS [2803:6080:e800:6746::]:56843;rport;branch=z9hG4bKPj65946b3e6f68128d52b6a498a8fd00a5;alias
Record-Route: <sip:wa.meta.vc;transport=tls;lr>
Record-Route: <sip:onevc-sip-proxy.fbinfra.net:8191;transport=tls;lr>
Via: SIP/2.0/TLS [2803:6080:e800:6746:3347:2251:14a4:a00]:5061;branch=z9hG4bKPj65946b3e6f68128d52b6a498a8fd00a5
Via: SIP/2.0/TLS [2803:6080:e934:3f82:b543:8a4d:1414:a00]:52767;rport=52767;received=2803:6080:e934:3f82:b543:8a4d:1414:a00;branch=z9hG4bKPj-D8BXdIVMqAUT9MIJIp78LxKUZNnjYKF;alias
Max-Forwards: 69

<!-- BEGIN CHANGE -->
From: <sip:<BSUID_OR_PHONE_NUMBER>@wa.meta.vc>;tag=0fb8b5f1-2703-49f4-a454-46b1bcb9bfac
<!-- END CHANGE -->

To: <sip:+12195550714@dev.moxcal.com>;tag=2c21fad0-c581-4e54-a707-3bd52abfcc3f
Call-ID: 21e38222-6fcb-4631-8e7d-5b94cf849c90
CSeq: 31641 BYE

<!-- BEGIN ADDITION -->
x-wa-meta-user-id: <BSUID>
x-wa-meta-parent-user-id: <PARENT_BSUID>
x-wa-meta-username: <USERNAME><!-- END ADDITION -->

X-FB-External-Domain: wa.meta.vc
Allow: INVITE, ACK, BYE, CANCEL, NOTIFY, OPTIONS
User-Agent: Facebook SipGateway
Content-Length:  0
  • <BSUID> — Akan diatur ke BSUID pengguna.
  • <BSUID_OR_PHONE_NUMBER> — Akan menjadi BSUID pengguna atau BSUID induk jika panggilan dilakukan ke BSUID pengguna atau BSUID induk, atau jika pengguna telah menggunakan nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan dalam bagian Nomor telepon. Jika tidak, properti akan menjadi nomor telepon pengguna.
  • <PARENT_BSUID> — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • <USERNAME> — Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.

Koeksistensi

Webhooks riwayat

Perubahan ini akan berlaku untuk webhooks riwayat yang mendeskripsikan riwayat obrolan aplikasi WhatsApp Business dari pelanggan bisnis yang telah diintegrasikan.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<CUSTOMER_WABA_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<CUSTOMER_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<CUSTOMER_PHONE_NUMBER_ID>"
            },
            "history": [
              {
                "metadata": {
                  "phase": <PHASE>,
                  "chunk_order": <CHUNK_ORDER>,
                  "progress": <PROGRESS>
                },
                "threads": [
                  /* First chat history thread object */
                  {
                    "id": "<WHATSAPP_USER_PHONE_NUMBER>",           <!-- CHANGED -->
                    "context": {                                    <!-- ADDED -->
                      "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>",      <!-- ADDED -->
                      "user_id": "<BSUID>",                         <!-- ADDED --><!-- Only included if parent BSUIDs enabled before sync request -->
                      "parent_user_id": "<PARENT_BSUID>",           <!-- ADDED --><!-- Only included if user has enabled usernames feature before sync request -->
                      "username": "<USERNAME>"                      <!-- ADDED -->

                    },
                    "messages": [
                      /* First message object in thread */
                      {
                        "from": "<BUSINESS_OR_WHATSAPP_USER_PHONE_NUMBER>",  <!-- CHANGED -->
                        "from_user_id" : "<BSUID>",                 <!-- ADDED --><!-- Only included if parent BSUIDs enabled before sync request -->
                        "from_parent_user_id": "<PARENT_BSUID>",    <!-- ADDED -->

                        "to": "<WHATSAPP_USER_PHONE_NUMBER>",
                        "id": "<WHATSAPP_MESSAGE_ID>",
                        "timestamp": "<DEVICE_TIMESTAMP>,
                        "type": "<MESSAGE_TYPE>",
                        "<MESSAGE_TYPE>": {
                          <MESSAGE_CONTENTS>
                        },
                        "history_context": {
                          "status": "<MESSAGE_STATUS>"
                        }
                      },
                      /* Additional message objects in thread would follow, if any */
                    ]
                  },
                  /* Additional chat history thread objects would follow, if any */
                ]
              }
            ]
          },
          "field": "history"
        }
      ]
    }
  ]
}
  • id — Perilaku baru (dapat dihilangkan). Akan dihilangkan jika, pada saat permintaan sinkronisasi riwayat, pengguna telah mengaktifkan nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
  • context — Objek konteks baru.
    • wa_id — Properti baru.
      • Akan dihilangkan jika, pada saat permintaan sinkronisasi, pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, maka akan dihilangkan.
    • username — Properti baru.
      • Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.
  • messages
    • from — Perilaku baru (dapat dihilangkan).
      • Akan dihilangkan jika, pada saat permintaan sinkronisasi, pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • from_user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • from_parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
Perubahan ini akan berlaku untuk webhooks riwayat yang menjelaskan aset media yang dikirim dari pengguna WhatsApp ke pelanggan bisnis, atau sebaliknya.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<CUSTOMER_WABA_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<CUSTOMER_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<CUSTOMER_PHONE_NUMBER_ID>"
            },
            "contacts": [                                          <!-- ADDED -->
              {

                <!-- Profile only included if user has enabled the usernames feature -->
                "profile": {
                  "username": "<USERNAME>",                        <!-- ADDED -->
                },
                "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>",           <!-- ADDED -->
                "user_id": "<BSUID>",                              <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"                        <!-- ADDED -->
              },
            ],

            <!-- Only for messages sent from a user to a business -->
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER>",            <!-- CHANGED -->
                "from_user_id": "<BSUID>",                         <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "from_parent_user_id": "<PARENT_BSUID>",           <!-- ADDED -->

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<ORIGINAL_WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "<MEDIA_TYPE>",
                "<MEDIA_TYPE>": {
                  <MEDIA_METADATA>
                }
              }
            ],

            <!-- Only for messages sent from a business to a user -->
            "message_echoes": [
              {
                "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
                "to": "<WHATSAPP_USER_PHONE_NUMBER>",              <!-- CHANGED -->
                "to_user_id": "<BSUID>",                           <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "to_parent_user_id": "<PARENT_BSUID>",             <!-- ADDED -->

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "<MESSAGE_TYPE>",
                "<MESSAGE_TYPE>": {
                  <MESSAGE_CONTENTS>
                }
              }
            ]

          },
          "field": "history"
        }
      ]
    }
  ]
}
  • contacts — Objek baru.
    • profile
      • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.
    • wa_id — Properti baru.
      • Akan dihilangkan jika, pada saat permintaan sinkronisasi, pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • messages
    • from — Perilaku baru (dapat dihilangkan).
      • Akan dihilangkan jika, pada saat permintaan sinkronisasi, pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • from_user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • from_parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • message_echoes
    • to — Perilaku baru (dapat dihilangkan).
      • Akan dihilangkan jika, pada saat permintaan sinkronisasi, pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan di bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • to_user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • to_parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Webhooks smb_message_echoes

Perubahan ini akan berlaku untuk webhooks smb_message_echoes.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [                                     <!-- ADDED -->
              {

                <!-- Only included if user has enabled the usernames feature -->
                "profile": {
                  "username": "<USERNAME>"                    <!-- ADDED -->
                },

                "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>",      <!-- ADDED -->
                "user_id": "<BSUID>",                         <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"            <!-- ADDED -->
              }
            ],
            "message_echoes": [
              {
                "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
                "to": "<WHATSAPP_USER_PHONE_NUMBER>",         <!-- CHANGED -->
                "to_user_id": "<BSUID>",                      <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                "to_parent_user_id": "<PARENT_BSUID>",        <!-- ADDED -->

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "<MESSAGE_TYPE>",
                "<MESSAGE_TYPE>": {
                  <MESSAGE_CONTENTS>
                }
              }
            ]
          },
          "field": "smb_message_echoes"
        }
      ]
    }
  ]
}
  • contacts — Array baru.
    • profile
      • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.
    • wa_id — Properti baru. Akan dihilangkan jika, pada saat pelanggan bisnis menggunakan aplikasi WhatsApp Business untuk mengirim pesan ke pengguna, pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan dalam bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • message_echoes
    • to — Perilaku baru (dapat dihilangkan). Akan dihilangkan jika, pada saat pelanggan bisnis menggunakan aplikasi WhatsApp Business untuk mengirim pesan ke pengguna, pengguna telah mengaktifkan fitur nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan kondisi yang dijelaskan dalam bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • to_user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • to_parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.

Webhooks smb_app_state_sync

Perubahan ini akan berlaku untuk webhooks smb_app_state_sync.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "state_sync": [
              {
                "type": "contact",
                "contact": {
                  "full_name": "<CONTACT_FULL_NAME>",
                  "first_name": "<CONTACT_FIRST_NAME>",
                  "phone_number": "<CONTACT_PHONE_NUMBER>",    <!-- CHANGED -->
                  "user_id": "<BSUID>",                        <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
                  "parent_user_id": "<PARENT_BSUID>",          <!-- ADDED --><!-- Only included if user has enabled the usernames feature -->
                  "username": "<USERNAME>"                     <!-- ADDED -->
                },
                "action": "<ACTION>",
                "metadata": {
                  "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>"
                }
              },
              <!-- Additional contacts would follow, if any -->
            ]
          },
          "field": "smb_app_state_sync"
        }
      ]
    }
  ]
}
  • phone_number — Perilaku baru (dapat dihilangkan). Akan dihilangkan jika, pada saat permintaan sinkronisasi, pengguna telah mengaktifkan nama pengguna dan kami tidak dapat menyertakan nomor telepon mereka berdasarkan ketentuan yang dijelaskan dalam bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
  • user_id — Properti baru. Akan diatur ke BSUID pengguna.
  • parent_user_id — Akan diatur ke BSUID induk pengguna, jika Anda mengaktifkan BSUID induk. Jika tidak, maka akan dihilangkan.
  • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.

Webhooks cabut pesan

Perubahan ini akan berlaku untuk webhooks pesan yang dibatalkan.
{
 "object": "whatsapp_business_account",
 "entry": [
   {
     "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
     "changes": [
       {
         "value": {
           "messaging_product": "whatsapp",
           "metadata": {
             "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
             "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
           },
           "contacts": [
             {
               "profile": {
                 "name": "<WHATSAPP_USER_PROFILE_NAME>",

                 <!-- Only included if user has enabled the usernames feature -->
                 "username": "<USERNAME>"            <!-- ADDED -->
               },
               "wa_id": "<WHATSAPP_USER_ID>",
               "user_id": "<BSUID>",                 <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
               "parent_user_id": "<PARENT_BSUID>"    <!-- ADDED -->
             }
           ],
           "messages": [
             {
               "from": "<WHATSAPP_USER_PHONE_NUMBER>",    <!-- CHANGED -->
               "from_user_id": "<BSUID>",                 <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
               "from_parent_user_id": "<PARENT_BSUID>",   <!-- ADDED -->

               "id": "<WHATSAPP_MESSAGE_ID>",
               "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
               "type": "revoke",
               "revoke": {
                 "original_message_id": "<ORIGINAL_WHATSAPP_MESSAGE_ID>"
               }
             }
           ]
         },
         "field": "messages"
       }
     ]
   }
 ]
}
  • contacts
    • profile
      • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Akan diatur ke BSUID induk pengguna jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • messages
    • from — Perilaku baru (dapat dihilangkan). Akan diatur ke nomor telepon pengguna jika nomor telepon dapat disertakan berdasarkan kondisi yang dijelaskan di bagian Nomor telepon. Jika tidak, akan dihilangkan.
    • from_user_id — Properti baru, diatur ke BSUID pengguna.
    • from_parent_user_id — Properti baru, diatur ke BSUID induk pengguna, jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
Ketika pelanggan bisnis membatalkan pesan menggunakan aplikasi WhatsApp Business, pembatalan dikirimkan sebagai webhook smb_message_echoes dengan objek revoke.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                <!-- Only included if user has enabled the usernames feature -->
                "profile": {
                  "username": "<USERNAME>"
                },
                "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>",
                "user_id": "<BSUID>",

                <!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"
              }
            ],
            "message_echoes": [
              {
                "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
                "to": "<WHATSAPP_USER_PHONE_NUMBER>",
                "to_user_id": "<BSUID>",

                <!-- Only included if parent BSUIDs enabled -->
                "to_parent_user_id": "<PARENT_BSUID>",

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "revoke",
                "revoke": {
                  "original_message_id": "<ORIGINAL_WHATSAPP_MESSAGE_ID>"
                }
              }
            ]
          },
          "field": "smb_message_echoes"
        }
      ]
    }
  ]
}
  • Kolom pengidentifikasi contacts dan message_echoes (username, wa_id, user_id, parent_user_id, to, to_user_id, to_parent_user_id) berperilaku sama seperti yang dijelaskan dalam bagian smb_message_echoes webhooks.
  • message_echoes
    • recoke — Pesan yang dicabut, dalam format yang sama dengan objek recoke di webhook pesan pencabutan konsumen di atas.

Webhooks edit pesan

Perubahan ini akan berlaku untuk webhooks pesan edit.
{
 "object": "whatsapp_business_account",
 "entry": [
   {
     "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
     "changes": [
       {
         "value": {
           "messaging_product": "whatsapp",
           "metadata": {
             "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
             "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
           },
           "contacts": [
             {
               "profile": {
                 "name": "<WHATSAPP_USER_PROFILE_NAME>",

                 <!-- Only included if the user has enabled usernames -->
                 "username": "<USERNAME>"              <!-- ADDED -->
               },
               "wa_id": "<WHATSAPP_USER_ID>",          <!-- CHANGED -->
               "user_id": "<BSUID>",                   <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
               "parent_user_id": "<PARENT_BSUID>"      <!-- ADDED -->
             }
           ],
           "messages": [
             {
               "from": "<WHATSAPP_USER_PHONE_NUMBER>",    <!-- CHANGED -->
               "from_user_id": "<BSUID>",                 <!-- ADDED --><!-- Only included if parent BSUIDs enabled -->
               "from_parent_user_id": "<PARENT_BSUID>",   <!-- ADDED -->

               "id": "<WHATSAPP_MESSAGE_ID>",
               "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
               "type": "edit",
               "edit": {
                 "original_message_id": "<ORIGINAL_WHATSAPP_MESSAGE_ID>",
                 "message": {
                   "context": {
                     "id": "<CONTEXT_ID>"
                   },
                   "type": "image",
                   "image": {
                     "caption": "<MEDIA_ASSET_CAPTION>",
                     "mime_type": "<MEDIA_ASSET_MIME_TYPE>",
                     "sha256": "<MEDIA_ASSET_SHA256_HASH>",
                     "id": "<MEDIA_ASSET_ID>",
                     "url": "<MEDIA_ASSET_URL>"
                   }
                 }
               }
             }
           ]
         },
         "field": "messages"
       }
     ]
   }
 ]
}
  • contacts
    • profile
      • username — Properti baru. Akan diatur ke nama pengguna, jika pengguna telah mengaktifkan fitur nama pengguna. Jika tidak, akan dihilangkan.
    • wa_id — Properti baru. Akan dihilangkan jika, pada saat pengguna WhatsApp mengedit pesan, pengguna telah mengaktifkan fitur nama pengguna dan nomor telepon tidak bisa disertakan berdasarkan kondisi yang dijelaskan dalam bagian Nomor telepon. Jika tidak, itu akan diatur ke nomor telepon pengguna.
    • user_id — Properti baru. Akan diatur ke BSUID pengguna.
    • parent_user_id — Akan diatur ke BSUID induk pengguna jika Anda mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
  • messages
    • from — Perilaku baru (dapat dihilangkan). Akan diatur ke nomor telepon pengguna jika nomor telepon dapat disertakan berdasarkan kondisi yang dijelaskan di bagian Nomor telepon. Jika tidak, akan dihilangkan.
    • from_user_id — Properti baru, diatur ke BSUID pengguna.
    • from_parent_user_id — Properti baru, diatur ke BSUID induk pengguna, jika Anda telah mengaktifkan BSUID induk. Jika tidak, akan dihilangkan.
Ketika pelanggan bisnis mengedit pesan menggunakan aplikasi WhatsApp Business, edit dikirimkan sebagai smb_message_echoes webhook dengan objek edit. Contoh syntax di bawah ini adalah untuk pesan image yang diedit.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                <!-- Only included if user has enabled the usernames feature -->
                "profile": {
                  "username": "<USERNAME>"
                },
                "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>",
                "user_id": "<BSUID>",

                <!-- Only included if parent BSUIDs enabled -->
                "parent_user_id": "<PARENT_BSUID>"
              }
            ],
            "message_echoes": [
              {
                "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
                "to": "<WHATSAPP_USER_PHONE_NUMBER>",
                "to_user_id": "<BSUID>",

                <!-- Only included if parent BSUIDs enabled -->
                "to_parent_user_id": "<PARENT_BSUID>",

                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                "type": "edit",
                "edit": {
                  "original_message_id": "<ORIGINAL_WHATSAPP_MESSAGE_ID>",
                  "message": {
                    "context": {
                      "id": "<CONTEXT_ID>"
                    },
                    "type": "image",
                    "image": {
                      "caption": "<MEDIA_ASSET_CAPTION>",
                      "mime_type": "<MEDIA_ASSET_MIME_TYPE>",
                      "sha256": "<MEDIA_ASSET_SHA256_HASH>",
                      "id": "<MEDIA_ASSET_ID>",
                      "url": "<MEDIA_ASSET_URL>"
                    }
                  }
                }
              }
            ]
          },
          "field": "smb_message_echoes"
        }
      ]
    }
  ]
}
  • Kolom pengidentifikasi contacts dan message_echoes (username, wa_id, user_id, parent_user_id, to, to_user_id, to_parent_user_id) berperilaku sama seperti yang dijelaskan dalam bagian smb_message_echoes webhooks.
  • message_echoes
    • edit — Pesan yang diedit, dalam format yang sama dengan objek edit di webhook pesan edit konsumen di atas.

Analitik

Tidak ada perubahan.

Tagihan dan invoice

Tidak ada perubahan.

Pertanyaan Umum

Apa yang harus saya lakukan untuk mendukung nama pengguna?
BSUID dan BSUID induk mulai muncul di payload webhooks pada bulan April 2026, sebelum nama pengguna tersedia untuk pengguna WhatsApp. Untuk memproses pesan dari pengguna yang mengaktifkan fitur tersebut setelah tersedia, Anda perlu mendukung BSUID (dan BSUID induk jika Anda mengaktifkannya). Untuk melakukannya, Anda harus:
  • Perbarui integrasi webhook Anda untuk mendukung BSUID (dan BSUID induk, jika menggunakan).
  • Buat logika untuk mendukung penanganan beberapa pengidentifikasi (nomor telepon dari pengguna yang bukan pengguna nama pengguna, BSUID dari pengguna nama pengguna jika nomor telepon tidak ada di webhooks), dan memetakan kolom yang relevan kembali ke CRM/database Anda.
  • Perbarui sistem internal dan eksternal yang terkait dengan terintegrasi ini untuk dapat menangani BSUID dan bergabung dengan pengidentifikasi sebelumnya; terutama CRM (baik 3P atau basis data internal) dan alat atau alur kerja apa pun yang dipicu dari CRM (misalnya, pesan kampanye yang memicu, manajemen kampanye, pengukuran, penagihan, dan sebagainya).
  • Jika Anda masih memerlukan nomor telepon pelanggan, perbarui bot/perjalanan berkirim pesan Anda (jika digunakan) untuk meminta nomor telepon, menangani skenario ketika pengguna tidak membagikan nomor telepon, dan mengulangi perjalanan percakapan baru ini.
  • Jika Anda memiliki beberapa portofolio bisnis di Meta, Anda mungkin ingin menerapkan solusi untuk memungkinkan akses CRM pusat di beberapa portofolio, guna meminimalkan biaya operasional yang terkait dengan penggunaan dan penyimpanan BSUID (dan BSUID induk).
Kapan saya akan menerima BSUID atau BSUID induk vs. nomor telepon?
Saat pengguna menggunakan nama pengguna, mereka akan memiliki privasi nomor telepon yang berarti nomor telepon mereka tidak akan ditampilkan di aplikasi, dan nomor telepon mereka tidak akan disertakan dalam webhooks. Jika nomor telepon pengguna tidak ada (properti wa_id tidak ada), Anda dapat menggunakan BSUID mereka (atau BSUID induk, jika menggunakan), yang akan disertakan dan ditetapkan ke properti user_id baru (parent_user_id untuk BSUID induk).
Jika pengguna belum menggunakan nama pengguna, Anda akan menerima nomor telepon dan BSUID mereka (dan BSUID induk, jika diaktifkan).
Perhatikan bahwa nomor telepon akan terus dibagikan jika kondisi-kondisi tertentu terpenuhi. Nomor telepon dan data terkait disimpan selama maksimal 30 hari untuk mendukung fitur seperti pengiriman ulang pesan. Mungkin ada situasi di mana Anda menerima pesan dari pengguna yang ada di luar jendela 30 hari ini, yang mungkin terlihat seperti thread pengguna baru bagi Anda. Oleh karena itu, sangat penting untuk memulai dukungan BSUID sesegera mungkin, agar dapat meminimalkan kehilangan konteks percakapan.
Mengapa mitra dan bisnis yang terintegrasi langsung yang menggunakan Platform WhatsApp Business, dan pengguna yang telah terintegrasi langsung dengan pengiklan iklan yang mengarahkan ke WhatsApp, harus menggunakan BSUID?
Mitra dan bisnis harus mengadopsi BSUID untuk terus memproses pesan masuk dari pengguna nama pengguna WhatsApp. Setelah BSUID diadopsi dan pesan pengguna dari pengguna pengadopsi nama pengguna diproses, webhooks pesan tidak akan lagi memasukkan nomor telepon dalam beberapa kasus sebagai bagian dari webhook seperti wa_id, sehingga siapa pun yang menggunakan Platform WhatsApp Business harus memastikan semua sistem yang terhubung dapat menangani BSUID. Mereka juga akan dapat meminta nomor telepon pengguna dalam utas.
Jika saya belum menggunakan BSUID dan mulai menerima pesan dari pengguna yang menggunakan nama pengguna yang tidak dapat saya proses, apakah ada jalan lain?
Jika Anda belum menggunakan BSUID dan tidak dapat memproses pesan dari pengguna yang telah menggunakan nama pengguna, tidak akan ada tindakan pemulihan atau korektif yang dapat Anda ambil.
Untuk pesan dari pelanggan baru: Webhooks akan terus dikirim untuk pesan yang masuk. Tergantung pada perincian penerapan, hal ini dapat memengaruhi sistem Anda yang tidak dilengkapi untuk menangani pesan masuk tanpa nomor telepon pengguna, dan BSUID yang ditetapkan ke kolom user_id baru. Untuk pesan dari pelanggan yang ada: nomor telepon akan terus disertakan jika kondisi yang dijelaskan dalam bagian Nomor telepon terpenuhi.
Setelah Anda mendukung BSUID, minta nomor telepon dari pengguna dengan menerapkan tombol permintaan nomor telepon.
Apa perbedaan nama pengguna bisnis dengan nama tampilan? Kapan pengguna akan melihat nama pengguna bisnis vs nama tampilan?
Nama pengguna bisnis akan menyediakan kemampuan bagi pengguna untuk menjangkau bisnis dengan nama pengguna bisnis, yang berarti pengguna akhir dapat mencari nama pengguna bisnis menggunakan nama pengguna mereka yang tepat dan menjangkau bisnis tersebut. Karena pengguna akhir tidak dapat mencari berdasarkan nama tampilan, nama pengguna bisnis menawarkan keuntungan yang jelas sebagai pengidentifikasi unik yang dapat dicari agar pengguna dapat menemukan bisnis yang tepat dengan andal.
Nama pengguna bisnis harus mengikuti aturan pemformatan tertentu tentang panjang dan karakter yang diizinkan, sedangkan nama tampilan memiliki lebih banyak ruang dalam hal pemformatan.
Nama pengguna bisnis bersifat unik dan terikat secara pribadi dengan nomor telepon, yang berarti @JaspersMarket akan terikat dengan satu nomor telepon sementara @JaspersMarketCustomerSupport akan terikat dengan nomor telepon lain. Nama tampilan tidak terikat secara pribadi dengan nomor telepon, yang berarti nama tampilan Jasper's Market dapat memiliki 10 nomor telepon dengan nama tampilan ini.
Ketika sebuah bisnis memiliki nama pengguna dan nama tampilan, nama tampilan akan ditampilkan terlebih dahulu (misalnya di Profil, daftar obrolan, Pesan, dan lain sebagainya), agar bisnis membangun kepercayaan kepada pengguna dan agar pengguna mengenali bisnis tersebut ketika bisnis menjangkau pengguna.

Catatan perubahan dokumen

11 Agustus 2026

  • Memperbaiki webhooks user_id_update: user_id_update bukanlah kolom webhook yang dapat dijadikan langganan dan tidak muncul di Dasbor Aplikasi. Perubahan BSUID dikirimkan di kolom messages sebagai webhook pesan sistem. Menghapus user_id_update contoh payload dan daftar properti.
  • Menambahkan user_changed_user_id ke webhooks pesan sistem. Ketika BSUID pengguna berubah dan tidak ada nomor telepon yang dapat dibagikan dengan Anda, perubahan sekarang dilaporkan sebagai pesan sistemnya sendiri yang membawa system.previous_user_id dan system.previous_parent_user_id bersama dengan nilai-nilai baru.
  • Menambahkan system.previous_user_id dan system.previous_parent_user_id ke user_changed_numbersystem messages webhooks. Perubahan nomor telepon juga menumbuhkan BSUID, sehingga nilai-nilai sebelumnya sekarang dilaporkan pada kedua jenis pesan sistem.
  • Memperbaiki system messages webhookssystem.type nilai untuk perubahan nomor telepon: itu adalah user_changed_number, bukan user_changed_user_id.
  • Memperbaiki system messages webhookssystem.body string untuk perubahan nomor telepon: berisi nomor telepon lama dan baru pengguna, bukan BSUID lama dan baru mereka.

29 Juni 2026

12 Juni 2026

  • Menambahkan from_user_id dan from_parent_user_id ke recoke pesan webhooks contoh payload (yang sebelumnya terdaftar di changelog 5 Mei 2025 tetapi hilang dari contoh), dan menambahkan smb_message_echoes contoh untuk pesan yang dicabut oleh pelanggan bisnis menggunakan aplikasi WhatsApp Business.
  • Menambahkan from_user_id dan from_parent_user_id ke edit pesan webhooks payload, dan menambahkan smb_message_echoes contoh untuk pesan yang diedit oleh pelanggan bisnis menggunakan aplikasi WhatsApp Business.

10 Juni 2030

  • Memperbarui mengadopsi atau mengubah nama pengguna bisnis: menambahkan parameter transfer_action opsional (none, force_transfer) untuk mentransfer nama pengguna dari nomor telepon bisnis lain dalam portofolio bisnis yang sama, dan mendokumentasikan kode kesalahan 147005 baru yang ditampilkan ketika transfer diperlukan tetapi tidak diminta.

28 Mei 2026

11 Mei 2026

  • Perbaikan contoh kode menggunakan template: melakukan hardcode teks tombol REQUEST_CONTACT_INFO menjadi “Bagikan Info Kontak” daripada menggunakan <BUTTON_LABEL_TEXT> placeholder, yang menyesatkan karena teks tombol ini tidak dapat disesuaikan.

7 Mei 2026

  • Perbaikan bagian buku kontak: menjelaskan bahwa data buku kontak hanya digunakan untuk mengisi payload webhook, bukan tanggapan API.

5 Mei 2026

4 Mei 2026

9 April 2026

  • Perbaikan deskripsi kolom webhooks pesan status dan contoh kedua: perbaikan parent_user_id menjadi parent_recipient_user_id di blok statuses agar sesuai dengan konvensi penamaan recipient_id/recipient_user_id. Kolom parent_user_id dalam blok contacts tidak berubah.
  • Penambahan parent_recipient_user_id ke tabel referensi cepat webhooks status pesan keluar.

31 Maret 2026

  • Tanggal peluncuran webhook BSUID diperbarui dari 31 Maret ke awal April 2026.
  • Pembaruan batasan buku kontak: Bisnis Penyimpanan Lokal sekarang otomatis memiliki nomor telepon yang diambil dari vCard bersama dan disimpan dalam buku kontak di pusat data Meta.
  • Pembaruan meminta nomor telepon dari pengguna: menghapus pengecualian Penyimpanan Lokal yang mengharuskan pengiriman pesan secara manual; diganti dengan perilaku ekstraksi nomor telepon vCard otomatis.
  • Pembaruan petunjuk pengujian webhook dengan jalur navigasi Dasbor Aplikasi yang telah diperbaiki.
  • Penambahan peringatan ketersediaan ke bagian mengadopsi atau mengubah nama pengguna bisnis.

23 Maret 2026

  • Perbaikan deskripsi tanggapan kirim pesan dan tanggapan kirim pesan marketinguser_id: ketika nomor telepon dan BSUID atau induk BSUID disertakan dalam permintaan, tanggapan tidak akan menyertakan user_id, karena nomor telepon diutamakan dan tanggapannya identik dengan permintaan nomor telepon saja. Pembaruan contoh tanggapan untuk kasus nomor telepon dan BSUID dengan sesuai.

18 Maret 2026

18 Februari 2026

6 Februari 2026

  • Perubahan jumlah karakter alfanumerik yang membentuk BSUID dari 256 menjadi 128 karakter alfanumerik.
  • Perubahan cara menggunakan BSUID untuk mengirim pesan; BSUID sekarang harus ditetapkan ke properti/kolom khusus dalam permintaan pengiriman pesan (bukan properti/kolom yang ada yang mendukung BSUID dan nomor telepon).
  • Perubahan bagaimana kode negara akan muncul dalam webhooks: kode negara ini akan menjadi awalan dari BSUID pengguna, bukannya ditetapkan ke properti webhook khusus.
  • Penambahan informasi BSUID induk yang dapat digunakan di seluruh portofolio bisnis yang tertaut.
  • Penambahan informasi buku kontak yang dapat secara otomatis menyimpan nomor telepon pengguna dan BSUID.
  • Penambahan informasi tombol permintaan nomor telepon.
  • Perubahan contoh sintaksis, contoh payload, dan deskripsi untuk semua webhooks yang menampilkan string kosong jika pengguna telah mengaktifkan fitur nama pengguna. Sekarang, properti ini tidak akan diatur ke string kosong. Properti ini malah akan dihilangkan (misalnya: properti wa_id dalam webhooks pesan masuk).
  • Perubahan bagaimana kesalahan ditampilkan ketika mencoba mengadopsi atau mengubah nama pengguna bisnis.
  • Perubahan sintaksis tanggapan untuk mendapatkan nama pengguna bisnis saat ini.
  • Penghapusan kemampuan untuk membatalkan permintaan nama pengguna bisnis yang tertunda.
  • Perubahan webhook phone_number_username_update ke webhook business_username_updates.