Jedan broj.Aplikacija i API, istovremeno.
Coexistence je zvanični režim kompanije Meta za istovremeno korišćenje aplikacije WhatsApp Business i Cloud API-ja na jednom broju. Tim nastavlja da odgovara sa telefona, uz iste razgovore i istu istoriju, dok softver šalje i prima poruke na istoj liniji.
EasyCoexistence povezuje broj, a zatim prati vezu.
Izbor koji je nekada postojao, a više ne postoji
Coexistence nije novi API. To je uklanjanje račvanja koje je gotovo svaku malu firmu sprečavalo da bilo šta automatizuje.
Tim odgovara sa telefona. Ništa ne može da se automatizuje, poveže ili izmeri.
Bez API-jaSoftver može da pristupi broju. Aplikacija Business na njemu prestaje da radi i tim menja alate.
Bez aplikacijeMeta povezuje Cloud API sa brojem koji aplikacija WhatsApp Business i dalje koristi. Oba interfejsa su aktivna na istoj liniji i svaki vidi šta onaj drugi šalje.
Ko ovako koristi broj
Dve grupe koje od iste funkcije žele suprotne stvari, i zato je veza važnija od bilo koje kontrolne table iznad nje.
Mali tim, broj ispisan na kombiju ili izlogu i večeri provedene u odgovaranju na ista četiri pitanja. Ne zamenjuju nikoga. Žele da se potvrde, podsetnici i prvi odgovor van radnog vremena dešavaju bez čoveka, dok telefon i dalje služi za sve ostalo.
Mnogo klijenata, svaki sa brojem koji niko ne sme da migrira ili dira. Potrebno im je da ti brojevi budu dostupni sistemima koje grade i da sledeći broj mogu da dodaju bez prodajnog razgovora. Coexistence je jedini zvanični put do broja na koji osoblje klijenta i dalje odgovara ručno.
Kako broj radi na oba mesta i kuda idu događaji poruka
Četiri koraka. Jedini koji dira telefon je skeniranje, a onaj koji određuje vašu arhitekturu je prvi.
Pripremite endpoint pre početka uključivanja
Meta proverava odredište pre nego što na njega bilo šta isporuči. Poziva vaš URL zahtevom GET sa parametrima hub.mode=subscribe, vašim hub.verify_token i hub.challenge, a vaš endpoint mora da vrati challenge nepromenjen.
Odredište mora biti HTTPS, a verify token je obavezan. Oba proveravamo pre nego što se poziv uputi, pa neispravan URL pada već kod nas, umesto da izgleda povezano i ništa ne isporučuje.
Još ništa nije povezano. Ovo određuje gde će poruke stizati. Provajder na putu porukaČuvaju se na njihovim serverimaNjihova platformaPrima i čuva porukeViKopija, po njihovom rasporeduEasyCoexistenceSamo podešavanjeVaš endpointJoš nije proverenMiPostavljamo rutu, ali nismo na njojPokrenite Embedded Signup kompanije Meta i skenirajte kod u aplikaciji
Otvara se prozor same kompanije Meta. Birate Business Portfolio, WhatsApp Business nalog i broj koji je već registrovan u aplikaciji WhatsApp Business, a zatim vezu odobravate na telefonu skeniranjem koda.
Ovde takođe birate da li ćete deliti postojeću istoriju razgovora. To je jednokratna odluka tokom uključivanja i posle ne može da se promeni. Aplikacija Business nastavlja da radi čim se skeniranje završi.
Pojavljuje se drugi interfejs. Prvi se ne uklanja. Posle migracijeJedan interfejsSamo Cloud APIAplikacija Business na ovom broju više ne radiPosle CoexistenceDva interfejsaAplikacija WhatsApp BusinessIsti razgovori i ista istorijaCloud APINa istoj linijiUsmerite događaje poruka na sopstveni sistem
Meta dozvoljava aplikaciji da promeni gde se isporučuju webhookovi određenog WhatsApp Business naloga. Taj override postavljamo na vaš URL, čime se dva polja puta poruka, messages i smb_message_echoes, šalju direktno od kompanije Meta vama.
Operativna polja zadržavamo, jer se od njih sastoji nadzor: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update i phone_number_name_update. Tako kontrolna tabla ostaje korisna, a sadržaj razgovora nikada ne prolazi kroz nas.
Koji događaji idu kuda kada je override aktivan. Operativni događajiIsporučuju se namaPut porukaIsporučuju se vamamessagesSve što klijent pošaljesmb_message_echoesOno što tim šalje iz aplikacijeVaš serverDirektno, nikada preko nasOdržavajte vezu aktivnom i preživite ponovno povezivanje
Meta prekida Coexistence vezu posle otprilike četrnaest dana bez aktivnosti na glavnom uređaju. Veza može ponovo da se uspostavi, pa je beležimo kao posebno stanje, a ne kao klijenta koji je otišao.
Zamka je u tome šta prekid veze radi sa rutom. Meta čuva odredište kao override na pretplati naše aplikacije na nalog, pa PARTNER_REMOVED deinstalira aplikaciju i override nestaje sa njom. Ponovno povezivanje vraća slanje i nadzor, ali ne i vaše odredište. Mi ga automatski vraćamo, jer se prvi broj koji je naleteo na ovo pravilo uredno ponovo povezao i tiho prestao da isporučuje poruke na server klijenta.
Šta ponovno povezivanje samo vraća, a šta mora ponovo da se postavi. Vraća MetaAutomatskiSlanjeCloud API ponovo radiOperativni događajiNadzor se nastavljaNestaje sa aplikacijomMora ponovo da se primeniOverride vašeg webhookaDeinstaliran zajedno sa aplikacijomIsporuka poruka vamaTiho prestajeMi ga ponovo primenjujemoPri svakom ponovnom povezivanju
Zašto timovi ovako koriste broj
- Zadržati broj koji je već odštampan na vozilima, računima i sajtu, kao i mobilni način rada oko njega.
- Dodati slanje preko API-ja, obradu webhookova i šablone bez prebacivanja bilo koga na novi alat.
- Držati saobraćaj poruka van zajedničkog sandučeta provajdera, kako razgovori ne bi bili na tuđoj platformi.
- Omogućiti agenciji da drži brojeve mnogih klijenata na jednom nalogu, svaki povezan u Business Portfolio samog klijenta.
Uslovi i praktična ograničenja
- Broj već mora biti aktivan u aplikaciji WhatsApp Business. Broj iz obične aplikacije WhatsApp prvo treba prebaciti tamo.
- Deljenje postojeće istorije razgovora je jednokratan izbor tokom uključivanja i posle ne može da se promeni.
- Grupni razgovori su isključeni iz API-ja na Coexistence brojevima, kod svakog provajdera.
- Glavnom uređaju je potrebna povremena aktivnost. Meta prekida vezu posle otprilike četrnaest dana bez nje.
- Postupci verifikacije i dobijanja oznake kompanije Meta razlikuju se za Coexistence brojeve, a regionalna dostupnost se menja sa pravilima kompanije Meta.
Šta usmeravamo vama, a šta zadržavamo
Meta dozvoljava aplikaciji da promeni gde WhatsApp Business nalog isporučuje svoje webhookove. Taj override postavljamo na vaš URL, čime se događaji dele na dva dela.
messagesSve što klijent pošalje na brojsmb_message_echoesOno što vaš tim šalje iz aplikacije WhatsApp Business
account_updateStanje veze: uklonjena, odjavljena (offboarded), ponovo povezana, ograničenaphone_number_quality_updatePromene ocene kvaliteta i propusnostiaccount_alertsUpozorenja koja Meta podiže protiv nalogaaccount_review_updateIshodi provere kompanije Metabusiness_capability_updatePromene ograničenja poruka i mogućnostiphone_number_name_updateOdobrenja i odbijanja imena za prikaz
Ako broj nema postavljen override, njegovi događaji poruka padaju na naš podrazumevani callback, gde ih handler odbacuje bez čuvanja. To je obezbeđeno u kodu, a ne obećano u pravilima: sadržaj razgovora jednostavno nema put do skladišta.
Pravilo četrnaest dana i ono što kvari, a što niko ne pominje
Meta prekida Coexistence vezu posle otprilike četrnaest dana bez aktivnosti na glavnom uređaju. Veza može ponovo da se uspostavi, pa je beležimo kao posebno stanje, a ne kao klijenta koji je otišao.
Posledica koja košta dolazi kasnije. Odredište vaših poruka nije podešavanje broja, već override na pretplati naše aplikacije na WhatsApp Business nalogu. Prekid veze deinstalira aplikaciju, a override nestaje sa njom. Ponovo se povežete, slanje radi, nadzor radi, a poruke prestaju da stižu na vaš server i ništa ne prijavljuje grešku.
Override ponovo primenjujemo pri svakom ponovnom povezivanju. To ponašanje postoji zato što se to desilo: jedan broj je naleteo na ovo pravilo, uredno se ponovo povezao i tiho prestao da isporučuje poruke.
Neuspeo handshake u tom trenutku, zato što vaš server nije radio ili se token promenio, beleži se na vremenskoj liniji veze, a odredište se čuva umesto da se odbaci, pa je dovoljno ponovo ga sačuvati da se problem reši.
Šta se tiho pokvari i kako to saznajemo
Aplikacija WhatsApp Business nastavlja da radi kroz gotovo svaki od kvarova ispod, i zato ih niko ne primeti. Ovo su oni koje proveravamo i način na koji to radimo.
Otkriva se iz webhooka account_update kompanije Meta, tačnije PARTNER_REMOVED, a ne zaključuje se iz polja koje postane false. Namerno za ovo ne čitamo is_on_biz_app, jer je ono opravdano false na brojevima koji nisu Coexistence i izazivalo je lažne prekide veze.
Pravilo kompanije Meta o neaktivnosti glavnog uređaja. Veza može ponovo da se uspostavi, pa se beleži kao posebno stanje, a ne kao klijent koji je otišao, a ponovno povezivanje vraća slanje i nadzor.
Odredište postoji kao override na pretplati naše aplikacije na nalog, pa ga prekid veze deinstalira. Slanje se vraća pri ponovnom povezivanju, a isporuka na vaš server ne. Override ponovo primenjujemo svaki put, jer se broj kojem se to desilo uredno ponovo povezao i tiho prestao da isporučuje poruke.
Za isti nalog čuvamo token klijenta i sopstveni System User token. Kada jedan bude odbijen, drugi čita nalog i utvrđuje koji se od njih zaista pokvario, pa opozvani token više ne izgleda kao izgubljeni broj.
Preuzima se od kompanije Meta po rasporedu. Ocena RED označava vezu kao narušenu, a kvalitet, nivo slanja poruka i nivo propusnosti čuvaju se pri svakoj proveri, pa je pad vidljiv pre nego što košta neko slanje.
Povezivanje broja i nadzor broja su dva različita proizvoda. Ovaj drugi je razlog zašto ovo postoji.
Uobičajeno vreme za povezivanje broja skeniranjem koda iz aplikacije WhatsApp Business.
Koliko dugo odgovor korisnika održava sesiju otvorenom za slobodne tekstualne odgovore.
Propusnost slanja za Coexistence broj, koju određuje Meta i ne može se povećati.
Količina istorije razgovora koju Meta sinhronizuje sa API-jem pri prvom povezivanju broja.
Često postavljana pitanja
Da li moj tim mora da prestane da koristi telefon?
Ne. To je cela poenta funkcije Coexistence. Aplikacija WhatsApp Business nastavlja da radi na istom broju, sa istim razgovorima, dok API radi uporedo s njom.
Da li ću izgubiti postojeće razgovore?
Ne. Oni ostaju u aplikaciji, a Meta sinhronizuje oko šest meseci istorije sa API-jem kada se broj poveže, pa softver ima kontekst umesto da počinje bez njega.
Mogu li da poništim povezivanje?
Da. Broj može da se odveže, a aplikacija nastavlja da radi kao i ranije. Povezivanje ne menja trajno ništa na samom broju.
Da li je ovo isto što i nezvanični WhatsApp API-ji?
Ne, a ta razlika odlučuje da li će broj opstati. Coexistence je zvanična funkcija kompanije Meta na Cloud API-ju. Nezvanični pristupnici pokreću WhatsApp Web kao povezani uređaj, čime krše uslove i dovode do blokiranja brojeva.
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni period3 dana besplatno. Ništa se ne naplaćuje do kraja probnog perioda.