Log masukMulakan percubaan percuma
Meta Tech Provider

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.

Mulakan Percubaan PercumaPercuma selama 3 hari. Tiada caj sehingga tempoh percubaan tamat.
+1 415 555 0188
Aplikasi WhatsApp BusinessPasukan menjawab dari telefon, seperti sebelum ini
Cloud APISistem anda, atau pembantu AI, pada talian yang sama
Kedua-dua permukaan melihat bebenang yang sama. Apa yang dihantar oleh API muncul dalam aplikasi, dan apa yang ditaip oleh pasukan dalam aplikasi tiba sebagai acara smb_message_echoes, jadi perisian tidak akan membalas di atas manusia yang sudah menjawab.
Tiada simpanan mesej secara lalaiAplikasi Perniagaan + Cloud APIMCP untuk Claude dan ChatGPTHidup dalam 2 minit

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.

DahuluSatu nombor, satu pilihan
Kekalkan aplikasi

Pasukan menjawab dari telefon. Tiada apa yang boleh diautomasikan, disambungkan atau diukur.

Tiada API
Berhijrah ke API

Perisian boleh mencapai nombor itu. Aplikasi Business berhenti berfungsi pada nombor tersebut dan pasukan terpaksa bertukar alat.

Tiada aplikasi
KiniSatu nombor, kedua-duanya
Satu nombor
Aplikasi WhatsApp BusinessCloud API

Meta 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.

Kekalkan telefonPerniagaan dengan satu nombor

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.

Banyak nombor, satu akaunAgensi, firma perunding atau pembangun

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.

  1. 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.

    Perlu
    Endpoint HTTPS yang memulangkan hub.challenge pada GET daripada Meta
    Masa
    Kira-kira satu minit
    Anda dapat
    Destinasi yang boleh disahkan oleh Meta sebaik sahaja nombor disambungkan
    Belum ada apa-apa yang disambungkan. Langkah ini menentukan ke mana mesej akan tiba.
    Penyedia di tengah laluanDisimpan pada pelayan mereka
    Meta
    Platform merekaMenerima dan menyimpan mesej
    AndaSalinan, mengikut jadual mereka
    EasyCoexistenceKonfigurasi sahaja
    Meta
    Endpoint andaBelum disahkan
    KamiKami menetapkan laluan, kami tidak berada padanya
  2. Jalankan 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.

    Perlu
    Akses kepada Business Portfolio, dan telefon dengan nombor tersebut
    Masa
    Dua hingga tiga minit
    Anda dapat
    Cloud API dipasang pada nombor yang masih digunakan oleh aplikasi
    Permukaan kedua muncul. Yang pertama tidak dibuang.
    Selepas migrasiSatu permukaan
    Nombor itu
    Cloud API sahajaAplikasi Business mati pada nombor ini
    Selepas CoexistenceDua permukaan
    Nombor itu
    Aplikasi WhatsApp BusinessSembang dan sejarah yang sama
    Cloud APIPada talian yang sama
  3. Halakan 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.

    Perlu
    Endpoint daripada langkah pertama, kini sudah disahkan oleh Meta
    Masa
    Digunakan sebaik sahaja onboarding selesai
    Anda dapat
    Mesej dihantar daripada Meta kepada anda, tanpa kami di laluan mesej
    Acara mana pergi ke mana sebaik sahaja override aktif.
    Acara operasiDihantar kepada kami
    account_updatePerubahan keadaan sambungan
    phone_number_quality_updateKualiti dan throughput
    account_review_updateKeputusan semakan
    Laluan mesejDihantar kepada anda
    messagesSemua yang dihantar oleh pelanggan
    smb_message_echoesApa yang dihantar pasukan dari aplikasi
    Pelayan andaSecara terus, tidak pernah melalui kami
  4. Pastikan 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.

    Perlu
    Aplikasi dibuka pada peranti utama dari semasa ke semasa
    Masa
    Berterusan
    Anda dapat
    Sambungan yang dipantau, dan laluan yang kekal selepas sambungan semula
    Apa yang dipulihkan sendiri oleh sambungan semula, dan apa yang perlu dipasang semula.
    Dipulihkan oleh MetaAutomatik
    PenghantaranCloud API berfungsi semula
    Acara operasiPemantauan bersambung semula
    Hilang bersama aplikasiPerlu digunakan semula
    Override webhook andaDinyahpasang bersama aplikasi
    Penghantaran mesej kepada andaBerhenti secara senyap
    Kami 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.
Teks bebas0 hingga 24 jam selepas mesej terakhir merekaTemplate sahajaselepas itu, sehingga mereka menulis semula
Jam bermula semula setiap kali pelanggan menghantar sesuatu. Inilah peraturan yang merosakkan integrasi dalam persekitaran produksi, kerana ujian sentiasa dijalankan beberapa saat selepas sesuatu mesej, ketika teks bebas masih berfungsi.

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.

Dihantar terus ke endpoint andaLaluan mesej. Secara lalai, ia tidak pernah melalui kami.
  • messagesSemua yang dihantar pelanggan ke nombor tersebut
  • smb_message_echoesApa yang dihantar pasukan anda dari aplikasi WhatsApp Business
Dihantar kepada kamiLaluan operasi. Inilah asas pemantauan.
  • account_updateKeadaan sambungan: dialih keluar, dikeluarkan, disambung semula, disekat
  • phone_number_quality_updatePerubahan penarafan kualiti dan throughput
  • account_alertsAmaran yang dikeluarkan Meta terhadap akaun
  • account_review_updateKeputusan semakan Meta
  • business_capability_updatePerubahan had mesej dan keupayaan
  • phone_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.

Nombor telah diputuskan sambunganWebhook, sumber sahih

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.

Sambungan senyap selama empat belas hariKeadaan tersendiri

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.

Laluan webhook anda hilang semasa sambungan semulaDigunakan semula secara automatik

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.

Token akses berhenti berfungsiDua token, satu jawapan

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.

Kualiti menurunDitinjau berkala

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.

2 minutes

Masa biasa untuk menyambungkan nombor dengan mengimbas kod daripada aplikasi WhatsApp Business.

24 hours

Tempoh balasan pelanggan mengekalkan sesi terbuka untuk balasan teks bebas.

20 msg/s

Kadar penghantaran bagi nombor Coexistence, ditetapkan Meta dan tidak boleh dinaikkan.

6 months

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.

Teruskan membaca