Dukungan
Pemecahan Masalah
Pesan Tidak Tersampaikan
Skenario berikut dapat menyebabkan pesan tampil sebagai terkirim tetapi tidak tersampaikan. Untuk berbagai alasan ini, kami tidak akan mengungkapkan penyebab utama kesalahan tersebut, karena alasan privasi dan kebijakan.
- Pelanggan tidak online selama jangka waktu 30 hari saat kami menyimpan pesan untuk pelanggan offline.
- Pelanggan telah memblokir nomor telepon bisnis, atau nomor telepon bisnis lain yang dimiliki oleh bisnis.
- Pelanggan berada di negara yang dibatasi atau dikenai sanksi.
Dalam beberapa skenario, API menampilkan kode kesalahan dengan pesan kesalahan yang menjelaskan sifat kesalahan. Contoh skenario:
- Parameter permintaan tidak valid
- Kesalahan integritas
- Pelanggan belum menerima Ketentuan Layanan dan Kebijakan Privasi kami yang baru. Kirimkan tautan https://wa.me/tos/20210210 ini kepada pengguna akhir Anda untuk menerima Ketentuan Layanan terbaru.
- Pelanggan menggunakan WhatsApp versi lama. Pelanggan harus menggunakan versi berikut atau lebih tinggi:
- Android: 2.21.15.15
- SMBA: 2.21.15.15
- iOS: 2.21.170.4
- SMBI: 2.21.170.4
- KaiOS: 2.2130.10
- Web: 2.2132.6
- Pelanggan adalah bagian dari grup eksperimen.
- Pesan tidak tersampaikan untuk menciptakan pengalaman pengguna yang berkualitas tinggi. Lihat Batas Pesan Template Marketing Per-Pengguna.
Kemungkinan Solusi
Dengan menggunakan metode komunikasi non-WhatsApp, mintalah pengguna WhatsApp untuk:
- mengonfirmasikan bahwa mereka benar-benar dapat mengirim pesan ke nomor telepon WhatsApp Business Anda
- mengonfirmasi bahwa tidak ada nomor telepon WhatsApp Business Anda ada dalam daftar nomor yang diblokir (Pengaturan > Privasi > Diblokir atau Kontak yang diblokir)
- mengonfirmasi bahwa mereka telah menerima Ketentuan Layanan terbaru (Pengaturan > Bantuan, atau Pengaturan > Informasi Aplikasi akan meminta mereka menerima ketentuan/kebijakan terbaru jika mereka belum melakukannya)
- memperbarui ke versi terbaru klien WhatsApp
Pembatasan Negara
Bisnis di Kuba, Iran, Korea Utara, Suriah, dan tiga wilayah yang terkena sanksi di Ukraina (Krimea, Donetsk, Luhansk) tidak memenuhi syarat untuk menggunakan Platform WhatsApp Business.
Pengguna aplikasi WhatsApp Messenger (WhatsApp) dan WhatsApp Business di Kuba, Iran, Korea Utara, Suriah, dan tiga wilayah yang terkena sanksi di Ukraina (Krimea, Donetsk, Luhansk) tidak memenuhi syarat untuk menerima pesan yang dikirim melalui Platform WhatsApp Business.
Mulai 15 Mei 2024, Turki tidak lagi dibatasi untuk berkirim pesan bisnis Cloud API. Bisnis Cloud API kini dapat memulai percakapan dan menerima pesan dari pengguna WhatsApp dengan nomor Turki.
Webhooks
Status Pengiriman Pesan yang Berkonflik
Dalam kasus yang jarang terjadi, pesan yang sama dapat memicu kesuksesan dan kegagalan webhook pembaruan status pesan. Contohnya, sebuah pesan dapat memicu webhook pesan dengan "status":"delivered" dan webhook lain dengan "status":"failed". Hal ini dapat terjadi ketika pelanggan login ke WhatsApp di beberapa perangkat dan pesan berhasil tersampaikan ke satu perangkat, tetapi tidak di perangkat lainnya. Pesan apa pun yang memicu webhook status pesan "delivered" telah tersampaikan ke setidaknya satu perangkat pengguna.
Kode Kesalahan 2 - Layanan API
Saat kami memperbarui API, Anda mungkin mengalami waktu henti hingga 5 menit. Selama periode waktu ini, layanan tidak tersedia. Kami berusaha melakukan pembaruan dengan gangguan minimal terhadap bisnis, tetapi Anda mungkin saja terkena dampaknya
Cara Melakukan Debug
Kami sarankan Anda menunggu 5 menit dan mencoba melakukan panggilan API lagi.
Kesalahan Autentikasi dan Otorisasi
Kesalahan ini ditampilkan ketika ada masalah dengan token akses yang Anda gunakan untuk panggilan API.
Cara Melakukan Debug
Anda dapat langsung menempelkan token akses yang Anda gunakan ke dalam Debugger Token Akses. Kemudian, periksa apakah Anda telah memilih izin whatsapp_business_management dan whatsapp_business_messaging.
Jika token Anda tidak memiliki akses ke izin itu, Anda perlu membuat yang baru. Saat membuat token, pastikan untuk memilih:
- Aplikasi Meta yang Anda gunakan untuk panggilan API
- Izin berikut:
whatsapp_business_managementdanwhatsapp_business_messaging
Pertanyaan Umum
Pertanyaan Umum Luas
WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.
Please view information about the sunset of the On-Premises API.
Access to Cloud API is free, and we expect it to generate additional cost savings for developers, as Meta hosts and maintains the Cloud API.
We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.
Pertanyaan Umum tentang Penerapan Teknis
The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.
Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.
As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.
Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.
Pertanyaan Umum tentang Keandalan
Silakan lihat Halaman Status API WhatsApp Business untuk metrik kemampuan observasi spesifik Cloud API.
Silakan lihat Halaman Status API untuk detail selengkapnya.
Ketersediaan diperbarui sekali sehari.
Mungkin ada situasi ketika kesalahan pengguna tertentu dapat secara otomatis dihitung dengan tidak benar terhadap waktu henti. Dalam situasi ini, kami akan menimpa waktu henti menjadi waktu aktif setelah analisis mendetail dalam seminggu.
Mungkin ada masalah yang tidak memengaruhi ketersediaan global kami. Dalam kasus ini, Halaman Status API WhatsApp Business akan memiliki status untuk mencerminkan bahwa mungkin ada beberapa gangguan yang tidak memengaruhi ketersediaan global. Silakan kirim tiket Dukungan Langsung untuk investigasi lebih lanjut.
Ada beberapa kasus ketika waktu henti dalam ketersediaan tidak terlacak secara otomatis:
- Masalah jaringan menyebabkan permintaan gagal sebelum mencapai layer Graph API (layer pertama).
- Masalah jaringan menyebabkan Webhooks keluar tidak mencapai endpoint Webhooks bisnis.
Masalah apa pun yang muncul sebelum masuk ke sistem kami setelah titik ini akan muncul sebagai kesalahan atau keberhasilan yang terlewat. Juga masalah yang dihadapi setelah upaya pertama untuk mengeluarkan Webhooks akan terus dicoba, sampai berhasil tersampaikan ke endpoint Webhooks.
Kasus lain yang tecermin dalam dasbor ketersediaan setelah deteksi manual adalah (bukan kesalahan sistem):
- Masalah autentikasi Meta seperti token autentikasi (pustaka keamanan) ditentukan apakah itu adalah permintaan sah dengan autentikasi atau otorisasi yang gagal.
- Validasi yang menolak permintaan yang sah.
Dalam kedua kasus, WhatsApp akan mendeteksi dan memperhitungkan masalah tersebut dengan fakta, mendekati realtime, tetapi tidak realtime.
Saat ini kami tidak menawarkan persetujuan level layanan produk yang tersedia secara komersial untuk waktu aktif dan/atau latensi.
We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.