Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

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.

Započnite besplatno probno razdoblje3 dana besplatno. Ništa se ne naplaćuje do kraja probnog razdoblja.
+1 415 555 0188
Aplikacija WhatsApp BusinessTim odgovara s telefona, kao i prije
Cloud APIVaši sustavi ili AI asistent, na istoj liniji
Oba sučelja vide isti razgovor. Ono što API pošalje pojavljuje se u aplikaciji, a ono što tim upiše u aplikaciju stiže kao događaj smb_message_echoes, pa softver nikada ne odgovara preko čovjeka koji je već odgovorio.
Poruke se zadano ne pohranjujuBusiness App + Cloud APIMCP za Claude i ChatGPTAktivno za 2 minute

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.

PrijeJedan broj, jedan izbor
Zadržati aplikaciju

Tim odgovara s telefona. Ništa se ne može automatizirati, povezati ni izmjeriti.

Bez API-ja
Prijeći na API

Softver može pristupiti broju. Aplikacija Business na njemu prestaje raditi i tim mijenja alate.

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

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

Zadržava telefonTvrtka s jednim brojem

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 brojeva, jedan računAgencija, konzultantska tvrtka ili developer

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.

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

    Potrebno
    HTTPS endpoint koji vraća hub.challenge na Metin GET zahtjev
    Vrijeme
    Otprilike jedna minuta
    Dobivate
    Odredište koje Meta može provjeriti čim se broj poveže
    Još ništa nije povezano. Ovo određuje gdje će poruke stizati.
    Pružatelj usluge na putu porukaSpremaju se na njihovim poslužiteljima
    Meta
    Njihova platformaPrima i sprema poruke
    ViKopija, prema njihovu rasporedu
    EasyCoexistenceSamo konfiguracija
    Meta
    Vaš endpointJoš nije provjeren
    MiPostavljamo rutu, ali nismo na njoj
  2. Pokrenite 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.

    Potrebno
    Pristup Business Portfoliju i telefon s tim brojem
    Vrijeme
    Dvije do tri minute
    Dobivate
    Cloud API povezan s brojem koji aplikacija i dalje koristi
    Pojavljuje se drugo sučelje. Prvo se ne uklanja.
    Nakon migracijeJedno sučelje
    Broj
    Samo Cloud APIAplikacija Business na ovom broju više ne radi
    Nakon CoexistenceaDva sučelja
    Broj
    Aplikacija WhatsApp BusinessIsti razgovori i ista povijest
    Cloud APINa istoj liniji
  3. Usmjerite 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.

    Potrebno
    Endpoint iz prvog koraka, sada provjeren od strane Mete
    Vrijeme
    Primjenjuje se čim se uključivanje završi
    Dobivate
    Poruke koje Meta isporučuje vama, bez nas na putu poruka
    Koji događaji idu kamo kada je override aktivan.
    Operativni događajiIsporučuju se nama
    account_updatePromjene stanja veze
    phone_number_quality_updateKvaliteta i propusnost
    account_review_updateIshodi provjere
    Put porukaIsporučuju se vama
    messagesSve što klijent pošalje
    smb_message_echoesOno što tim šalje iz aplikacije
    Vaš poslužiteljIzravno, nikad preko nas
  4. Održ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.

    Potrebno
    Aplikacija koja se povremeno otvori na glavnom uređaju
    Vrijeme
    Stalno
    Dobivate
    Veza koja se nadzire i ruta koja preživi ponovno povezivanje
    Što ponovno povezivanje samo vraća, a što treba ponovno postaviti.
    Vraća MetaAutomatski
    SlanjeCloud API ponovno radi
    Operativni događajiNadzor se nastavlja
    Nestaje s aplikacijomTreba ponovno primijeniti
    Override vašeg webhookaDeinstaliran zajedno s aplikacijom
    Isporuka poruka vamaTiho prestaje
    Mi 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.
Slobodan tekstod 0 do 24 sata nakon posljednje poruke klijentaSamo predložaknakon toga, dok klijent ponovno ne napiše
Sat kreće ispočetka svaki put kad klijent nešto pošalje. To je pravilo koje ruši integracije u produkciji, jer se testiranje uvijek odvija nekoliko sekundi nakon poruke, kad slobodan tekst još radi.

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

Isporučuje se izravno na vaš endpointPut poruka. Prema zadanim postavkama nikad 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), ponovno povezana, ograničena
  • phone_number_quality_updatePromjene ocjene kvalitete i propusnosti
  • account_alertsUpozorenja koja Meta podiže protiv računa
  • account_review_updateIshodi Metine provjere
  • business_capability_updatePromjene ograničenja poruka i mogućnosti
  • phone_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.

Broj je odspojenWebhook, mjerodavan izvor

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.

Veza je bila neaktivna četrnaest danaZasebno stanje

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.

Ruta vašeg webhooka nestala je pri ponovnom povezivanjuAutomatski ponovno primijenjeno

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.

Pristupni token prestao je raditiDva tokena, jedan odgovor

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.

Kvaliteta je palaPeriodično dohvaćanje

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.

2 minutes

Uobičajeno vrijeme potrebno za povezivanje broja skeniranjem kôda iz aplikacije WhatsApp Business.

24 hours

Koliko dugo odgovor korisnika održava sesiju otvorenom za odgovore slobodnim tekstom.

20 msg/s

Propusnost slanja za broj s Coexistenceom, koju određuje Meta i nije je moguće povećati.

6 months

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.

Nastavite čitati