Prijavite seZapočnite besplatni probni period
Meta Tech Provider

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.

Započnite besplatni probni period3 dana besplatno. Ništa se ne naplaćuje do kraja probnog perioda.
+1 415 555 0188
Aplikacija WhatsApp BusinessTim odgovara sa telefona, kao i ranije
Cloud APIVaši sistemi ili AI asistent, na istoj liniji
Oba interfejsa vide isti razgovor. Ono što API pošalje pojavljuje se u aplikaciji, a ono što tim otkuca u aplikaciji stiže kao događaj smb_message_echoes, pa softver nikada ne odgovara preko čoveka koji je već odgovorio.
Bez čuvanja poruka podrazumevanoBusiness App + Cloud APIMCP za Claude i ChatGPTRadi za 2 minuta

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.

PreJedan broj, jedan izbor
Zadržati aplikaciju

Tim odgovara sa telefona. Ništa ne može da se automatizuje, poveže ili izmeri.

Bez API-ja
Preći na API

Softver može da pristupi broju. Aplikacija Business na njemu prestaje da radi i tim menja alate.

Bez aplikacije
SadaJedan broj, oboje
Jedan broj
Aplikacija WhatsApp BusinessCloud API

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

Zadržava telefonFirma sa jednim brojem

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 brojeva, jedan nalogAgencija, konsultantska firma ili developer

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.

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

    Potrebno
    HTTPS endpoint koji vraća hub.challenge na GET zahtev kompanije Meta
    Vreme
    Oko jednog minuta
    Dobijate
    Odredište koje Meta može da proveri čim se broj poveže
    Još ništa nije povezano. Ovo određuje gde će poruke stizati.
    Provajder na putu porukaČuvaju se na njihovim serverima
    Meta
    Njihova platformaPrima i čuva poruke
    ViKopija, po njihovom rasporedu
    EasyCoexistenceSamo podešavanje
    Meta
    Vaš endpointJoš nije proveren
    MiPostavljamo rutu, ali nismo na njoj
  2. Pokrenite 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.

    Potrebno
    Pristup Business Portfolio i telefon sa tim brojem
    Vreme
    Dva do tri minuta
    Dobijate
    Cloud API povezan sa brojem koji aplikacija i dalje koristi
    Pojavljuje se drugi interfejs. Prvi se ne uklanja.
    Posle migracijeJedan interfejs
    Broj
    Samo Cloud APIAplikacija Business na ovom broju više ne radi
    Posle CoexistenceDva interfejsa
    Broj
    Aplikacija WhatsApp BusinessIsti razgovori i ista istorija
    Cloud APINa istoj liniji
  3. Usmerite 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.

    Potrebno
    Endpoint iz prvog koraka, sada proveren od strane kompanije Meta
    Vreme
    Primenjuje se čim se uključivanje završi
    Dobijate
    Poruke koje Meta isporučuje vama, bez nas na putu poruka
    Koji događaji idu kuda kada je override aktivan.
    Operativni događajiIsporučuju se nama
    account_updatePromene stanja veze
    phone_number_quality_updateKvalitet i propusnost
    account_review_updateIshodi provere
    Put porukaIsporučuju se vama
    messagesSve što klijent pošalje
    smb_message_echoesOno što tim šalje iz aplikacije
    Vaš serverDirektno, nikada preko nas
  4. Održ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.

    Potrebno
    Aplikacija koja se s vremena na vreme otvori na glavnom uređaju
    Vreme
    Stalno
    Dobijate
    Veza koja se nadzire i ruta koja preživi ponovno povezivanje
    Šta ponovno povezivanje samo vraća, a šta mora ponovo da se postavi.
    Vraća MetaAutomatski
    SlanjeCloud API ponovo radi
    Operativni događajiNadzor se nastavlja
    Nestaje sa aplikacijomMora ponovo da se primeni
    Override vašeg webhookaDeinstaliran zajedno sa aplikacijom
    Isporuka poruka vamaTiho prestaje
    Mi 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.
Slobodan tekstod 0 do 24 sata posle poslednje poruke klijentaSamo šablonposle toga, dok klijent ponovo ne napiše
Sat kreće ispočetka svaki put kada klijent nešto pošalje. To je pravilo koje ruši integracije u produkciji, jer se testiranje uvek odvija nekoliko sekundi posle poruke, kada slobodan tekst još radi.

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

Isporučuje se direktno na vaš endpointPut poruka. Podrazumevano nikada ne prolazi kroz nas.
  • messagesSve što klijent pošalje na broj
  • smb_message_echoesOno što vaš tim šalje iz aplikacije WhatsApp Business
Isporučuje se namaOperativni put. Od toga se sastoji nadzor.
  • account_updateStanje veze: uklonjena, odjavljena (offboarded), ponovo povezana, ograničena
  • phone_number_quality_updatePromene ocene kvaliteta i propusnosti
  • account_alertsUpozorenja koja Meta podiže protiv naloga
  • account_review_updateIshodi provere kompanije Meta
  • business_capability_updatePromene ograničenja poruka i mogućnosti
  • phone_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.

Broj je isključenWebhook, merodavan izvor

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.

Veza je bila neaktivna četrnaest danaPosebno stanje

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.

Ruta vašeg webhooka je nestala pri ponovnom povezivanjuAutomatski ponovo primenjeno

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.

Pristupni token je prestao da radiDva tokena, jedan odgovor

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.

Kvalitet je opaoPeriodično preuzimanje

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.

2 minutes

Uobičajeno vreme za povezivanje broja skeniranjem koda iz aplikacije WhatsApp Business.

24 hours

Koliko dugo odgovor korisnika održava sesiju otvorenom za slobodne tekstualne odgovore.

20 msg/s

Propusnost slanja za Coexistence broj, koju određuje Meta i ne može se povećati.

6 months

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.

Nastavite sa čitanjem