Iisang numero.Ang app at ang API, nang sabay.
Ang Coexistence ang opisyal na mode ng Meta para patakbuhin nang sabay ang WhatsApp Business app at ang Cloud API sa iisang numero. Patuloy na sumasagot ang team mula sa telepono, gamit ang parehong mga chat at parehong history, habang nagpapadala at tumatanggap ang software sa parehong linya.
Ikinokonekta ng EasyCoexistence ang numero at mino-monitor ang connection.
Ang pagpiling dati ay kailangan, at ngayon ay hindi na
Hindi bagong API ang Coexistence. Ito ang pag-alis ng sangang-daan na pumigil sa halos lahat ng maliliit na negosyo na mag-automate ng kahit ano.
Sumasagot ang team mula sa telepono. Walang maaaring i-automate, i-connect o sukatin.
Walang APINaaabot ng software ang numero. Hihinto ang Business app sa numerong iyon at kailangang lumipat ng tool ang team.
Walang appIkinokonekta ng Meta ang Cloud API sa isang numerong ginagamit pa rin ng WhatsApp Business app. Parehong aktibo ang dalawa sa iisang linya, at nakikita ng bawat isa ang ipinapadala ng isa pa.
Sino ang nagpapatakbo ng numero sa ganitong paraan
Dalawang grupo na magkasalungat ang gusto mula sa iisang feature, kaya mas mahalaga ang koneksyon kaysa sa anumang dashboard na nasa ibabaw nito.
Isang maliit na team, isang numerong nakalimbag sa van o sa harap ng tindahan, at mga gabing ginugugol sa pagsagot sa parehong apat na tanong. Wala silang pinapalitan. Gusto nilang mangyari nang walang tao ang mga kumpirmasyon, paalala at unang sagot pagkatapos ng oras ng trabaho, habang gumagana pa rin ang telepono para sa lahat ng iba pa.
Maraming kliyente, bawat isa ay may numerong hindi maaaring i-migrate o galawin ninuman. Kailangan nilang maabot ng mga system na binubuo nila ang mga numerong iyon, at kailangan nilang maidagdag ang susunod nang walang sales call. Ang Coexistence ang tanging opisyal na daan papunta sa isang numerong sinasagot pa rin nang mano-mano ng staff ng kliyente.
Paano napupunta ang isang numero sa dalawa, at saan napupunta ang mga message event
Apat na hakbang. Ang tanging hakbang na may kinalaman sa telepono ay isang scan, at ang unang hakbang ang nagpapasya sa inyong arkitektura.
Ihanda ang endpoint bago magsimula ang onboarding
Bine-verify muna ng Meta ang isang destinasyon bago ito mag-deliver doon. Tinatawagan nito ang inyong URL gamit ang isang GET na may dalang hub.mode=subscribe, ang inyong hub.verify_token at isang hub.challenge, at kailangang ibalik ng inyong endpoint ang raw na challenge.
Kailangang HTTPS ang destinasyon, at kinakailangan ang verify token. Vina-validate namin ang dalawa bago gawin ang tawag, kaya ang maling URL ay pumapalya na sa amin pa lang, sa halip na magmukhang naka-connect pero walang dine-deliver.
Wala pang naka-connect. Ito ang nagpapasya kung saan darating ang mga mensahe. May provider sa daananNakaimbak sa kanilang mga serverAng kanilang platformTumatanggap at nag-iimbak ng mga mensaheKayoIsang kopya, ayon sa kanilang iskedyulEasyCoexistenceConfiguration langAng inyong endpointHindi pa na-verifyKamiKami ang nagtatakda ng ruta, pero wala kami ritoPatakbuhin ang Embedded Signup ng Meta at mag-scan sa app
Bubukas ang sariling popup ng Meta. Pipiliin ninyo ang Business Portfolio, ang WhatsApp Business Account at ang numerong naka-register na sa WhatsApp Business app, saka ninyo aaprubahan ang koneksyon sa telepono sa pamamagitan ng pag-scan ng isang code.
Dito rin ninyo pipiliin kung ibabahagi ang kasalukuyang chat history. Isang beses na desisyon ito sa onboarding at hindi na mababago pagkatapos. Patuloy na gumagana ang Business app sa sandaling makumpleto ang scan.
Lumilitaw ang ikalawang surface. Hindi inaalis ang una. Pagkatapos ng migrationIisang surfaceCloud API langPatay na ang Business app sa numerong itoPagkatapos ng CoexistenceDalawang surfaceWhatsApp Business appParehong mga chat at historyCloud APISa parehong linyaIturo ang mga message event sa sarili ninyong system
Pinapayagan ng Meta ang isang app na i-override kung saan ide-deliver ang mga webhook ng isang WhatsApp Business Account. Itinatakda namin ang override na iyon sa inyong URL, kaya ang dalawang field ng daanan ng mensahe, messages at smb_message_echoes, ay direktang lumilipat mula sa Meta papunta sa inyo.
Pinapanatili namin ang mga operational na field, dahil iyon ang bumubuo sa monitoring: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update at phone_number_name_update. Kaya nananatiling kapaki-pakinabang ang dashboard habang hindi kailanman dumadaan sa amin ang laman ng mga usapan.
Kung saan napupunta ang bawat event kapag aktibo na ang override. Mga operational na eventDine-deliver sa aminDaanan ng mensaheDine-deliver sa inyomessagesLahat ng ipinapadala ng customersmb_message_echoesAng ipinapadala ng team mula sa appAng inyong serverDirekta, hindi kailanman dumadaan sa aminPanatilihin itong buhay, at makaligtas sa reconnection
Dinidiskonekta ng Meta ang isang Coexistence na numero pagkatapos ng humigit-kumulang labing-apat na araw na walang aktibidad sa pangunahing device. Maaaring i-connect muli ang diskoneksyong iyon, at itinatala namin ito bilang sariling status sa halip na ituring na customer na umalis.
Ang bahaging ikinagugulat ng marami ay ang epekto ng diskoneksyon sa ruta. Iniimbak ng Meta ang destinasyon bilang override sa subscription ng aming app sa account, kaya ina-uninstall ng PARTNER_REMOVED ang app at kasama nitong nawawala ang override. Naibabalik ng reconnection ang pagpapadala at monitoring, pero hindi ang inyong destinasyon. Awtomatiko namin itong ibinabalik, dahil ang unang numerong tinamaan ng patakarang ito ay malinis na nag-reconnect at tahimik na huminto sa pag-deliver sa server ng customer.
Ano ang kusang naibabalik ng reconnection, at ano ang kailangang ibalik. Ibinabalik ng MetaAwtomatikoPagpapadalaGumagana muli ang Cloud APIMga operational na eventNagpapatuloy ang monitoringNawawala kasama ng appKailangang ilapat muliAng inyong webhook overrideNa-uninstall kasama ng appPag-deliver ng mensahe sa inyoTahimik na humihintoInilalapat namin itong muliSa bawat reconnection
Bakit ganito nagpapatakbo ng numero ang mga team
- Panatilihin ang numerong nakalimbag na sa mga van, resibo at website, pati ang mobile na workflow sa paligid nito.
- Magdagdag ng pagpapadala sa API, pagpo-proseso ng webhook at mga template nang hindi inililipat ang sinuman sa bagong tool.
- Ilayo ang trapiko ng mensahe sa shared inbox ng isang provider, para hindi nakatira ang mga usapan sa platform ng iba.
- Bigyan ang isang agency ng paraan para hawakan ang mga numero ng maraming kliyente sa iisang account, bawat isa ay naka-connect sa sariling Business Portfolio ng kliyente.
Eligibility at mga praktikal na limitasyon
- Dapat aktibo na ang numero sa WhatsApp Business app. Ang numerong nasa karaniwang WhatsApp app ay kailangan munang ilipat doon.
- Ang pagbabahagi ng kasalukuyang chat history ay isang beses na pagpili habang nag-o-onboard at hindi na mababago pagkatapos.
- Hindi kasama sa API ang mga group chat sa mga Coexistence na numero, sa lahat ng provider.
- Kailangan ng pangunahing device ng pana-panahong aktibidad. Dinidiskonekta ng Meta ang koneksyon pagkatapos ng humigit-kumulang labing-apat na araw kung wala ito.
- Iba ang mga daan ng verification at badge ng Meta para sa mga Coexistence na numero, at nagbabago ang availability sa bawat rehiyon ayon sa patakaran ng Meta.
Ano ang ipinapasa namin sa inyo, at ano ang hawak namin
Pinapayagan ng Meta ang isang app na i-override kung saan ide-deliver ng isang WhatsApp Business Account ang mga webhook nito. Itinatakda namin ang override na iyon sa inyong URL, kaya nahahati sa dalawa ang mga event.
messagesLahat ng ipinapadala ng customer sa numerosmb_message_echoesAng ipinapadala ng inyong team mula sa WhatsApp Business app
account_updateStatus ng koneksyon: inalis, na-offboard, na-reconnect, na-restrictphone_number_quality_updateMga pagbabago sa quality rating at throughputaccount_alertsMga alert na itinataas ng Meta laban sa accountaccount_review_updateMga resulta ng review ng Metabusiness_capability_updateMga pagbabago sa messaging limit at kakayahanphone_number_name_updateMga pag-apruba at pagtanggi sa display name
Kung walang override ang isang numero, babalik ang mga message event nito sa aming default na callback, kung saan itinatapon ito ng handler nang hindi iniimbak. Ipinapatupad ito sa code, hindi lamang ipinapangako sa isang patakaran: walang storage na daan na maaaring daanan ng nilalaman ng usapan.
Ang labing-apat na araw na patakaran, at ang sinisira nito na walang bumabanggit
Dinidiskonekta ng Meta ang isang Coexistence na koneksyon pagkatapos ng humigit-kumulang labing-apat na araw na walang aktibidad sa pangunahing device. Maaari itong i-connect muli, kaya iniimbak namin ito bilang sariling status sa halip na bilangin bilang customer na umalis.
Ang epektong nagdudulot ng pinsala ay dumarating pagkatapos. Ang destinasyon ng inyong mga mensahe ay hindi setting ng numero, kundi isang override sa subscription ng aming app sa WhatsApp Business Account. Ina-uninstall ng diskoneksyon ang app, at kasama nitong nawawala ang override. Kapag nag-reconnect, gumagana ang pagpapadala, gumagana ang monitoring, at humihinto ang pagdating ng mga mensahe sa inyong server nang walang anumang error na iniuulat.
Muli naming inilalapat ang override sa bawat reconnection. Umiiral ang gawing ito dahil talagang nangyari ito: isang numero ang tinamaan ng patakarang ito, malinis na nag-reconnect, at tahimik na huminto sa pag-deliver.
Kapag pumalya ang handshake sa sandaling iyon, dahil down ang inyong server o nagbago ang token, naitatala ito sa timeline ng koneksyon at pinapanatili ang destinasyon sa halip na itapon, kaya sapat na ang i-save itong muli para maayos ito.
Ano ang tahimik na nasisira, at paano namin nalalaman
Patuloy na gumagana ang WhatsApp Business app sa halos lahat ng pagpalyang nasa ibaba, kaya walang nakakapansin. Ito ang mga sinusuri namin, at kung paano.
Natutukoy mula sa account_update webhook ng Meta, partikular ang PARTNER_REMOVED, sa halip na hulaan mula sa isang field na naging false. Sadyang hindi namin binabasa ang is_on_biz_app para dito, dahil lehitimong false ito sa mga numerong hindi Coexistence at nagdudulot ito ng maling diskoneksyon.
Ang patakaran ng Meta sa kawalan ng aktibidad ng pangunahing device. Maaari itong i-connect muli, kaya naitatala ito bilang sariling status sa halip na bilang customer na umalis, at ibinabalik ng pag-reconnect ang pagpapadala at monitoring.
Nakatira ang destinasyon bilang override sa subscription ng aming app sa account, kaya ina-uninstall ito ng diskoneksyon. Bumabalik ang pagpapadala sa reconnect pero hindi ang pag-deliver sa inyong server. Muli naming inilalapat ang override sa bawat pagkakataon, dahil ang isang numerong dinanas ito ay malinis na nag-reconnect at tahimik na huminto sa pag-deliver.
Hawak namin ang token ng kliyente at ang sarili naming System User token para sa iisang account. Kapag tinanggihan ang isa, babasahin ng isa pa ang account at tutukuyin kung alin sa dalawa ang talagang nasira, kaya hindi na mukhang nawalang numero ang isang na-revoke na token.
Kinukuha mula sa Meta ayon sa iskedyul. Minamarkahan ng RED na rating ang koneksyon bilang degraded, at iniimbak sa bawat check ang quality, messaging tier at antas ng throughput para makita ang pagbaba bago pa ito makaapekto sa isang pagpapadala.
Magkaibang produkto ang pag-connect ng numero at ang pagbabantay rito. Ang ikalawa ang dahilan kung bakit ito umiiral.
Karaniwang oras para ma-connect ang numero, sa pag-scan ng code mula sa WhatsApp Business app.
Gaano katagal nananatiling bukas ang session para sa mga free-form text reply ng customer.
Sending throughput ng Coexistence number, itinakda ng Meta at hindi maaaring taasan.
Gaano karaming chat history ang sini-sync ng Meta sa API kapag unang kumonekta ang isang numero.
Mga madalas itanong
Kailangan bang tumigil ang team sa paggamit ng telepono?
Hindi. Iyan ang buong punto ng Coexistence. Patuloy na gumagana ang WhatsApp Business app sa parehong numero, kasama ang parehong conversation, habang kasabay nitong tumatakbo ang API.
Mawawala ba ang mga dati kong conversation?
Hindi. Nananatili ang mga ito sa app, at sini-sync ng Meta ang humigit-kumulang six months na history sa API kapag kumonekta ang numero, kaya may context ang software sa halip na magsimula nang walang laman.
Puwede ko ba itong i-undo?
Oo. Maaaring i-disconnect ang isang numero, at magpapatuloy ang app gaya ng dati. Walang permanenteng binabago sa mismong numero sa pag-connect nito.
Pareho ba ito sa unofficial WhatsApp APIs?
Hindi, at mahalaga ang pagkakaibang ito para manatiling aktibo ang numero. Opisyal na feature ng Meta sa Cloud API ang Coexistence. Ginagamit ng unofficial gateway ang WhatsApp Web bilang linked device, na lumalabag sa terms at nagiging dahilan para ma-ban ang mga numero.
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng Trial3 araw na libre. Walang sisingilin hangga't hindi natatapos ang trial.