Dokumen ini merupakan catatan perubahan pada Platform WhatsApp Business.
Cloud API
Cloud API
Semua API
API Pengelolaan Bisnis
Cloud API, perubahan versi 21.0
package_name
dan signature_hash
harus ditetapkan dalam array supported_apps
saat membuat template autentikasi pengisian otomatis sekali ketuk dan tanpa ketuk.storage_configuration
ke endpoint POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/pengaturan, yang dapat digunakan untuk mengaktifkan atau menonaktifkan penyimpanan lokal.data_localization_region
dari endpoint POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/daftar.Cloud API
Cloud API
Cloud API
Cloud API
Cloud API
Cloud API
API Pengelolaan Bisnis
Cloud API
Cloud API, On-Premises API
Cloud API
biz_opaque_callback_data
dari 256 ke 512.API Pengelolaan Bisnis
cta_url_link_tracking_opted_out
di node Template Pesan WhatsApp untuk mengaktifkan/menonaktifkan pelacakan klik tombol.UTILITY
.API Pengelolaan Bisnis
Cloud API
health_status
ke berbagai node guna memeriksa status kesehatan pengiriman pesan.biz_opaque_callback_data
ke pesan bentuk bebas untuk memasukkan string arbitrer ke webhooks pesan.API Pengelolaan Bisnis
Business Management API, Cloud API, On-Premises API
Alur
Cloud API
data_localization_region
baru di endpoint Nomor Telepon WhatsApp Business > Pendaftaran untuk mengaktifkan penyimpanan lokal.Business Management API, Cloud API, On-Premises API
code_expiration_minutes
(dan bukan default 10 menit) untuk menentukan apakah pesan template yang tersampaikan harus menampilkan tombol isi otomatis atau tombol salin kode.code_expiration_minutes
template jika ada (atau setelah 10 menit, jika tidak ada).Cloud API
limited_time_offer
baru.Cloud API
ctwa_clid
ke objek referral
di webhooks pesan. Menunjukkan ID klik yang dibuat saat pengguna mengetuk iklan yang mengeklik ke WhatsApp untuk mengirim pesan.Cloud API, On-Premises API
API Pengelolaan Bisnis
add_security_recommendation
dan code_expiration_minutes
di nilai component
.200
jika pengguna yang diidentifikasi dengan token belum diberikan Akses Akun WhatsApp Business yang sesuai.Cloud API
Cloud API, On-Premises API
Cloud API, On-Premises API
Fitur
API Pengelolaan Bisnis
Pendaftaran Tersemat
API Pengelolaan Bisnis
VERIFIED
selama 28 hari (naik dari 14 hari).Cloud API
Pengelolaan Bisnis
Fitur
Pengelolaan Bisnis
2494100
API Pengelolaan Bisnis yang menunjukkan nomor telepon bisnis untuk sementara berada dalam mode pemeliharaan.Cloud API
Fitur
Cloud API
132015
dan bukan 132001
.132016
dan bukan 132001
.On-Premises API
2061
.2062
.API Pengelolaan Bisnis
Cloud API
On-Premises API
API Pengelolaan Bisnis
account_alerts
.AUTHENTICATION
, MARKETING
, atau UTILITY
.API Pengelolaan Bisnis
hsm_id
ke endpoint DELETE Akun WhatsApp Business > Template Pesan. Jika disertakan, menghapus satu template yang cocok dengan ID yang disediakan (bukan menghapus semua template yang cocok dengan nama yang disediakan).Cloud API
last_onboarded_time
ke node Nomor Telepon WhatsApp Business. Menunjukkan kapan pengguna membuat nomor telepon bisnis di akun WhatsApp Business dengan menyelesaikan alur Pendaftaran Tersemat.Cloud API
Pendaftaran Tersemat
Business Management API, Cloud API, On-Premises API
allow_category_change
ke endpoint POST Akun WhatsApp Business > Template Pesan.INCORRECT_CATEGORY
sebagai nilai reason
penolakan yang baru untuk Webhooks status template.previous_category
ke Template Pesan WhatsApp.API Pengelolaan Bisnis
template_category_update
kolom langganan webhook. Jika berlangganan kolom ini, kapan saja ada perubahan kategori template, Anda akan menerima Webhooks yang menunjukkan kategori template sebelumnya dan yang baru.Cloud API
On-Premises API
Cloud API, On-Premises API
API Pengelolaan Bisnis
Cloud API, On-Premises API
Business Management API, Cloud API
Cloud API
AUTHENTICATION
MARKETING
UTILITY
code
dan details
sebagai gantinya."code":100
) memiliki beberapa judul unik yang menunjukkan sifat dari kode kesalahan 100 tertentu. Semua judul kode kesalahan 100 sekarang akan menggunakan Invalid parameter
sebagai judulnya. Judul-judul lama yang mendeskripsikan sifat dari kode kesalahan 100 tertentu telah dipindahkan ke properti details
. Perubahan ini juga sekarang tecermin dalam payload webhooks yang mendeskripsikan tanggapan kode kesalahan 100.Webhooks Cloud API
errors
di webhooks yang dipicu oleh kesalahan permintaan v16.0+ kini menyertakan properti message
serta error_data.details
. Nilai title
telah berubah untuk beberapa kode kesalahan. Sekarang, objek errors
memiliki struktur dan data berikut:[ { "code": <CODE>, "title" : "<TITLE>", "message": "<MESSAGE>", "error_data": { "details": "<DETAILS>" } }, ... ]
title
telah diperbarui untuk kode kesalahan berikut. Nilai-nilai lama mereka kini muncul di error_data.details
.
130470
sekarang adalah Re-engagement message
130429
sekarang adalah Rate limit hit
131045
sekarang adalah Incorrect certificate
131031
sekarang adalah Business Account locked
131053
sekarang adalah Media upload error
131027
sekarang adalah Something went wrong
131042
sekarang adalah Business eligibility payment issue
131026
sekarang adalah Message Undeliverable
131000
sekarang adalah Something went wrong
message
masih sama seperti nilai properti title
, yang menunjukkan judul kode kesalahan. Properti ini terpetakan ke properti message
di payload tanggapan kesalahan API.error_data.details
sekarang menyertakan judul kode kesalahan dari kode kesalahan yang tercantum di atas dan menjelaskan penyebab dasar kesalahan. Nilai ini terpetakan ke properti details
di payload tanggapan kesalahan API.Perubahan ini tecermin di properti errors
berikut di Webhooks terkait kesalahan:
entry.changes.value.errors
entry.changes.value.messages.errors
entry.changes.value.statuses.errors
Cloud API
Bisnis yang belum terverifikasi kini dapat memulai hingga 250 percakapan dalam periode 24 jam.
Berlaku untuk semua versi Cloud API.
Menambahkan kolom phone_number_id
opsional baru ke endpoint Media. Jika Anda menyertakan parameter ini dan ID nomor telepon bisnis, operasi hanya akan diproses jika ID nomor telepon cocok dengan ID nomor telepon tempat media diunggah.
Caching media HTTP Cloud API sudah bukan beta dan tersedia bagi semua orang.
Cloud API sekarang akan mencoba kembali mengirimkan notifikasi Webhooks yang gagal hingga 7 hari, bukan hingga 30 hari. Lihat Kegagalan Penyampaian Webhooks.
Berlaku untuk semua versi.
template_performance_metrics
baru. Memberi tahu Anda semua metrik kinerja template per pekan, termasuk jumlah pesan yang dikirim, jumlah pesan yang dibuka, dan alasan utama pemblokiran.Berlaku untuk semua versi.
Kolom account_alerts
baru:
account_alerts
baru. Memberi tahu Anda tentang peringatan Bisnis, Akun WhatsApp Business, dan nomor telepon bisnis.Nilai kolom account_update
baru:
account_update.events
baru: ACCOUNT_DELETED
. Menunjukkan bahwa nomor telepon telah dibatalkan pendaftarannya atau telah dihapus dari Akun WhatsApp Business.message_template_status_update.events
baru: PENDING_DELETION
. Menunjukkan template pesan telah ditandai akan dihapus.Contoh notifikasi Webhooks yang dikirim saat peristiwa baru ini dipicu:
ACCOUNT_DELETED
: Akun WhatsApp Business DihapusPENDING_DELETION
: Pesan Template Menunggu PenghapusanMenambahkan kolom node Akun WhatsApp Business berikut:
country
(berlaku untuk v15.0+
)ownership_type
(berlaku untuk v15.0+
)business_verification_status
(berlaku untuk semua versi)Berlaku untuk v15.0+.
Menambahkan opsi filter berikut ke endpoint Akun WhatsApp Business Klien Bisnis:
creation_time
Akun WhatsApp Business menggunakan operator GREATER_THAN
, LESS_THAN
, atau IN_RANGE
.ownership_type
Akun WhatsApp Business menggunakan operator EQUAL
atau IN
.Menambahkan opsi filter berikut ke endpoint Akun WhatsApp Business Milik Bisnis:
creation_time
Akun WhatsApp Business menggunakan operator GREATER_THAN
, LESS_THAN
, atau IN_RANGE
.ownership_type
menggunakan operator EQUAL
atau IN
.country
Akun WhatsApp Business menggunakan operator EQUAL
atau IN
.Berlaku untuk v15.0+
Menambahkan kolom node Nomor Telepon WhatsApp Business berikut:
is_official_business_account
messaging_limit_tier
Selain itu, Anda dapat memfilter endpoint Nomor Telepon Akun WhatsApp Business berdasarkan is_official_business_account
.
Cloud API sekarang mendukung hingga 500 (naik dari 350) pesan per detik (mps) kombinasi pesan teks dan media, berdasarkan permintaan. Lihat Throughput untuk detailnya.
Jika Anda sudah memiliki 350 mps, itu akan meningkat menjadi 500 mps secara otomatis. Jika Anda sudah meminta 350 mps tetapi prosesnya belum selesai, Anda akan menerima 500 mps setelah selesai.
Kami sekarang sedang melakukan pengujian beta caching HTTP media Cloud API. Jika Anda adalah Partner Solusi, lihat Caching HTTP Media untuk mempelajari cara menggunakan judul dalam tanggapan server Anda yang meminta kami melakukan cache aset media Anda untuk digunakan kembali dengan pesan di masa mendatang.
Cloud API sekarang mendukung keterangan pada dokumen yang dikirim dan diterima dari pelanggan. Lihat Objek Media di referensi Media.
Akun WhatsApp Business sekarang dapat memiliki hingga 6.000 template pesan jika bisnis induk mereka telah terverifikasi dan setidaknya salah satu Akun WhatsApp Business induk memiliki nomor telepon bisnis dengan nama tampilan yang disetujui.
Sebagai bagian dari perubahan ini, versi terjemahan dari template pesan sekarang dihitung terhadap batas template akun WhatsApp Business.
Bisnis di India sekarang dapat menggunakan kartu kredit untuk membayar pesan yang dikirim menggunakan platform. Lihat Menambahkan Kartu Kredit ke Akun Platform WhatsApp Business Anda.
Anda sekarang dapat memigrasikan nomor telepon bisnis ke dan dari Cloud API Akun WhatsApp Business. Lihat Memigrasi Nomor Telepon ke WABA yang Berbeda.
Hanya Cloud API.
Anda sekarang dapat menggunakan URL panggilan balik yang berbeda untuk setiap Akun WhatsApp Business Anda tanpa harus membuat aplikasi unik untuk setiap Akun WhatsApp Business. Lihat Mengesampingkan URL Panggilan Balik untuk detailnya.
Semua endpoint Cloud API kini mendukung panggilan versi 15.
Hanya Cloud API.
Parameter teks (components.parameters.text
) untuk template pesan yang hanya menggunakan komponen badan (components.type:body
) sekarang totalnya bisa hingga 32.768 karakter. Lihat objek Parameter.
Hanya Cloud API.
Cloud API sekarang mendukung hingga 350 (naik dari 250) pesan per detik (mps) kombinasi pesan teks dan media, berdasarkan permintaan. Lihat Throughput untuk detailnya.
Jika Anda sudah memiliki 250 mps, itu akan meningkat menjadi 350 mps secara otomatis. Jika Anda sudah meminta 250 mps tetapi prosesnya belum selesai, Anda akan menerima 350 mps setelah selesai.
Tanggapan kini didukung. Lihat Mengirim Pesan - Pesan Tanggapan untuk mempelajari cara mengirim dan menerima tanggapan dan Contoh Payload - Pesan Tanggapan untuk contoh notifikasi payload Webhooks.
Kolom about
pada profil bisnis kini didukung. Lihat Profil Bisnis untuk detailnya.
Dokumentasi terbaru untuk meminta migrasi dari 80 pesan per detik menjadi 250 pesan per detik dari gabungan pengiriman dan penerimaan pesan teks dan media kini tersedia. Lihat Throughput.
Anda sekarang dapat menyertakan stiker animasi dalam pesan keluar, yang diinisiasi dari pelaku bisnis dan menerima Webhooks pesan yang menjelaskan pesan-pesan tersebut dengan cara yang sama jika Anda mengirim stiker non-animasi. Lihat properti sticker
objek Pesan dan untuk persyaratan aset stiker animasi.
Anda sekarang dapat menyertakan produk dan layanan dalam pesan yang dikirim ke pelanggan, dan pelanggan dapat menambahkannya ke keranjang belanja tanpa harus meninggalkan utas obrolan. Lihat panduan Menjual Produk & Layanan untuk mempelajari cara mengirim pesan Tunggal dan Multiproduk kepada pelanggan.
Bisnis sekarang dapat membalas pesan apa pun dalam utas percakapan. Balasan akan menyertakan gelembung konteks yang merujuk ke pesan yang dibalas. Baca panduan Mengirim Pesan untuk mempelajari cara membalas pesan.
Cloud API kini mendukung hingga 250 pesan per detik dari gabungan pengiriman dan penerimaan (termasuk pesan teks dan media), berdasarkan permintaan. Jika Anda adalah partner enterprise, Anda bisa membuka tiket Dukungan Langsung untuk meminta throughput 250 MPS dengan memilih Topik Pertanyaan: "Masalah Cloud API", Jenis Permintaan: "Permintaan untuk migrasi ke throughput 250 MPS" dan mengisi informasi wajib.
v2.43
11 Oktober 2022v2.43
, akan ada perubahan pada perilaku endpoint contacts
status
akan berubah. Terlepas dari apakah pengguna memiliki WhatsApp, valid
untuk status
dalam tanggapan dan wa_id
akan selalu ditampilkan. Tidak ada jaminan bahwa wa_id yang diberikan akan berlaku. Perubahan ini berlaku untuk kedua tanggapan langsung, serta tanggapan webhook untuk panggilan nonblokir status
dan wa_id
di node contacts
. Selain itu, mengirim pesan di v2.39.1
atau lebih tinggi dapat diselesaikan tanpa memanggil node contacts
Pastikan kode Anda menangani potensi kesalahan 1013
Pengguna tidak valid saat mencoba mengirim pesan template, yang akan ditampilkan jika Anda mencoba mengirim pesan template ke nomor telepon tanpa akun WhatsApp
Untuk pesan bukan template, mengirim pesan ke nomor telepon tanpa akun WhatsApp akan menampilkan kesalahan 470
v2.45
10 Januari 2023Mulai v2.45
, parameter opsional cert
parameter di node shards
akan diwajibkan untuk semua permintaan. Perbarui integrasi Anda agar selalu menyertakan cert
valid saat memanggil node shards
Mulai v2.41.2
, bisnis dapat menggunakan node application
untuk memfilter status pesan yang ingin diabaikan melalui objek message
dalam objek webhooks
. Di v2.45
, sent_status
tidak akan berlaku lagi, jadi perbarui integrasi Anda untuk menggunakan objek webhooks
dalam node application
untuk semua kontrol Webhooks
Per v2.39.1
, recipient_id
tersedia di objek statuses
dan di objek message
. Di v2.45
, recipient_id
akan dihapus di objek statuses
, jadi perbarui integrasi Anda untuk menggunakan recipient_id
di bawah objek message
v2.41.3
)2.41.3
Versi v2.41.3
dari klien API WhatsApp Business kami menyertakan: Menambahkan indeks tabel baru pada message_receipt_log
yang dapat menguntungkan partner dengan kebutuhan throughput tinggi. Misalnya: peningkatan ini memungkinkan partner untuk mengirim lebih dari 200 pesan/detik.
v2.41.2
)Di v2.41.2, kami memperkenalkan perubahan skema DB untuk meningkatkan kinerja sistem. Hasilnya, peningkatan dari v2.37.2 dan v2.39.x untuk pengaturan dengan database besar dengan jutaan pesan dan entri kontak akan memakan waktu lebih lama daripada biasanya.
Secara umum, lakukan peningkatan selama jam tidak sibuk dan tingkatkan pengaturan throughput rendah terlebih dahulu.
Untuk database yang besar, ikuti langkah-langkah ini:
Jalankan koleksi sampah melalui endpoint /services/message/gc sebelum peningkatan, dan pastikan prosesnya berhasil selesai
Gunakan fitur dbupgrade untuk meningkatkan skema DB sebelum peningkatan versi. Setelah selesai, Anda akan dapat meningkatkan versi API dengan waktu henti minimal. Sangat direkomendasikan untuk membuat klien API berhenti sebelum menggunakan fitur dbupgrade. Pastikan fitur dbupgrade berhasil selesai (kode keluar 0), dan hindari atau batasi permintaan API saat peningkatan sedang berlangsung
Kami merekomendasikan untuk meningkatkan waktu habis kueri di server database Anda menjadi satu jam, sampai pembaruan berhasil selesai.
Versi klien ini berisi fitur dan pembaruan berikut:
delivered
dan read
yang memberikan kontrol yang lebih besar atas notifikasi Webhooks untuk pesan. Hal ini dapat dicapai melalui endpoint settings/applicationsnamespace
bersifat opsional untuk objek templateMulai hari ini, Cloud API WhatsApp Business terbuka untuk semua developer yang membuat produk atau layanan untuk diri sendiri atau organisasi mereka. Untuk memulai, lihat panduan kami. Jika Anda tertarik untuk menawarkan akses API kepada pelanggan Anda bergabunglah dalam daftar tunggu kami.
Nilai-nilai berikut untuk parameter category
untuk endpoint /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template
tidak berlaku lagi untuk v14.0
dan setelahnya:
|
|
|
Nilai-nilai berikut telah ditambahkan:
TRANSACTIONAL
MARKETING
Versi klien ini berisi semua fitur dan perbaikan yang dikirim dengan v2.39.1
. Selain itu, rilis ini:
v2.39.2
.v2.39.3
.v2.39.4
diinstal, bisnis akan diberi tahu bahwa mereka menerima pesan yang berangsur menghilang melalui notifikasi Webhooks dengan jenis diatur ke "ephemeral"
. Bisnis tidak akan bisa melihat konten pesan.Saat kami meluncurkan v2.39.3
,
masalah pesan yang menghilang ditangani oleh WhatsApp, yang secara otomatis menonaktifkan pesan-pesan ini di utas obrolan dengan klien. Untuk v2.39.4
, kami tidak akan melakukan hal itu. Dengan versi ini, bisnis yang menerima pesan yang menghilang harus meminta pelanggan untuk menonaktifkan pesan yang menghilang dan mengirim ulang pesan terbaru mereka.
2.3.8
Mulai hari ini, Cloud API menyertakan peningkatan berikut:
2.3.7
Mulai hari ini, Cloud API secara umum tersedia untuk semua Partner Solusi dan klien langsung yang ada. Selain itu, kami merilis fitur berikut untuk developer Cloud API:
POST
ke PHONE_NUMBER_ID/deregister
untuk menghapus nomor telepon dari API WhatsApp Business. Lihat Pendaftaran untuk informasinya.referral
Webhooks Cloud API berbeda dari objek referral
On-Premises API.Selain itu, kami mengumumkan bahwa Tinjauan Aplikasi tidak lagi diperlukan untuk developer pihak pertama yang menggunakan Cloud API. Semua developer tunduk pada batas berkirim pesan Platform WhatsApp Business.
Versi ini berisi fitur yang sama seperti v2.37.1
, tetapi ada tanggal kedaluwarsa yang berbeda. v2.37.2
kedaluwarsa pada tanggal 22 September 2022.
Beberapa developer Kubernetes mungkin melihat CrashLoopBackOff
untuk kontainer WebApp mereka dan kontainer mereka mungkin gagal untuk dimulai. Untuk memperbaikinya, tambahkan baris berikut dalam file YML
penerapan Kubernetes di bawah konfigurasi Webapp:
command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]
Versi v2.39.3
dari klien API Bisnis kami tersedia untuk developer mulai hari ini. Klien baru menyertakan dua perbaikan dan catatan tambahan untuk mendukung debugging. Dua perbaikannya adalah:
Mulai hari ini, pengguna Cloud API beta dapat mulai mengirim dan membuat pesan berisi daftar tombol balas. Lihat dokumentasi berikut untuk detail selengkapnya:
Mulai hari ini, pengguna Cloud API beta dapat menambahkan kotak URL pratinjau ke pesan teks yang berisi URL. Lihat dokumentasi berikut untuk detail selengkapnya:
Kami baru saja merilis On-Premises API v2.39.2
. Versi ini memperbaiki bug yang mencegah pesan video dikirim dalam keadaan tertentu.
Mulai hari ini, pengguna Cloud API beta dapat mulai mengirim dan menerima pesan video. Dokumentasi berikut memberikan informasi selengkapnya:
Mulai hari ini, WhatsApp telah beralih dari model harga berbasis notifikasi ke model harga berbasis percakapan. Bisnis dikenakan biaya per percakapan, yang mencakup semua pesan yang dikirim dalam sesi 24 jam. Lihat Harga Berbasis Percakapan untuk informasinya.
Mulai hari ini, pengguna Cloud API beta dapat mulai mengirim dan menerima pesan lokasi dan kontak. Lihat dokumentasi di bawah untuk informasi selengkapnya:
Kami sekarang mendukung 80 pesan per detik throughput puncak per nomor telepon. Ini termasuk pesan masuk dan keluar, serta pesan teks, template, dan media.
2.39.1
)Versi 2.39.1
dari klien API Bisnis kami tersedia untuk developer mulai hari ini. Klien baru termasuk:
Dimulai dengan versi klien API yang baru, Anda dapat memberikan sertifikat ponsel Anda saat menyiapkan multikoneksi. Artinya, saat memanggil endpoint /v1/account/shards, Anda dapat menambahkan sertifikat berenkode Base64 di kolom sertifikat. Lihat Meningkatkan Klien API Anda dengan Multikoneksi untuk informasinya.
Kami telah menambahkan graph.whatsapp.com
ke daftar nama host server WhatsApp yang konektivitasnya diperlukan oleh klien API Bisnis. Lihat Menyiapkan dan Melakukan Debug Jaringan Anda, Nama Host untuk informasinya.
Bersama v2.39
, kami telah menambahkan kode kesalahan 1031
. Anda akan mendapatkan kesalahan ini jika akun Anda telah dikunci dan tidak dapat mengirim pesan apa pun karena pelanggaran kebijakan integritas. Lihat Pesan Kesalahan dan Status dan Penegakan Kebijakan untuk informasinya.
hsm
dihentikan dengan v2.39
. Anda sebaiknya menggunakan jenis template
.webhook_payload_conversation_pricingmodel_disabled
tidak berlaku lagi.Beberapa pesan video gagal dikirim dalam keadaan tertentu.