IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

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.

Anza kipindi cha majaribio bila malipoSiku 3 bila malipo. Hutozwi chochote hadi kipindi cha majaribio kiishe.
+1 415 555 0188
Programu ya WhatsApp BusinessTimu inajibu kutoka kwenye simu, kama awali
Cloud APIMifumo yako, au msaidizi wa AI, kwenye laini hiyo hiyo
Vyote viwili vinaona mazungumzo yale yale. Kile API inachotuma kinaonekana kwenye programu, na kile timu inachoandika kwenye programu kinafika kama tukio la smb_message_echoes, hivyo mifumo haijibu kamwe juu ya mtu ambaye tayari amejibu.
Jumbe hazihifadhiwi kwa chaguo-msingiBusiness App + Cloud APIMCP kwa Claude na ChatGPTAnza ndani ya dakika 2

Chaguo lililokuwepo, na halipo tena

Coexistence si API mpya. Ni kuondolewa kwa njia panda iliyozuia karibu kila biashara ndogo kuweka chochote kiotomatiki.

ZamaniNambari moja, chaguo moja
Kubaki na programu

Timu inajibu kutoka kwenye simu. Hakuna kinachoweza kuwekwa kiotomatiki, kuunganishwa au kupimwa.

Hakuna API
Kuhamia kwenye API

Mifumo inaweza kufikia nambari. Programu ya Business inaacha kufanya kazi kwenye nambari hiyo na timu inahamia zana nyingine.

Hakuna programu
SasaNambari moja, vyote viwili
Nambari moja
Programu ya WhatsApp BusinessCloud API

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

Inabaki na simuBiashara yenye nambari moja

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.

Nambari nyingi, akaunti mojaWakala, kampuni ya ushauri au developer

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.

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

    Inahitaji
    Endpoint ya HTTPS inayorudisha hub.challenge kwenye GET ya Meta
    Muda
    Takriban dakika moja
    Unapata
    Mahali pa kufikisha ambapo Meta inaweza kupathibitisha mara nambari inapounganishwa
    Hakuna kilichounganishwa bado. Hatua hii inaamua ujumbe utafika wapi.
    Mtoa huduma katikatiHuhifadhiwa kwenye server zao
    Meta
    Jukwaa laoHupokea na kuhifadhi ujumbe
    WeweNakala, kwa ratiba yao
    EasyCoexistenceMipangilio tu
    Meta
    Endpoint yakoBado haijathibitishwa
    SisiTunaweka njia, lakini hatumo ndani yake
  2. Endesha 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.

    Inahitaji
    Ufikiaji wa Business Portfolio, na simu yenye nambari hiyo
    Muda
    Dakika mbili hadi tatu
    Unapata
    Cloud API imeunganishwa na nambari ambayo programu bado inaitumia
    Upande wa pili unaonekana. Upande wa kwanza hauondolewi.
    Baada ya kuhamishaUpande mmoja
    Nambari
    Cloud API pekeeProgramu ya Business haifanyi kazi tena kwenye nambari hii
    Baada ya CoexistencePande mbili
    Nambari
    Programu ya WhatsApp BusinessMazungumzo na historia ile ile
    Cloud APIKwenye laini ile ile
  3. Elekeza 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.

    Inahitaji
    Endpoint kutoka hatua ya kwanza, sasa imethibitishwa na Meta
    Muda
    Hutumika mara onboarding inapokamilika
    Unapata
    Ujumbe unafikishwa kutoka Meta hadi kwako, bila sisi kuwa kwenye njia ya ujumbe
    Matukio yapi yanakwenda wapi mara override inapoanza kufanya kazi.
    Matukio ya kiutendajiHufikishwa kwetu
    account_updateMabadiliko ya hali ya muunganisho
    phone_number_quality_updateUbora na throughput
    account_review_updateMatokeo ya ukaguzi
    Njia ya ujumbeHufikishwa kwako
    messagesKila kitu ambacho mteja anatuma
    smb_message_echoesKile timu inachotuma kutoka kwenye programu
    Server yakoMoja kwa moja, kamwe si kupitia kwetu
  4. Weka 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.

    Inahitaji
    Programu kufunguliwa kwenye kifaa kikuu mara kwa mara
    Muda
    Endelevu
    Unapata
    Muunganisho unaofuatiliwa, na njia inayodumu hata baada ya kuunganishwa tena
    Kile ambacho kuunganisha tena kunarejesha chenyewe, na kile kinachopaswa kurudishwa.
    Hurejeshwa na MetaKiotomatiki
    KutumaCloud API inafanya kazi tena
    Matukio ya kiutendajiUfuatiliaji unaendelea tena
    Hupotea pamoja na programuLazima iwekwe tena
    Override ya webhook yakoHuondolewa pamoja na programu
    Kufikisha ujumbe kwakoHukoma kimya kimya
    Tunaiweka 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.
Maandishi hurusaa 0 hadi 24 baada ya ujumbe wao wa mwishoTemplate pekeebaada ya hapo, hadi waandike tena
Saa huanza upya kila mara mteja anapotuma kitu. Hii ndiyo sheria inayovunja integration katika uzalishaji, kwa sababu majaribio hufanyika sekunde chache baada ya ujumbe, wakati maandishi huru bado yanafanya kazi.

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.

Hufikishwa moja kwa moja kwenye endpoint yakoNjia ya ujumbe. Kwa chaguo-msingi haipiti kwetu kamwe.
  • messagesKila kitu ambacho mteja anatuma kwa nambari
  • smb_message_echoesKile ambacho timu yako inatuma kutoka kwenye programu ya WhatsApp Business
Hufikishwa kwetuNjia ya uendeshaji. Ufuatiliaji umejengwa kwa hili.
  • account_updateHali ya muunganisho: imeondolewa, imetolewa (offboarded), imeunganishwa tena, imezuiliwa
  • phone_number_quality_updateMabadiliko ya kiwango cha ubora na throughput
  • account_alertsArifa ambazo Meta inatoa dhidi ya akaunti
  • account_review_updateMatokeo ya ukaguzi wa Meta
  • business_capability_updateMabadiliko ya kikomo cha ujumbe na uwezo
  • phone_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.

Nambari ilikatwaWebhook, chanzo rasmi

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.

Muunganisho ulikaa kimya kwa siku kumi na nneHali yake yenyewe

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.

Njia ya webhook yako ilipotea wakati wa kuunganisha tenaHuwekwa tena kiotomatiki

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.

Access token iliacha kufanya kaziToken mbili, jibu moja

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.

Ubora ulishukaHukaguliwa kwa ratiba

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.

2 minutes

Muda wa kawaida wa kuunganisha nambari, kwa kuchanganua msimbo kutoka kwenye programu ya WhatsApp Business.

24 hours

Muda ambao jibu la mteja huacha kipindi wazi kwa majibu ya maandishi huru.

20 msg/s

Kasi ya kutuma kwa nambari ya Coexistence, iliyowekwa na Meta na isiyoweza kuongezwa.

6 months

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.

Endelea kusoma