Mag-log inMagsimula ng Libreng Trial
Meta Tech Provider

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.

Magsimula ng Libreng Trial3 araw na libre. Walang sisingilin hangga't hindi natatapos ang trial.
+1 415 555 0188
WhatsApp Business appSumasagot ang team mula sa telepono, tulad ng dati
Cloud APIAng inyong mga system, o isang AI assistant, sa parehong linya
Iisang thread ang nakikita ng dalawa. Lumalabas sa app ang ipinapadala ng API, at dumarating bilang smb_message_echoes event ang tina-type ng team sa app, kaya hindi kailanman sumasagot ang software sa ibabaw ng taong nakasagot na.
Default: walang message storageBusiness App + Cloud APIMCP para sa Claude at ChatGPTLive sa loob ng 2 minuto

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.

DatiIisang numero, iisang pagpili
Panatilihin ang app

Sumasagot ang team mula sa telepono. Walang maaaring i-automate, i-connect o sukatin.

Walang API
Lumipat sa API

Naaabot ng software ang numero. Hihinto ang Business app sa numerong iyon at kailangang lumipat ng tool ang team.

Walang app
NgayonIisang numero, pareho
Iisang numero
WhatsApp Business appCloud API

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

Nananatili ang teleponoNegosyong may iisang numero

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 numero, iisang accountIsang agency, consultancy o developer

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.

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

    Kailangan
    Isang HTTPS endpoint na nagbabalik ng hub.challenge sa GET ng Meta
    Oras
    Mga isang minuto
    Makukuha ninyo
    Isang destinasyong mabe-verify ng Meta sa sandaling ma-connect ang numero
    Wala pang naka-connect. Ito ang nagpapasya kung saan darating ang mga mensahe.
    May provider sa daananNakaimbak sa kanilang mga server
    Meta
    Ang kanilang platformTumatanggap at nag-iimbak ng mga mensahe
    KayoIsang kopya, ayon sa kanilang iskedyul
    EasyCoexistenceConfiguration lang
    Meta
    Ang inyong endpointHindi pa na-verify
    KamiKami ang nagtatakda ng ruta, pero wala kami rito
  2. Patakbuhin 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.

    Kailangan
    Access sa Business Portfolio, at ang teleponong may hawak ng numero
    Oras
    Dalawa hanggang tatlong minuto
    Makukuha ninyo
    Ang Cloud API na nakakabit sa numerong ginagamit pa rin ng app
    Lumilitaw ang ikalawang surface. Hindi inaalis ang una.
    Pagkatapos ng migrationIisang surface
    Ang numero
    Cloud API langPatay na ang Business app sa numerong ito
    Pagkatapos ng CoexistenceDalawang surface
    Ang numero
    WhatsApp Business appParehong mga chat at history
    Cloud APISa parehong linya
  3. Ituro 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.

    Kailangan
    Ang endpoint mula sa unang hakbang, na na-verify na ngayon ng Meta
    Oras
    Inilalapat agad pagkatapos ng onboarding
    Makukuha ninyo
    Mga mensaheng dine-deliver mula sa Meta papunta sa inyo, nang wala kami sa daanan ng mensahe
    Kung saan napupunta ang bawat event kapag aktibo na ang override.
    Mga operational na eventDine-deliver sa amin
    account_updateMga pagbabago sa status ng koneksyon
    phone_number_quality_updateKalidad at throughput
    account_review_updateMga resulta ng review
    Daanan ng mensaheDine-deliver sa inyo
    messagesLahat ng ipinapadala ng customer
    smb_message_echoesAng ipinapadala ng team mula sa app
    Ang inyong serverDirekta, hindi kailanman dumadaan sa amin
  4. Panatilihin 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.

    Kailangan
    Binubuksan paminsan-minsan ang app sa pangunahing device
    Oras
    Tuloy-tuloy
    Makukuha ninyo
    Isang koneksyong binabantayan, at isang rutang nananatili pagkatapos ng reconnection
    Ano ang kusang naibabalik ng reconnection, at ano ang kailangang ibalik.
    Ibinabalik ng MetaAwtomatiko
    PagpapadalaGumagana muli ang Cloud API
    Mga operational na eventNagpapatuloy ang monitoring
    Nawawala kasama ng appKailangang ilapat muli
    Ang inyong webhook overrideNa-uninstall kasama ng app
    Pag-deliver ng mensahe sa inyoTahimik na humihinto
    Inilalapat 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.
Malayang text0 hanggang 24 na oras pagkatapos ng huli nilang mensaheTemplate lamangpagkatapos noon, hanggang sumulat silang muli
Nagre-restart ang orasan sa tuwing may ipinapadala ang customer. Ito ang patakarang sumisira sa mga integration sa production, dahil palaging ginagawa ang testing ilang segundo pagkatapos ng isang mensahe, habang gumagana pa ang malayang text.

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.

Direktang dine-deliver sa inyong endpointAng daan ng mga mensahe. Bilang default, hindi ito kailanman dumadaan sa amin.
  • messagesLahat ng ipinapadala ng customer sa numero
  • smb_message_echoesAng ipinapadala ng inyong team mula sa WhatsApp Business app
Dine-deliver sa aminAng operational na daan. Dito binubuo ang monitoring.
  • account_updateStatus ng koneksyon: inalis, na-offboard, na-reconnect, na-restrict
  • phone_number_quality_updateMga pagbabago sa quality rating at throughput
  • account_alertsMga alert na itinataas ng Meta laban sa account
  • account_review_updateMga resulta ng review ng Meta
  • business_capability_updateMga pagbabago sa messaging limit at kakayahan
  • phone_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.

Na-disconnect ang numeroWebhook, awtoritatibo

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.

Tumahimik ang koneksyon nang labing-apat na arawSariling status

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.

Nawala ang inyong webhook route sa isang reconnectAwtomatikong inilalapat muli

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.

Huminto sa paggana ang access tokenDalawang token, iisang sagot

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.

Bumaba ang qualityRegular na sinusuri

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.

2 minutes

Karaniwang oras para ma-connect ang numero, sa pag-scan ng code mula sa WhatsApp Business app.

24 hours

Gaano katagal nananatiling bukas ang session para sa mga free-form text reply ng customer.

20 msg/s

Sending throughput ng Coexistence number, itinakda ng Meta at hindi maaaring taasan.

6 months

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.

Magpatuloy sa pagbabasa