Nambari moja.Programu na API, kwa wakati mmoja.
Coexistence ni njia rasmi ya Meta ya kuendesha programu ya WhatsApp Business na Cloud API kwenye nambari moja kwa wakati mmoja. Timu inaendelea kujibu kutoka kwenye simu, ikiwa na mazungumzo yale yale na historia ile ile, huku mifumo ikituma na kupokea ujumbe kwenye laini hiyo hiyo.
EasyCoexistence huunganisha nambari kisha hufuatilia muunganisho.
Chaguo lililokuwepo, na halipo tena
Coexistence si API mpya. Ni kuondolewa kwa njia panda iliyozuia karibu kila biashara ndogo kuweka chochote kiotomatiki.
Timu inajibu kutoka kwenye simu. Hakuna kinachoweza kuwekwa kiotomatiki, kuunganishwa au kupimwa.
Hakuna APIMifumo inaweza kufikia nambari. Programu ya Business inaacha kufanya kazi kwenye nambari hiyo na timu inahamia zana nyingine.
Hakuna programuMeta inaunganisha Cloud API na nambari ambayo programu ya WhatsApp Business bado inaitumia. Vyote viwili viko hai kwenye laini moja, na kila kimoja kinaona kile ambacho kingine kinatuma.
Nani huendesha nambari kwa njia hii
Makundi mawili, yanayotaka mambo yanayopingana kutoka kwenye kipengele kimoja, ndiyo sababu muunganisho ni muhimu kuliko dashboard yoyote iliyo juu yake.
Timu ndogo, nambari iliyochapishwa kwenye gari au mbele ya duka, na jioni zinazotumika kujibu maswali yale yale manne. Hawambadilishi mtu yeyote. Wanataka uthibitisho, vikumbusho na jibu la kwanza baada ya saa za kazi vifanyike bila mtu, huku simu ikiendelea kufanya kazi kwa kila kitu kingine.
Wateja wengi, kila mmoja akiwa na nambari ambayo hakuna anayeruhusiwa kuihamisha au kuigusa. Wanahitaji nambari hizo zifikiwe na mifumo wanayoijenga, na wanahitaji kuongeza inayofuata bila simu ya mauzo. Coexistence ndiyo njia pekee rasmi ya kufikia nambari ambayo wafanyakazi wa mteja bado wanaijibu kwa mkono.
Jinsi nambari inavyokuwa kwenye vyote viwili, na matukio ya ujumbe yanakwenda wapi
Hatua nne. Hatua pekee inayogusa simu ni kuchanganua msimbo, na hatua inayoamua muundo wa mfumo wako ni ya kwanza.
Andaa endpoint kabla onboarding haijaanza
Meta huthibitisha mahali pa kufikisha kabla ya kufikisha chochote huko. Inaita URL yako kwa GET inayobeba hub.mode=subscribe, hub.verify_token yako na hub.challenge, na endpoint yako lazima irudishe challenge hiyo kama ilivyo.
Mahali pa kufikisha lazima pawe HTTPS, na token ya uthibitishaji ni lazima. Tunathibitisha vyote viwili kabla ombi hilo halijatumwa, hivyo URL yenye muundo mbovu inashindwa kwetu badala ya kuonekana imeunganishwa huku haifikishi chochote.
Hakuna kilichounganishwa bado. Hatua hii inaamua ujumbe utafika wapi. Mtoa huduma katikatiHuhifadhiwa kwenye server zaoJukwaa laoHupokea na kuhifadhi ujumbeWeweNakala, kwa ratiba yaoEasyCoexistenceMipangilio tuEndpoint yakoBado haijathibitishwaSisiTunaweka njia, lakini hatumo ndani yakeEndesha Embedded Signup ya Meta na uchanganue msimbo kwenye programu
Dirisha ibukizi la Meta lenyewe linafunguka. Unachagua Business Portfolio, WhatsApp Business Account na nambari ambayo tayari imesajiliwa kwenye programu ya WhatsApp Business, kisha unaidhinisha muunganisho kwenye simu kwa kuchanganua msimbo.
Hapa pia ndipo unachagua kama utashiriki historia ya mazungumzo iliyopo. Ni uamuzi wa mara moja wa onboarding na hauwezi kubadilishwa baadaye. Programu ya Business inaendelea kufanya kazi mara tu uchanganuzi unapokamilika.
Upande wa pili unaonekana. Upande wa kwanza hauondolewi. Baada ya kuhamishaUpande mmojaCloud API pekeeProgramu ya Business haifanyi kazi tena kwenye nambari hiiBaada ya CoexistencePande mbiliProgramu ya WhatsApp BusinessMazungumzo na historia ile ileCloud APIKwenye laini ile ileElekeza matukio ya ujumbe kwenye mfumo wako mwenyewe
Meta inaruhusu programu ku-override mahali webhook za WhatsApp Business Account fulani zinapofikishwa. Tunaweka override hiyo kwenye URL yako, jambo linalohamisha sehemu mbili za njia ya ujumbe, messages na smb_message_echoes, moja kwa moja kutoka Meta hadi kwako.
Tunabaki na sehemu za kiutendaji, kwa sababu ndizo msingi wa ufuatiliaji: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update na phone_number_name_update. Hivyo dashboard inaendelea kuwa na manufaa huku maudhui ya mazungumzo hayatugusi kamwe.
Matukio yapi yanakwenda wapi mara override inapoanza kufanya kazi. Matukio ya kiutendajiHufikishwa kwetuNjia ya ujumbeHufikishwa kwakomessagesKila kitu ambacho mteja anatumasmb_message_echoesKile timu inachotuma kutoka kwenye programuServer yakoMoja kwa moja, kamwe si kupitia kwetuWeka muunganisho hai, na uhimili kuunganishwa tena
Meta hukata nambari ya Coexistence baada ya takriban siku kumi na nne bila shughuli kwenye kifaa kikuu. Muunganisho huo unaweza kurejeshwa, na tunaurekodi kama hali yake yenyewe badala ya kuuchukulia kama mteja aliyeondoka.
Sehemu inayowashangaza watu ni kile ambacho kukatika kunafanya kwa njia ya ujumbe. Meta huhifadhi mahali pa kufikisha kama override kwenye usajili wa programu yetu kwa akaunti hiyo, hivyo PARTNER_REMOVED inaondoa programu na override inaondoka pamoja nayo. Kuunganisha tena kunarejesha kutuma na ufuatiliaji, lakini si mahali pako pa kufikisha. Tunapaweka tena kiotomatiki, kwa sababu nambari ya kwanza iliyoguswa na sheria hii iliunganishwa tena bila tatizo, kisha ikaacha kimya kimya kufikisha ujumbe kwenye server ya mteja.
Kile ambacho kuunganisha tena kunarejesha chenyewe, na kile kinachopaswa kurudishwa. Hurejeshwa na MetaKiotomatikiKutumaCloud API inafanya kazi tenaMatukio ya kiutendajiUfuatiliaji unaendelea tenaHupotea pamoja na programuLazima iwekwe tenaOverride ya webhook yakoHuondolewa pamoja na programuKufikisha ujumbe kwakoHukoma kimya kimyaTunaiweka tenaKila muunganisho unaporejeshwa
Kwa nini timu huendesha nambari kwa njia hii
- Kubaki na nambari ambayo tayari imechapishwa kwenye magari, risiti na tovuti, pamoja na mtiririko wa kazi wa simu unaoizunguka.
- Kuongeza kutuma kupitia API, uchakataji wa webhook na template bila kumhamishia mtu yeyote kwenye zana mpya.
- Kuweka trafiki ya ujumbe nje ya inbox ya pamoja ya mtoa huduma, ili mazungumzo yasikae kwenye jukwaa la mtu mwingine.
- Kumpa wakala njia ya kushikilia nambari za wateja wengi kwenye akaunti moja, kila moja ikiwa imeunganishwa kwenye Business Portfolio ya mteja mwenyewe.
Masharti na mipaka ya kiutendaji
- Nambari lazima iwe tayari inatumika kwenye programu ya WhatsApp Business. Nambari iliyo kwenye programu ya kawaida ya WhatsApp lazima ihamishiwe huko kwanza.
- Kushiriki historia ya mazungumzo iliyopo ni uamuzi wa mara moja unaofanywa wakati wa onboarding na hauwezi kubadilishwa baadaye.
- Mazungumzo ya vikundi hayajumuishwi kwenye API kwa nambari za Coexistence, kwa kila mtoa huduma.
- Kifaa kikuu kinahitaji shughuli za mara kwa mara. Meta hukata muunganisho baada ya takriban siku kumi na nne bila shughuli hizo.
- Njia za uthibitishaji na beji za Meta ni tofauti kwa nambari za Coexistence, na upatikanaji kwa kanda hubadilika kulingana na sera ya Meta.
Tunachokuelekezea, na tunachobaki nacho
Meta inaruhusu programu ku-override mahali WhatsApp Business Account inapofikisha webhook zake. Tunaweka override hiyo kwenye URL yako, jambo linalogawa matukio mara mbili.
messagesKila kitu ambacho mteja anatuma kwa nambarismb_message_echoesKile ambacho timu yako inatuma kutoka kwenye programu ya WhatsApp Business
account_updateHali ya muunganisho: imeondolewa, imetolewa (offboarded), imeunganishwa tena, imezuiliwaphone_number_quality_updateMabadiliko ya kiwango cha ubora na throughputaccount_alertsArifa ambazo Meta inatoa dhidi ya akauntiaccount_review_updateMatokeo ya ukaguzi wa Metabusiness_capability_updateMabadiliko ya kikomo cha ujumbe na uwezophone_number_name_updateIdhini na kukataliwa kwa jina linaloonyeshwa
Kama nambari haina override, matukio yake ya ujumbe hurudi kwenye callback yetu ya chaguo-msingi, ambapo handler huyatupa bila kuyahifadhi. Hilo linatekelezwa kwenye msimbo badala ya kuahidiwa kwenye sera: hakuna njia ya kuhifadhi ambayo maudhui ya mazungumzo yanaweza kupita.
Sheria ya siku kumi na nne, na kile inachovunja ambacho hakuna anayekitaja
Meta hukata muunganisho wa Coexistence baada ya takriban siku kumi na nne bila shughuli kwenye kifaa kikuu. Unaweza kuunganishwa tena, kwa hiyo tunauhifadhi kama hali yake yenyewe badala ya kuuhesabu kama mteja aliyeondoka.
Matokeo yanayowagharimu watu yanakuja baadaye. Mahali ujumbe wako unapofikishwa si mpangilio wa nambari, ni override kwenye usajili wa programu yetu kwa WhatsApp Business Account. Kukatika kwa muunganisho kunaondoa programu, na override inaondoka pamoja nayo. Ukiunganisha tena, kutuma kunafanya kazi, ufuatiliaji unafanya kazi, na ujumbe unaacha kufika kwenye server yako bila chochote kuripoti hitilafu.
Tunaweka override tena kila muunganisho unaporejeshwa. Tabia hiyo ipo kwa sababu jambo hili lilitokea: nambari moja iliguswa na sheria hii, ikaunganishwa tena bila tatizo, kisha ikaacha kufikisha ujumbe kimya kimya.
Handshake ikishindwa wakati huo, kwa sababu server yako ilikuwa chini au token ilibadilika, inarekodiwa kwenye ratiba ya matukio ya muunganisho na mahali pa kufikisha panabaki badala ya kufutwa, hivyo kuihifadhi tena kunatosha kurekebisha.
Kinachovunjika kimya kimya, na jinsi tunavyogundua
Programu ya WhatsApp Business inaendelea kufanya kazi katika karibu kila hitilafu iliyo hapa chini, ndiyo sababu hakuna anayegundua. Hizi ndizo tunazokagua, na jinsi tunavyofanya.
Hugunduliwa kutoka kwenye webhook ya account_update ya Meta, hasa PARTNER_REMOVED, badala ya kukisiwa kutokana na sehemu ya data kuwa false. Kwa makusudi hatusomi is_on_biz_app kwa hili, kwa sababu ni false kihalali kwenye nambari ambazo si Coexistence na ilikuwa ikisababisha kukatika kwa uongo.
Sheria ya Meta ya kutotumika kwa kifaa kikuu. Unaweza kuunganishwa tena, kwa hiyo unarekodiwa kama hali yake yenyewe badala ya mteja aliyeondoka, na kuunganisha tena kunarejesha kutuma na ufuatiliaji.
Mahali pa kufikisha panaishi kama override kwenye usajili wa programu yetu kwa akaunti, kwa hiyo kukatika kwa muunganisho kunaiondoa. Kutuma kunarudi ukiunganisha tena, lakini kufikisha kwenye server yako hakurudi. Tunaweka override tena kila mara, kwa sababu nambari iliyokumbwa na hili iliunganishwa tena bila tatizo na ikaacha kufikisha ujumbe kimya kimya.
Tunashikilia token ya mteja na System User token yetu wenyewe kwa akaunti ile ile. Moja ikikataliwa, nyingine inasoma akaunti na kuamua ni ipi kati ya hizo mbili iliyoharibika kweli, hivyo token iliyobatilishwa haionekani tena kama nambari iliyopotea.
Hukaguliwa kutoka Meta kwa ratiba. Kiwango cha RED huweka alama kwamba muunganisho umedhoofika, na ubora, ngazi ya ujumbe na kiwango cha throughput huhifadhiwa kwenye kila ukaguzi ili kushuka kuonekane kabla hakujagharimu ujumbe uliotumwa.
Kuunganisha nambari na kufuatilia nambari ni bidhaa tofauti. Ya pili ndiyo sababu hii ipo.
Muda wa kawaida wa kuunganisha nambari, kwa kuchanganua msimbo kutoka kwenye programu ya WhatsApp Business.
Muda ambao jibu la mteja huacha kipindi wazi kwa majibu ya maandishi huru.
Kasi ya kutuma kwa nambari ya Coexistence, iliyowekwa na Meta na isiyoweza kuongezwa.
Kiasi cha historia ya mazungumzo ambacho Meta husawazisha kwenye API nambari inapounganishwa mara ya kwanza.
Maswali yanayoulizwa mara kwa mara
Je, timu yangu lazima iache kutumia simu?
Hapana. Hilo ndilo lengo zima la Coexistence. Programu ya WhatsApp Business inaendelea kufanya kazi kwenye nambari ileile, ikiwa na mazungumzo yale yale, na API hufanya kazi sambamba nayo.
Je, nitapoteza mazungumzo yangu yaliyopo?
Hapana. Yanabaki kwenye programu, na Meta husawazisha takriban miezi sita ya historia kwenye API nambari inapounganishwa, hivyo programu ina muktadha badala ya kuanza bila chochote.
Je, ninaweza kubatilisha?
Ndiyo. Nambari inaweza kutenganishwa, na programu huendelea kama ilivyokuwa. Kuunganisha nambari hakubadilishi nambari yenyewe kwa kudumu.
Je, hii ni sawa na WhatsApp API zisizo rasmi?
Hapana, na tofauti hiyo huamua ikiwa nambari itadumu. Coexistence ni kipengele rasmi cha Meta kwenye Cloud API. Milango isiyo rasmi huendesha WhatsApp Web kama kifaa kilichounganishwa, jambo linalokiuka masharti na kusababisha nambari kupigwa marufuku.
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoSiku 3 bila malipo. Hutozwi chochote hadi kipindi cha majaribio kiishe.