Satu nombor.Aplikasi dan API, pada masa yang sama.
Coexistence ialah mod rasmi Meta untuk menjalankan aplikasi WhatsApp Business dan Cloud API pada satu nombor serentak. Pasukan terus menjawab dari telefon, dengan sembang dan sejarah yang sama, sementara perisian menghantar dan menerima mesej pada talian yang sama.
EasyCoexistence menyambungkan nombor dan memantau sambungan itu.
Pilihan yang dahulu wujud, dan kini tidak lagi
Coexistence bukan API baharu. Ia menghapuskan satu simpang yang menghalang hampir setiap perniagaan kecil daripada mengautomasikan apa-apa pun.
Pasukan menjawab dari telefon. Tiada apa yang boleh diautomasikan, disambungkan atau diukur.
Tiada APIPerisian boleh mencapai nombor itu. Aplikasi Business berhenti berfungsi pada nombor tersebut dan pasukan terpaksa bertukar alat.
Tiada aplikasiMeta menyambungkan Cloud API kepada nombor yang masih digunakan oleh aplikasi WhatsApp Business. Kedua-dua permukaan aktif pada talian yang sama, dan setiap satu melihat apa yang dihantar oleh yang lain.
Siapa yang menjalankan nombor dengan cara ini
Dua kumpulan yang mahukan perkara bertentangan daripada ciri yang sama, dan itulah sebabnya sambungan lebih penting daripada mana-mana dashboard di atasnya.
Pasukan kecil, nombor yang tercetak pada van atau hadapan kedai, dan malam yang dihabiskan menjawab empat soalan yang sama. Mereka tidak menggantikan sesiapa. Mereka mahu pengesahan, peringatan dan balasan pertama selepas waktu kerja berlaku tanpa manusia, sementara telefon masih berfungsi untuk segala yang lain.
Ramai pelanggan, setiap satu dengan nombor yang tiada sesiapa dibenarkan memindahkan atau mengusiknya. Mereka perlukan nombor tersebut boleh dicapai oleh sistem yang mereka bina, dan perlu menambah nombor seterusnya tanpa panggilan jualan. Coexistence ialah satu-satunya laluan rasmi ke nombor yang masih dijawab secara manual oleh kakitangan pelanggan.
Bagaimana satu nombor berada pada kedua-duanya, dan ke mana acara mesej dihantar
Empat langkah. Satu-satunya yang melibatkan telefon ialah imbasan, dan langkah yang menentukan seni bina anda ialah langkah pertama.
Sediakan endpoint sebelum onboarding bermula
Meta mengesahkan destinasi sebelum menghantar apa-apa kepadanya. Meta memanggil URL anda dengan GET yang membawa hub.mode=subscribe, hub.verify_token anda dan hub.challenge, dan endpoint anda perlu memulangkan challenge itu sebagaimana adanya.
Destinasi mestilah HTTPS, dan token pengesahan adalah wajib. Kami mengesahkan kedua-duanya sebelum panggilan dibuat, jadi URL yang salah format gagal di pihak kami, dan bukannya kelihatan bersambung tetapi tidak menghantar apa-apa.
Belum ada apa-apa yang disambungkan. Langkah ini menentukan ke mana mesej akan tiba. Penyedia di tengah laluanDisimpan pada pelayan merekaPlatform merekaMenerima dan menyimpan mesejAndaSalinan, mengikut jadual merekaEasyCoexistenceKonfigurasi sahajaEndpoint andaBelum disahkanKamiKami menetapkan laluan, kami tidak berada padanyaJalankan Embedded Signup Meta dan imbas dalam aplikasi
Tetingkap timbul Meta sendiri dibuka. Anda memilih Business Portfolio, WhatsApp Business Account dan nombor yang sudah didaftarkan dalam aplikasi WhatsApp Business, kemudian meluluskan sambungan pada telefon dengan mengimbas satu kod.
Di sini juga anda memilih sama ada untuk berkongsi sejarah sembang sedia ada. Ini ialah keputusan onboarding sekali sahaja dan tidak boleh diubah kemudian. Aplikasi Business terus berfungsi sebaik sahaja imbasan selesai.
Permukaan kedua muncul. Yang pertama tidak dibuang. Selepas migrasiSatu permukaanCloud API sahajaAplikasi Business mati pada nombor iniSelepas CoexistenceDua permukaanAplikasi WhatsApp BusinessSembang dan sejarah yang samaCloud APIPada talian yang samaHalakan acara mesej ke sistem anda sendiri
Meta membenarkan aplikasi mengatasi tempat webhook bagi sesebuah WhatsApp Business Account dihantar. Kami menetapkan override itu kepada URL anda, yang memindahkan dua medan laluan mesej, messages dan smb_message_echoes, terus daripada Meta kepada anda.
Kami mengekalkan medan operasi, kerana itulah asas pemantauan: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update dan phone_number_name_update. Jadi dashboard kekal berguna sementara kandungan perbualan tidak pernah sampai kepada kami.
Acara mana pergi ke mana sebaik sahaja override aktif. Acara operasiDihantar kepada kamiLaluan mesejDihantar kepada andamessagesSemua yang dihantar oleh pelanggansmb_message_echoesApa yang dihantar pasukan dari aplikasiPelayan andaSecara terus, tidak pernah melalui kamiPastikan ia kekal aktif, dan bertahan selepas sambungan semula
Meta memutuskan sambungan nombor Coexistence selepas kira-kira empat belas hari tanpa aktiviti pada peranti utama. Pemutusan itu boleh disambung semula, dan kami merekodkannya sebagai keadaan tersendiri, bukan menganggapnya sebagai pelanggan yang telah pergi.
Bahagian yang sering mengejutkan orang ialah kesan pemutusan terhadap laluan. Meta menyimpan destinasi sebagai override pada langganan aplikasi kami kepada akaun tersebut, jadi PARTNER_REMOVED menyahpasang aplikasi dan membawa bersama override itu. Sambungan semula memulihkan penghantaran dan pemantauan, tetapi bukan destinasi anda. Kami memasangnya semula secara automatik, kerana nombor pertama yang terkena peraturan ini berjaya disambung semula lalu senyap-senyap berhenti menghantar ke pelayan pelanggan.
Apa yang dipulihkan sendiri oleh sambungan semula, dan apa yang perlu dipasang semula. Dipulihkan oleh MetaAutomatikPenghantaranCloud API berfungsi semulaAcara operasiPemantauan bersambung semulaHilang bersama aplikasiPerlu digunakan semulaOverride webhook andaDinyahpasang bersama aplikasiPenghantaran mesej kepada andaBerhenti secara senyapKami menggunakannya semulaPada setiap sambungan semula
Mengapa pasukan menjalankan nombor dengan cara ini
- Kekalkan nombor yang sudah tercetak pada van, resit dan laman web, serta aliran kerja mudah alih di sekelilingnya.
- Tambah penghantaran melalui API, pemprosesan webhook dan template tanpa memindahkan sesiapa ke alat baharu.
- Pastikan trafik mesej tidak melalui peti masuk kongsi milik penyedia, supaya perbualan tidak tersimpan di platform pihak lain.
- Beri agensi cara untuk memegang banyak nombor pelanggan dalam satu akaun, setiap satu disambungkan dalam Business Portfolio milik pelanggan sendiri.
Kelayakan dan had praktikal
- Nombor mesti sudah aktif dalam aplikasi WhatsApp Business. Nombor pada aplikasi WhatsApp biasa perlu dipindahkan ke sana terlebih dahulu.
- Berkongsi sejarah sembang sedia ada ialah pilihan sekali sahaja yang dibuat semasa onboarding dan tidak boleh diubah selepas itu.
- Sembang kumpulan dikecualikan daripada API pada nombor Coexistence, pada semua penyedia.
- Peranti utama memerlukan aktiviti berkala. Meta memutuskan sambungan selepas kira-kira empat belas hari tanpanya.
- Laluan pengesahan dan lencana Meta berbeza bagi nombor Coexistence, dan ketersediaan serantau berubah mengikut dasar Meta.
Apa yang kami halakan kepada anda, dan apa yang kami simpan
Meta membenarkan aplikasi mengatasi tempat WhatsApp Business Account menghantar webhook-nya. Kami menetapkan override itu kepada URL anda, yang membahagikan acara kepada dua.
messagesSemua yang dihantar pelanggan ke nombor tersebutsmb_message_echoesApa yang dihantar pasukan anda dari aplikasi WhatsApp Business
account_updateKeadaan sambungan: dialih keluar, dikeluarkan, disambung semula, disekatphone_number_quality_updatePerubahan penarafan kualiti dan throughputaccount_alertsAmaran yang dikeluarkan Meta terhadap akaunaccount_review_updateKeputusan semakan Metabusiness_capability_updatePerubahan had mesej dan keupayaanphone_number_name_updateKelulusan dan penolakan nama paparan
Jika sesebuah nombor tiada override ditetapkan, acara mesejnya akan jatuh ke callback lalai kami, tempat pengendali membuangnya tanpa menyimpan. Perkara ini dikuatkuasakan dalam kod, bukan sekadar dijanjikan dalam dasar: tiada laluan storan yang boleh diambil oleh kandungan perbualan.
Peraturan empat belas hari, dan perkara yang dirosakkannya tetapi tidak disebut sesiapa
Meta memutuskan sambungan Coexistence selepas kira-kira empat belas hari tanpa aktiviti pada peranti utama. Ia boleh disambung semula, jadi kami menyimpannya sebagai keadaan tersendiri dan bukan mengiranya sebagai pelanggan yang telah pergi.
Akibat yang merugikan berlaku selepas itu. Destinasi mesej anda bukan tetapan pada nombor, tetapi override pada langganan aplikasi kami kepada WhatsApp Business Account. Pemutusan sambungan menyahpasang aplikasi, dan override itu turut hilang. Sambung semula, penghantaran berfungsi, pemantauan berfungsi, dan mesej berhenti tiba di pelayan anda tanpa sebarang ralat dilaporkan.
Kami menggunakan semula override itu pada setiap sambungan semula. Tingkah laku ini wujud kerana ia pernah berlaku: sebuah nombor terkena peraturan ini, berjaya disambung semula, lalu senyap-senyap berhenti menghantar.
Jabat tangan yang gagal pada ketika itu, kerana pelayan anda tidak berfungsi atau token telah bertukar, direkodkan pada garis masa sambungan dan destinasi disimpan dan bukan dibuang, jadi menyimpannya sekali lagi sudah cukup untuk membetulkannya.
Apa yang rosak secara senyap, dan bagaimana kami mengetahuinya
Aplikasi WhatsApp Business terus berfungsi melalui hampir setiap kegagalan di bawah, dan itulah sebabnya tiada sesiapa perasan. Inilah perkara yang kami periksa, dan caranya.
Dikesan daripada webhook account_update Meta, khususnya PARTNER_REMOVED, bukan disimpulkan daripada medan yang bertukar menjadi false. Kami sengaja tidak membaca is_on_biz_app untuk tujuan ini, kerana nilainya memang false pada nombor yang bukan Coexistence dan sebelum ini menyebabkan pemutusan sambungan palsu.
Peraturan ketidakaktifan peranti utama Meta. Ia boleh disambung semula, jadi ia direkodkan sebagai keadaan tersendiri dan bukan sebagai pelanggan yang telah pergi, dan menyambung semula memulihkan penghantaran dan pemantauan.
Destinasi wujud sebagai override pada langganan aplikasi kami kepada akaun, jadi pemutusan sambungan menyahpasangnya. Penghantaran kembali apabila disambung semula, tetapi penghantaran ke pelayan anda tidak. Kami menggunakan semula override setiap kali, kerana sebuah nombor yang mengalami perkara ini berjaya disambung semula lalu senyap-senyap berhenti menghantar.
Kami memegang token pelanggan dan System User token milik kami sendiri terhadap akaun yang sama. Apabila satu ditolak, yang satu lagi membaca akaun dan menentukan yang mana satu sebenarnya rosak, jadi token yang dibatalkan tidak lagi kelihatan seperti nombor yang hilang.
Ditinjau daripada Meta mengikut jadual. Penarafan RED menandakan sambungan sebagai merosot, dan kualiti, peringkat pemesejan serta tahap throughput disimpan pada setiap semakan supaya penurunan dapat dilihat sebelum ia menjejaskan penghantaran.
Menyambungkan nombor dan memantau nombor ialah dua produk yang berbeza. Yang kedua ialah sebab produk ini wujud.
Masa biasa untuk menyambungkan nombor dengan mengimbas kod daripada aplikasi WhatsApp Business.
Tempoh balasan pelanggan mengekalkan sesi terbuka untuk balasan teks bebas.
Kadar penghantaran bagi nombor Coexistence, ditetapkan Meta dan tidak boleh dinaikkan.
Jumlah sejarah perbualan yang disegerakkan Meta ke API apabila nombor mula disambungkan.
Soalan lazim
Adakah pasukan saya perlu berhenti menggunakan telefon?
Tidak. Itulah tujuan utama Coexistence. Aplikasi WhatsApp Business terus berfungsi pada nombor yang sama, dengan perbualan yang sama, dan API berjalan bersamanya.
Adakah saya akan kehilangan perbualan sedia ada?
Tidak. Perbualan kekal dalam aplikasi, dan Meta menyegerakkan kira-kira enam bulan sejarah ke API apabila nombor disambungkan, jadi perisian mempunyai konteks dan tidak bermula kosong.
Bolehkah saya membatalkannya?
Ya. Nombor boleh diputuskan sambungannya, dan aplikasi terus berfungsi seperti biasa. Penyambungan itu tidak mengubah nombor secara kekal.
Adakah ini sama seperti API WhatsApp tidak rasmi?
Tidak, dan perbezaannya menentukan sama ada nombor itu kekal aktif. Coexistence ialah ciri rasmi Meta pada Cloud API. Get laluan tidak rasmi mengendalikan WhatsApp Web sebagai peranti terpaut, lalu melanggar syarat dan menyebabkan nombor disekat.
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaPercuma selama 3 hari. Tiada caj sehingga tempoh percubaan tamat.