Jedan broj.Aplikacija i API, istodobno.
Coexistence je Metin službeni način istodobnog korištenja aplikacije WhatsApp Business i Cloud API-ja na jednom broju. Tim i dalje odgovara s telefona, u istim razgovorima i s istom poviješću, dok softver šalje i prima poruke na istoj liniji.
EasyCoexistence povezuje broj i zatim nadzire vezu.
Izbor koji je nekad postojao, a više ne postoji
Coexistence nije novi API. To je uklanjanje račvanja koje je gotovo svaku malu tvrtku sprječavalo da išta automatizira.
Tim odgovara s telefona. Ništa se ne može automatizirati, povezati ni izmjeriti.
Bez API-jaSoftver može pristupiti broju. Aplikacija Business na njemu prestaje raditi i tim mijenja alate.
Bez aplikacijeMeta povezuje Cloud API s brojem koji aplikacija WhatsApp Business i dalje koristi. Oba sučelja aktivna su na istoj liniji i svako vidi što drugo šalje.
Tko ovako koristi broj
Dvije skupine koje od iste značajke žele suprotne stvari, i zato je veza važnija od bilo koje nadzorne ploče iznad nje.
Mali tim, broj ispisan na kombiju ili izlogu i večeri provedene u odgovaranju na ista četiri pitanja. Nikoga ne zamjenjuju. Žele da se potvrde, podsjetnici i prvi odgovor izvan radnog vremena odvijaju bez čovjeka, dok telefon i dalje služi za sve ostalo.
Mnogo klijenata, svaki s brojem koji nitko ne smije migrirati ni dirati. Trebaju da ti brojevi budu dostupni sustavima koje grade i da sljedeći broj mogu dodati bez prodajnog razgovora. Coexistence je jedini službeni put do broja na koji osoblje klijenta i dalje odgovara ručno.
Kako broj radi na oba mjesta i kamo idu događaji poruka
Četiri koraka. Jedini koji dira telefon je skeniranje, a onaj koji određuje vašu arhitekturu je prvi.
Pripremite endpoint prije početka uključivanja
Meta provjerava odredište prije nego što na njega išta isporuči. Poziva vaš URL zahtjevom GET s parametrima hub.mode=subscribe, vašim hub.verify_token i hub.challenge, a vaš endpoint mora vratiti challenge nepromijenjen.
Odredište mora biti HTTPS, a verify token je obavezan. Oboje provjeravamo prije nego što se poziv uputi, pa neispravan URL pada već kod nas, umjesto da izgleda povezano i ništa ne isporučuje.
Još ništa nije povezano. Ovo određuje gdje će poruke stizati. Pružatelj usluge na putu porukaSpremaju se na njihovim poslužiteljimaNjihova platformaPrima i sprema porukeViKopija, prema njihovu rasporeduEasyCoexistenceSamo konfiguracijaVaš endpointJoš nije provjerenMiPostavljamo rutu, ali nismo na njojPokrenite Metin Embedded Signup i skenirajte kôd u aplikaciji
Otvara se Metin vlastiti skočni prozor. Odabirete Business Portfolio, račun WhatsApp Business i broj koji je već registriran u aplikaciji WhatsApp Business, a zatim vezu odobravate na telefonu skeniranjem kôda.
Ovdje također birate hoćete li dijeliti postojeću povijest razgovora. To je jednokratna odluka tijekom uključivanja i poslije se ne može promijeniti. Aplikacija Business nastavlja raditi čim se skeniranje završi.
Pojavljuje se drugo sučelje. Prvo se ne uklanja. Nakon migracijeJedno sučeljeSamo Cloud APIAplikacija Business na ovom broju više ne radiNakon CoexistenceaDva sučeljaAplikacija WhatsApp BusinessIsti razgovori i ista povijestCloud APINa istoj linijiUsmjerite događaje poruka na vlastiti sustav
Meta dopušta aplikaciji da promijeni kamo se isporučuju webhookovi određenog računa WhatsApp Business. Taj override postavljamo na vaš URL, čime se dva polja puta poruka, messages i smb_message_echoes, šalju izravno od Mete 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 nadzorna ploča ostaje korisna, a sadržaj razgovora nikad ne prolazi kroz nas.
Koji događaji idu kamo 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š poslužiteljIzravno, nikad preko nasOdržavajte vezu aktivnom i preživite ponovno povezivanje
Meta prekida Coexistence vezu nakon otprilike četrnaest dana bez aktivnosti na glavnom uređaju. Veza se može ponovno uspostaviti, pa to bilježimo kao zasebno stanje, a ne kao klijenta koji je otišao.
Zamka je u tome što prekid veze čini s rutom. Meta sprema odredište kao override na pretplati naše aplikacije na račun, pa PARTNER_REMOVED deinstalira aplikaciju i override nestaje s 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 naletio na ovo pravilo uredno ponovno povezao i tiho prestao isporučivati poruke na klijentov poslužitelj.
Što ponovno povezivanje samo vraća, a što treba ponovno postaviti. Vraća MetaAutomatskiSlanjeCloud API ponovno radiOperativni događajiNadzor se nastavljaNestaje s aplikacijomTreba ponovno primijenitiOverride vašeg webhookaDeinstaliran zajedno s aplikacijomIsporuka poruka vamaTiho prestajeMi ga ponovno primjenjujemoPri svakom ponovnom povezivanju
Zašto timovi ovako koriste broj
- Zadržati broj koji je već otisnut na vozilima, računima i web-stranici te mobilni način rada oko njega.
- Dodati slanje putem API-ja, obradu webhookova i predloške bez premještanja ikoga u novi alat.
- Držati promet poruka izvan zajedničkog sandučića pružatelja usluge, kako razgovori ne bi bili na tuđoj platformi.
- Omogućiti agenciji da drži brojeve mnogih klijenata na jednom računu, svaki povezan u Business Portfolio samog klijenta.
Uvjeti i praktična ograničenja
- Broj već mora biti aktivan u aplikaciji WhatsApp Business. Broj iz obične aplikacije WhatsApp najprije treba premjestiti onamo.
- Dijeljenje postojeće povijesti razgovora jednokratan je izbor tijekom uključivanja i poslije se ne može promijeniti.
- Grupni razgovori isključeni su iz API-ja na Coexistence brojevima, kod svakog pružatelja usluge.
- Glavni uređaj treba povremenu aktivnost. Meta prekida vezu nakon otprilike četrnaest dana bez nje.
- Postupci Metine provjere i dobivanja oznake razlikuju se za Coexistence brojeve, a regionalna dostupnost mijenja se s Metinim pravilima.
Što usmjeravamo vama, a što zadržavamo
Meta dopušta aplikaciji da promijeni kamo račun WhatsApp Business isporučuje svoje webhookove. Taj override postavljamo na vaš URL, čime se događaji dijele na dva dijela.
messagesSve što klijent pošalje na brojsmb_message_echoesOno što vaš tim šalje iz aplikacije WhatsApp Business
account_updateStanje veze: uklonjena, odjavljena (offboarded), ponovno povezana, ograničenaphone_number_quality_updatePromjene ocjene kvalitete i propusnostiaccount_alertsUpozorenja koja Meta podiže protiv računaaccount_review_updateIshodi Metine provjerebusiness_capability_updatePromjene ograničenja poruka i mogućnostiphone_number_name_updateOdobrenja i odbijanja prikaznog imena
Ako broj nema postavljen override, njegovi događaji poruka padaju na naš zadani callback, gdje ih handler odbacuje bez spremanja. To je osigurano u kôdu, a ne obećano u pravilima: sadržaj razgovora jednostavno nema put do pohrane.
Pravilo četrnaest dana i ono što kvari, a nitko to ne spominje
Meta prekida Coexistence vezu nakon otprilike četrnaest dana bez aktivnosti na glavnom uređaju. Veza se može ponovno uspostaviti, pa to bilježimo kao zasebno stanje, a ne kao klijenta koji je otišao.
Posljedica koja stoji novca dolazi kasnije. Odredište vaših poruka nije postavka broja, nego override na pretplati naše aplikacije na račun WhatsApp Business. Prekid veze deinstalira aplikaciju, a override nestaje s njom. Ponovno se povežete, slanje radi, nadzor radi, a poruke prestaju stizati na vaš poslužitelj i ništa ne javlja pogrešku.
Override ponovno primjenjujemo pri svakom ponovnom povezivanju. To ponašanje postoji jer se to dogodilo: jedan je broj naletio na ovo pravilo, uredno se ponovno povezao i tiho prestao isporučivati poruke.
Neuspjeli handshake u tom trenutku, zato što vaš poslužitelj nije radio ili se token promijenio, bilježi se na vremenskoj crti veze, a odredište se zadržava umjesto da se odbaci, pa ga je dovoljno ponovno spremiti da se problem riješi.
Što se tiho pokvari i kako to saznajemo
Aplikacija WhatsApp Business nastavlja raditi kroz gotovo svaki od kvarova u nastavku, i zato ih nitko ne primijeti. Ovo su oni koje provjeravamo i način na koji to radimo.
Otkriva se iz Metina webhooka account_update, točnije PARTNER_REMOVED, a ne zaključuje iz polja koje postane false. Namjerno za to ne čitamo is_on_biz_app, jer je ono opravdano false na brojevima koji nisu Coexistence i uzrokovalo je lažne prekide veze.
Metino pravilo o neaktivnosti glavnog uređaja. Veza se može ponovno uspostaviti, pa se bilježi kao zasebno 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 račun, pa ga prekid veze deinstalira. Slanje se vraća pri ponovnom povezivanju, a isporuka na vaš poslužitelj ne. Override ponovno primjenjujemo svaki put, jer se broj kojemu se to dogodilo uredno ponovno povezao i tiho prestao isporučivati poruke.
Za isti račun čuvamo token klijenta i vlastiti System User token. Kad jedan bude odbijen, drugi čita račun i utvrđuje koji se od njih zapravo pokvario, pa opozvani token više ne izgleda kao izgubljeni broj.
Dohvaća se od Mete prema rasporedu. Ocjena RED označava vezu kao narušenu, a kvaliteta, razina slanja poruka i razina propusnosti spremaju se pri svakoj provjeri, pa je pad vidljiv prije nego što stoji neko slanje.
Povezivanje broja i nadzor broja dva su različita proizvoda. Upravo zbog ovog drugog ovo postoji.
Uobičajeno vrijeme potrebno za povezivanje broja skeniranjem kôda iz aplikacije WhatsApp Business.
Koliko dugo odgovor korisnika održava sesiju otvorenom za odgovore slobodnim tekstom.
Propusnost slanja za broj s Coexistenceom, koju određuje Meta i nije je moguće povećati.
Koliko povijesti razgovora Meta sinkronizira s API-jem pri prvom povezivanju broja.
Često postavljana pitanja
Mora li moj tim prestati koristiti telefon?
Ne. To je cijela poanta Coexistencea. Aplikacija WhatsApp Business nastavlja raditi na istom broju, s istim razgovorima, dok API radi uz nju.
Hoću li izgubiti postojeće razgovore?
Ne. Ostaju u aplikaciji, a Meta sinkronizira otprilike šest mjeseci povijesti s API-jem kada se broj poveže, pa softver ima kontekst umjesto da počinje od praznog.
Mogu li to poništiti?
Da. Broj se može odspojiti, a aplikacija nastavlja raditi kao i prije. Povezivanje ne mijenja trajno ništa na samom broju.
Je li to isto što i neslužbeni WhatsApp API-ji?
Ne, a ta razlika odlučuje hoće li broj opstati. Coexistence je Metina službena značajka na Cloud API-ju. Neslužbeni pristupnici pokreću WhatsApp Web kao povezani uređaj, čime se krše uvjeti i brojevi bivaju blokirani.
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdoblje3 dana besplatno. Ništa se ne naplaćuje do kraja probnog razdoblja.