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.
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.
How a number ends up on both, and where the message events go
Four steps. The only one that touches the phone is a scan, and the one that decides your architecture is the first.
Have the endpoint ready before onboarding starts
Meta verifies a destination before it will deliver to it. It calls your URL with a GET carrying hub.mode=subscribe, your hub.verify_token and a hub.challenge, and your endpoint has to echo the raw challenge back.
The destination must be HTTPS, and a verify token is mandatory. We validate both before the call is made, so a malformed URL fails at our door rather than looking connected and delivering nothing.
Nothing is connected yet. This decides where messages will land. Provider in the pathStored on their serversTheir platformReceives and stores messagesYouA copy, on their scheduleEasyCoexistenceConfig onlyYour endpointNot yet verifiedUsWe set the route, we are not on itRun Meta's Embedded Signup and scan in the app
Meta's own popup opens. You pick the Business Portfolio, the WhatsApp Business Account and the number already registered in the WhatsApp Business app, then approve the connection on the phone by scanning a code.
This is also where you choose whether to share existing chat history. It is a one time onboarding decision and cannot be changed later. The Business app keeps working the moment the scan completes.
The second surface appears. The first one is not removed. After a migrationOne surfaceCloud API onlyBusiness app dead on this numberAfter CoexistenceTwo surfacesWhatsApp Business appSame chats and historyCloud APIOn the same linePoint the message events at your own system
Meta lets an app override where a given WhatsApp Business Account's webhooks are delivered. We set that override to your URL, which moves the two message path fields, messages and smb_message_echoes, straight from Meta to you.
We keep the operational fields, because those are what monitoring is made of: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update and phone_number_name_update. So the dashboard stays useful while conversation content never touches us.
Which events go where once the override is active. Operational eventsDelivered to usMessage pathDelivered to youmessagesEverything a customer sendssmb_message_echoesWhat the team sends from the appYour serverDirectly, never through usKeep it alive, and survive a reconnection
Meta disconnects a Coexistence number after roughly fourteen days without activity on the primary device. That disconnection is reconnectable, and we record it as its own state rather than treating it as a customer leaving.
The part that catches people is what a disconnection does to the route. Meta stores the destination as an override on our app's subscription to the account, so a PARTNER_REMOVED uninstalls the app and takes the override with it. Reconnecting restores sending and monitoring, but not your destination. We put it back automatically, because the first number that hit this rule reconnected fine and silently stopped delivering to the customer's server.
What a reconnection restores by itself, and what has to be put back. Restored by MetaAutomaticSendingThe Cloud API works againOperational eventsMonitoring resumesLost with the appHas to be reappliedYour webhook overrideUninstalled with the appMessage delivery to youSilently stopsWe reapply itOn every reconnection
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 7 hari. Tidak ada biaya sampai masa uji coba berakhir.