Satu nomor.Aplikasi dan API, secara bersamaan.
Coexistence adalah mode resmi Meta untuk menjalankan aplikasi WhatsApp Business dan Cloud API pada satu nomor secara bersamaan. Tim tetap menjawab dari ponsel, dengan chat dan riwayat yang sama, sementara software mengirim dan menerima pesan di jalur yang sama.
EasyCoexistence menghubungkan nomor lalu memantau koneksinya.
Pilihan yang dulu ada, tetapi sekarang sudah tidak ada
Coexistence bukan API baru. Ini adalah penghapusan persimpangan yang sebelumnya membuat hampir semua bisnis kecil tidak bisa mengotomatiskan apa pun.
Tim menjawab dari ponsel. Tidak ada yang bisa diotomatiskan, dihubungkan, atau diukur.
Tanpa APISoftware dapat mengakses nomor tersebut. Aplikasi WhatsApp Business berhenti berfungsi di nomor itu dan tim harus berpindah alat.
Tanpa aplikasiMeta menghubungkan Cloud API ke nomor yang masih digunakan oleh aplikasi WhatsApp Business. Kedua permukaan aktif pada jalur yang sama, dan masing-masing dapat melihat apa yang dikirim oleh yang lain.
Siapa yang menjalankan nomor dengan cara ini
Dua kelompok yang menginginkan hal berlawanan dari fitur yang sama, itulah sebabnya koneksi lebih penting daripada dashboard apa pun di atasnya.
Tim kecil, nomor yang tercetak di mobil van atau etalase toko, dan malam hari yang dihabiskan untuk menjawab empat pertanyaan yang sama. Mereka tidak sedang menggantikan siapa pun. Mereka ingin konfirmasi, pengingat, dan balasan pertama setelah jam kerja terjadi tanpa manusia, sementara ponsel tetap berfungsi untuk hal lainnya.
Banyak klien, masing-masing dengan nomor yang tidak boleh dimigrasikan atau disentuh oleh siapa pun. Mereka membutuhkan agar nomor-nomor tersebut dapat dijangkau oleh sistem yang mereka bangun, dan perlu menambahkan nomor berikutnya tanpa panggilan penjualan. Coexistence adalah satu-satunya jalur resmi menuju nomor yang masih dijawab secara manual oleh staf klien.
Bagaimana sebuah nomor bisa aktif di keduanya, dan ke mana event pesan dikirim
Empat langkah. Satu-satunya yang menyentuh ponsel hanyalah pemindaian, dan langkah yang menentukan arsitektur Anda adalah yang pertama.
Siapkan endpoint sebelum onboarding dimulai
Meta memverifikasi tujuan sebelum mau mengirimkan apa pun ke sana. Meta memanggil URL Anda dengan GET yang membawa hub.mode=subscribe, hub.verify_token Anda, dan sebuah hub.challenge, lalu endpoint Anda harus mengembalikan nilai challenge tersebut apa adanya.
Tujuan harus berupa HTTPS, dan token verifikasi wajib ada. Kami memvalidasi keduanya sebelum panggilan dilakukan, sehingga URL yang salah format langsung gagal di pihak kami, bukan tampak terhubung tetapi tidak mengirimkan apa pun.
Belum ada yang terhubung. Langkah ini menentukan ke mana pesan akan tiba. Penyedia di jalur pesanDisimpan di server merekaPlatform merekaMenerima dan menyimpan pesanAndaSalinan, sesuai jadwal merekaEasyCoexistenceHanya konfigurasiEndpoint AndaBelum diverifikasiKamiKami mengatur rutenya, tetapi tidak berada di dalamnyaJalankan Embedded Signup dari Meta dan pindai di aplikasi
Popup milik Meta sendiri terbuka. Anda memilih Business Portfolio, WhatsApp Business Account, dan nomor yang sudah terdaftar di aplikasi WhatsApp Business, lalu menyetujui koneksi di ponsel dengan memindai sebuah kode.
Di langkah ini juga Anda memilih apakah riwayat chat yang sudah ada akan dibagikan. Ini adalah keputusan onboarding satu kali dan tidak dapat diubah setelahnya. Aplikasi Business tetap berfungsi begitu pemindaian selesai.
Permukaan kedua muncul. Yang pertama tidak dihapus. Setelah migrasiSatu permukaanHanya Cloud APIAplikasi Business mati di nomor iniSetelah CoexistenceDua permukaanAplikasi WhatsApp BusinessChat dan riwayat yang samaCloud APIDi jalur yang samaArahkan event pesan ke sistem Anda sendiri
Meta mengizinkan aplikasi mengganti tempat webhook sebuah WhatsApp Business Account dikirimkan. Kami menetapkan penggantian tersebut ke URL Anda, sehingga dua field jalur pesan, messages dan smb_message_echoes, langsung berpindah dari Meta ke Anda.
Kami tetap menerima field operasional, karena dari situlah pemantauan dibangun: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update, dan phone_number_name_update. Jadi dashboard tetap berguna, sementara isi percakapan tidak pernah menyentuh kami.
Event mana dikirim ke mana setelah penggantian aktif. Event operasionalDikirim ke kamiJalur pesanDikirim ke AndamessagesSemua yang dikirim pelanggansmb_message_echoesApa yang dikirim tim dari aplikasiServer AndaLangsung, tidak pernah melalui kamiJaga tetap aktif, dan bertahan saat koneksi disambungkan kembali
Meta memutus nomor Coexistence setelah kira-kira empat belas hari tanpa aktivitas pada perangkat utama. Pemutusan itu dapat disambungkan kembali, dan kami mencatatnya sebagai status tersendiri, bukan menganggapnya sebagai pelanggan yang pergi.
Bagian yang sering menjebak adalah dampak pemutusan terhadap rute. Meta menyimpan tujuan sebagai penggantian pada subscription aplikasi kami ke akun tersebut, sehingga PARTNER_REMOVED menghapus aplikasi dan ikut membawa penggantian itu. Menyambungkan kembali memulihkan pengiriman dan pemantauan, tetapi tidak memulihkan tujuan Anda. Kami memasangnya kembali secara otomatis, karena nomor pertama yang terkena aturan ini berhasil tersambung kembali lalu diam-diam berhenti mengirimkan pesan ke server pelanggan.
Apa yang dipulihkan sendiri oleh penyambungan kembali, dan apa yang harus dipasang lagi. Dipulihkan oleh MetaOtomatisPengirimanCloud API berfungsi lagiEvent operasionalPemantauan berjalan lagiHilang bersama aplikasiHarus diterapkan ulangPenggantian webhook AndaDihapus bersama aplikasiPengiriman pesan ke AndaBerhenti diam-diamKami menerapkannya ulangDi setiap penyambungan kembali
Mengapa tim menjalankan nomor dengan cara ini
- Pertahankan nomor yang sudah tercetak di mobil van, kuitansi, dan situs web, beserta alur kerja seluler di sekitarnya.
- Tambahkan pengiriman melalui API, pemrosesan webhook, dan template tanpa memindahkan siapa pun ke alat baru.
- Jaga lalu lintas pesan agar tidak masuk ke inbox bersama milik provider, sehingga percakapan tidak tersimpan di platform milik pihak lain.
- Berikan cara bagi agensi untuk menyimpan banyak nomor klien dalam satu akun, masing-masing terhubung di Business Portfolio milik klien.
Kelayakan dan batasan praktis
- Nomor tersebut harus sudah aktif di aplikasi WhatsApp Business. Nomor yang berada di aplikasi WhatsApp konsumen harus dipindahkan ke sana terlebih dahulu.
- Berbagi riwayat chat yang sudah ada adalah pilihan satu kali yang dibuat saat onboarding dan tidak dapat diubah setelahnya.
- Chat grup tidak tersedia untuk API pada nomor Coexistence, di provider mana pun.
- Perangkat utama memerlukan aktivitas berkala. Meta memutus koneksi setelah kira-kira empat belas hari tanpa aktivitas tersebut.
- Jalur verifikasi dan lencana Meta berbeda untuk nomor Coexistence, dan ketersediaan regional berubah mengikuti kebijakan Meta.
Apa yang kami teruskan kepada Anda, dan apa yang kami simpan
Meta mengizinkan aplikasi mengganti tempat WhatsApp Business Account mengirimkan webhook-nya. Kami menetapkan penggantian tersebut ke URL Anda, sehingga event terbagi menjadi dua.
messagesSemua yang dikirim pelanggan ke nomor tersebutsmb_message_echoesApa yang dikirim tim Anda dari aplikasi WhatsApp Business
account_updateStatus koneksi: dihapus, dikeluarkan, tersambung kembali, dibatasiphone_number_quality_updatePerubahan peringkat kualitas dan throughputaccount_alertsPeringatan yang diberikan Meta terhadap akunaccount_review_updateHasil dari peninjauan Metabusiness_capability_updatePerubahan batas dan kapabilitas pesanphone_number_name_updatePersetujuan dan penolakan nama tampilan
Jika sebuah nomor tidak memiliki penggantian, event pesannya akan kembali ke callback default kami, tempat handler menghapusnya tanpa menyimpannya. Hal ini dipastikan dalam kode, bukan sekadar dijanjikan dalam kebijakan: tidak ada jalur penyimpanan yang dapat dilalui oleh konten percakapan.
Aturan empat belas hari, dan hal yang rusak karenanya tetapi tidak pernah disebutkan
Meta memutus koneksi Coexistence setelah kira-kira empat belas hari tanpa aktivitas pada perangkat utama. Koneksi ini dapat disambungkan kembali, jadi kami menyimpannya sebagai status tersendiri, bukan menghitungnya sebagai pelanggan yang pergi.
Dampak yang paling merugikan terjadi setelahnya. Tujuan pesan bukan pengaturan pada nomor, melainkan penggantian pada subscription aplikasi kami ke WhatsApp Business Account. Pemutusan koneksi menghapus aplikasi, dan penggantian tersebut ikut hilang. Sambungkan kembali, pengiriman berfungsi, pemantauan berfungsi, dan pesan berhenti tiba di server Anda tanpa ada laporan kesalahan.
Kami menerapkan kembali penggantian tersebut setiap kali koneksi disambungkan kembali. Perilaku ini ada karena memang pernah terjadi: sebuah nomor terkena aturan ini, berhasil tersambung kembali, lalu diam-diam berhenti mengirimkan pesan.
Jika handshake gagal pada saat itu, karena server Anda sedang mati atau token berubah, hal tersebut dicatat pada linimasa koneksi dan tujuan tetap disimpan, bukan dibuang. Jadi, menyimpannya kembali sudah cukup untuk memperbaikinya.
Apa yang rusak diam-diam, dan bagaimana kami mengetahuinya
Aplikasi WhatsApp Business tetap berfungsi melalui hampir semua kegagalan di bawah ini, itulah sebabnya tidak ada yang menyadarinya. Inilah hal-hal yang kami periksa, beserta caranya.
Dideteksi dari webhook account_update milik Meta, khususnya PARTNER_REMOVED, bukan disimpulkan dari field yang berubah menjadi false. Kami sengaja tidak membaca is_on_biz_app untuk hal ini, karena nilainya memang false pada nomor yang bukan Coexistence dan sebelumnya menyebabkan pemutusan koneksi yang keliru.
Aturan ketidakaktifan perangkat utama milik Meta. Koneksi ini dapat disambungkan kembali, jadi dicatat sebagai status tersendiri, bukan sebagai pelanggan yang pergi, dan penyambungan kembali memulihkan pengiriman serta pemantauan.
Tujuan tersimpan sebagai penggantian pada subscription aplikasi kami ke akun tersebut, sehingga pemutusan koneksi menghapusnya. Pengiriman kembali berfungsi setelah koneksi disambungkan kembali, tetapi pengiriman ke server Anda tidak. Kami menerapkan kembali penggantian tersebut setiap kali, karena hal ini pernah terjadi pada sebuah nomor yang berhasil tersambung kembali, lalu diam-diam berhenti mengirimkan pesan.
Kami menyimpan token klien dan token System User milik kami sendiri pada akun yang sama. Ketika salah satunya ditolak, token lainnya membaca akun tersebut dan menentukan mana dari keduanya yang benar-benar rusak, sehingga token yang dicabut tidak lagi terlihat seperti nomor yang hilang.
Diperiksa dari Meta sesuai jadwal. Peringkat RED menandai koneksi yang menurun, dan kualitas, tingkat pengiriman pesan, serta level throughput disimpan pada setiap pemeriksaan sehingga penurunan terlihat sebelum menyebabkan pengiriman gagal.
Menghubungkan nomor dan memantau nomor adalah dua produk yang berbeda. Produk kedua adalah alasan hal ini ada.
Waktu yang biasanya diperlukan untuk menghubungkan nomor, dengan memindai kode dari aplikasi WhatsApp Business.
Berapa lama balasan pelanggan membuat sesi tetap terbuka untuk balasan teks bebas.
Throughput pengiriman untuk nomor Coexistence, ditetapkan Meta dan tidak dapat dinaikkan.
Berapa banyak riwayat chat yang disinkronkan Meta ke API saat nomor pertama kali terhubung.
Pertanyaan yang sering diajukan
Apakah tim saya harus berhenti menggunakan ponsel?
Tidak. Itulah inti Coexistence. Aplikasi WhatsApp Business tetap bekerja pada nomor yang sama, dengan percakapan yang sama, dan API berjalan bersamanya.
Apakah percakapan yang sudah ada akan hilang?
Tidak. Percakapan tetap ada di aplikasi, dan Meta menyinkronkan sekitar enam bulan riwayat ke API saat nomor terhubung, sehingga software memiliki konteks dan tidak mulai kosong.
Bisakah saya membatalkannya?
Ya. Nomor dapat diputuskan, dan aplikasi terus berjalan seperti sebelumnya. Menghubungkan nomor tidak mengubah nomor itu secara permanen.
Apakah ini sama dengan WhatsApp API tidak resmi?
Tidak, dan perbedaannya menentukan apakah nomor tersebut dapat bertahan. Coexistence adalah fitur resmi Meta pada Cloud API. Gateway tidak resmi menjalankan WhatsApp Web sebagai perangkat tertaut, yang melanggar ketentuan dan menyebabkan nomor diblokir.
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai Uji Coba GratisGratis selama 3 hari. Tidak ada biaya sampai masa uji coba berakhir.