Yksi numero.Sovellus ja API samaan aikaan.
Coexistence on Metan virallinen tila, jossa WhatsApp Business -sovellus ja Cloud API toimivat samalla numerolla yhtä aikaa. Tiimi vastaa edelleen puhelimella samoissa keskusteluissa ja saman historian kanssa, samalla kun ohjelmisto lähettää ja vastaanottaa viestejä samalla linjalla.
EasyCoexistence yhdistää numeron ja valvoo yhteyttä sen jälkeen.
Valinta, joka ennen oli pakko tehdä, eikä ole enää
Coexistence ei ole uusi API. Se poistaa tienhaaran, joka esti lähes jokaista pienyritystä automatisoimasta mitään.
Tiimi vastaa puhelimella. Mitään ei voi automatisoida, kytkeä järjestelmiin eikä mitata.
Ei API:aOhjelmisto pääsee numeroon käsiksi. Business-sovellus lakkaa toimimasta numerolla ja tiimi vaihtaa työkaluja.
Ei sovellustaMeta yhdistää Cloud API -rajapinnan numeroon, jota WhatsApp Business -sovellus edelleen käyttää. Molemmat ovat käytössä samalla linjalla, ja kumpikin näkee, mitä toinen lähettää.
Kuka käyttää numeroa näin
Kaksi ryhmää, jotka haluavat samalta ominaisuudelta päinvastaisia asioita. Siksi yhteys on tärkeämpi kuin mikään sen päälle rakennettu hallintapaneeli.
Pieni tiimi, numero pakettiauton kyljessä tai liikkeen ikkunassa, ja illat kuluvat samaan neljään kysymykseen vastaamiseen. He eivät korvaa ketään. He haluavat, että vahvistukset, muistutukset ja ensimmäinen vastaus aukioloaikojen jälkeen hoituvat ilman ihmistä, samalla kun puhelin toimii kaikkeen muuhun.
Monta asiakasta, joilla kaikilla on numero, jota kukaan ei saa siirtää tai muuttaa. Heidän rakentamiensa järjestelmien täytyy tavoittaa nämä numerot, ja seuraava numero pitää voida lisätä ilman myyntipuhelua. Coexistence on ainoa virallinen tie numeroon, johon asiakkaan henkilökunta vastaa yhä käsin.
Miten numero päätyy molempiin ja minne viestitapahtumat menevät
Neljä vaihetta. Ainoa puhelimeen koskeva vaihe on skannaus, ja arkkitehtuurisi ratkaisee ensimmäinen.
Pidä endpoint valmiina ennen kuin käyttöönotto alkaa
Meta vahvistaa kohteen ennen kuin toimittaa sinne mitään. Se kutsuu URL-osoitettasi GET-pyynnöllä, jossa on hub.mode=subscribe, oma hub.verify_token-arvosi ja hub.challenge, ja endpointisi on palautettava hub.challenge-arvo sellaisenaan.
Kohteen on oltava HTTPS-osoite, ja vahvistustoken on pakollinen. Tarkistamme molemmat ennen kutsua, joten virheellinen URL hylätään jo meillä eikä se näytä yhdistetyltä toimittamatta mitään.
Mitään ei ole vielä yhdistetty. Tämä ratkaisee, minne viestit päätyvät. Palveluntarjoaja välissäTallennetaan heidän palvelimilleenHeidän alustansaVastaanottaa ja tallentaa viestitSinäKopio, heidän aikataulullaanEasyCoexistenceVain asetuksetEndpointisiEi vielä vahvistettuMeAsetamme reitin, emme ole silläKäy läpi Metan Embedded Signup ja skannaa sovelluksessa
Metan oma ponnahdusikkuna avautuu. Valitset Business Portfolion, WhatsApp Business Account -tilin ja numeron, joka on jo rekisteröity WhatsApp Business -sovellukseen, ja hyväksyt yhteyden puhelimella skannaamalla koodin.
Tässä valitset myös, jaetaanko olemassa oleva keskusteluhistoria. Se on kertaluonteinen käyttöönottopäätös, eikä sitä voi muuttaa myöhemmin. Business-sovellus toimii edelleen heti, kun skannaus on valmis.
Toinen kanava ilmestyy. Ensimmäistä ei poisteta. Siirron jälkeenYksi kanavaVain Cloud APIBusiness-sovellus ei enää toimi tällä numerollaCoexistencen jälkeenKaksi kanavaaWhatsApp Business -sovellusSamat keskustelut ja historiaCloud APISamalla linjallaOhjaa viestitapahtumat omaan järjestelmääsi
Meta antaa sovelluksen ohittaa sen, minne tietyn WhatsApp Business Account -tilin webhookit toimitetaan. Asetamme ohituksen osoittamaan URL-osoitteeseesi, jolloin viestireitin kaksi kenttää, messages ja smb_message_echoes, kulkevat suoraan Metalta sinulle.
Pidämme toiminnalliset kentät, koska niistä valvonta koostuu: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update ja phone_number_name_update. Näin hallintapaneeli pysyy hyödyllisenä, eikä keskustelujen sisältö koskaan päädy meille.
Mitkä tapahtumat menevät minne, kun ohitus on voimassa. Toiminnalliset tapahtumatToimitetaan meilleViestireittiToimitetaan sinullemessagesKaikki, mitä asiakas lähettääsmb_message_echoesMitä tiimi lähettää sovelluksestaPalvelimesiSuoraan, ei koskaan kauttammePidä yhteys hengissä ja selviä uudelleenyhdistämisestä
Meta katkaisee Coexistence-numeron yhteyden noin neljäntoista päivän jälkeen, jos ensisijaisella laitteella ei ole toimintaa. Yhteyden voi muodostaa uudelleen, ja kirjaamme sen omaksi tilakseen emmekä käsittele sitä lähtevänä asiakkaana.
Monet yllättää se, mitä yhteyden katkeaminen tekee reitille. Meta tallentaa kohteen ohituksena sovelluksemme tilaukseen tilille, joten PARTNER_REMOVED poistaa sovelluksen asennuksen ja ohitus katoaa sen mukana. Uudelleenyhdistäminen palauttaa lähetyksen ja valvonnan, mutta ei kohdettasi. Asetamme sen takaisin automaattisesti, koska ensimmäinen tähän sääntöön osunut numero yhdisti uudelleen ongelmitta ja lakkasi hiljaa toimittamasta viestejä asiakkaan palvelimelle.
Mitä uudelleenyhdistäminen palauttaa itsestään ja mitä on asetettava takaisin. Meta palauttaaAutomaattisestiLähetysCloud API toimii taasToiminnalliset tapahtumatValvonta jatkuuKatoaa sovelluksen mukanaOn asetettava uudelleenWebhook-ohituksesiPoistuu sovelluksen asennuksen mukanaViestien toimitus sinulleLoppuu hiljaaAsetamme sen uudelleenJokaisella uudelleenyhdistämisellä
Miksi tiimit käyttävät numeroa näin
- Pidä numero, joka on jo painettu pakettiautoihin, kuitteihin ja verkkosivuille, sekä sen ympärille rakentunut mobiilityötapa.
- Lisää API-lähetys, webhookien käsittely ja viestipohjat siirtämättä ketään uuteen työkaluun.
- Pidä viestiliikenne poissa palveluntarjoajan jaetusta saapuneiden kansiosta, jotta keskustelut eivät ole jonkun toisen alustalla.
- Anna toimistolle tapa pitää monen asiakkaan numerot yhdellä tilillä, kukin yhdistettynä asiakkaan omaan Business Portfolioon.
Kelpoisuus ja käytännön rajoitukset
- Numeron on oltava jo käytössä WhatsApp Business -sovelluksessa. Tavallisen WhatsApp-sovelluksen numero on siirrettävä sinne ensin.
- Olemassa olevan keskusteluhistorian jakaminen on kertaluonteinen valinta käyttöönoton aikana, eikä sitä voi muuttaa jälkikäteen.
- Ryhmäkeskustelut eivät ole API:n käytettävissä Coexistence-numeroilla, millään palveluntarjoajalla.
- Ensisijainen laite tarvitsee säännöllistä toimintaa. Meta katkaisee yhteyden noin neljäntoista päivän jälkeen ilman sitä.
- Metan vahvistus- ja merkkikäytännöt ovat erilaiset Coexistence-numeroille, ja alueellinen saatavuus muuttuu Metan käytäntöjen mukana.
Mitä ohjaamme sinulle ja mitä pidämme itse
Meta antaa sovelluksen ohittaa sen, minne WhatsApp Business Account -tili toimittaa webhookinsa. Asetamme ohituksen osoittamaan URL-osoitteeseesi, mikä jakaa tapahtumat kahtia.
messagesKaikki, mitä asiakas lähettää numeroonsmb_message_echoesMitä tiimisi lähettää WhatsApp Business -sovelluksesta
account_updateYhteyden tila: poistettu, irrotettu, yhdistetty uudelleen, rajoitettuphone_number_quality_updateLaatuluokituksen ja läpimenon muutoksetaccount_alertsMetan tilille antamat hälytyksetaccount_review_updateMetan tarkistuksen tuloksetbusiness_capability_updateViestirajan ja ominaisuuksien muutoksetphone_number_name_updateNäyttönimen hyväksynnät ja hylkäykset
Jos numerolle ei ole asetettu ohitusta, sen viestitapahtumat päätyvät oletusosoitteeseemme, jossa käsittelijä hylkää ne tallentamatta. Tämä on varmistettu koodissa eikä vain luvattu käytännöissä: keskustelujen sisällöllä ei ole reittiä tallennukseen.
Neljäntoista päivän sääntö ja se, minkä se rikkoo, vaikka kukaan ei mainitse sitä
Meta katkaisee Coexistence-yhteyden noin neljäntoista päivän jälkeen, jos ensisijaisella laitteella ei ole toimintaa. Yhteyden voi muodostaa uudelleen, joten tallennamme sen omana tilanaan emmekä laske sitä lähteneeksi asiakkaaksi.
Kallis seuraus tulee vasta myöhemmin. Viestiesi kohde ei ole numeron asetus, vaan ohitus sovelluksemme tilauksessa WhatsApp Business Account -tiliin. Yhteyden katkeaminen poistaa sovelluksen asennuksen, ja ohitus katoaa sen mukana. Yhdistät uudelleen, lähetys toimii, valvonta toimii, ja viestit lakkaavat saapumasta palvelimellesi ilman, että mikään ilmoittaa virheestä.
Asetamme ohituksen uudelleen jokaisen uudelleenyhdistämisen yhteydessä. Toiminto on olemassa, koska näin kävi: numero osui tähän sääntöön, yhdisti uudelleen ongelmitta ja lakkasi hiljaa toimittamasta viestejä.
Jos kättely epäonnistuu sillä hetkellä, koska palvelimesi oli alhaalla tai token vaihtui, se kirjataan yhteyden aikajanalle ja kohde säilytetään eikä sitä hylätä, joten sen tallentaminen uudelleen riittää korjaukseksi.
Mikä hajoaa hiljaa ja miten saamme sen selville
WhatsApp Business -sovellus toimii lähes jokaisen alla olevan vian aikana, ja siksi kukaan ei huomaa niitä. Nämä tarkistamme, ja näin.
Havaitaan Metan account_update-webhookista, tarkemmin PARTNER_REMOVED-tapahtumasta, eikä päätellä siitä, että jokin kenttä muuttuu falseksi. Emme tarkoituksella lue tähän is_on_biz_app-kenttää, koska se on aiheellisesti false numeroilla, jotka eivät ole Coexistence-numeroita, ja aiheutti vääriä katkoksia.
Metan sääntö ensisijaisen laitteen passiivisuudesta. Yhteyden voi muodostaa uudelleen, joten se kirjataan omaksi tilakseen eikä lähteneeksi asiakkaaksi, ja uudelleenyhdistäminen palauttaa lähetyksen ja valvonnan.
Kohde on tallennettu ohituksena sovelluksemme tilaukseen tilille, joten yhteyden katkeaminen poistaa sen. Lähetys palaa uudelleenyhdistämisen jälkeen, mutta toimitus palvelimellesi ei. Asetamme ohituksen uudelleen joka kerta, koska numero, jolle näin kävi, yhdisti uudelleen ongelmitta ja lakkasi hiljaa toimittamasta viestejä.
Säilytämme asiakkaan tokenin ja oman System User tokenimme samaa tiliä varten. Kun toinen hylätään, toinen lukee tilin ja selvittää, kumpi oikeasti hajosi, joten peruttu token ei enää näytä kadonneelta numerolta.
Haetaan Metalta aikataulun mukaan. RED-luokitus merkitsee yhteyden heikentyneeksi, ja laatu, viestitaso ja läpimenotaso tallennetaan jokaisella tarkistuksella, joten heikkeneminen näkyy ennen kuin se maksaa lähetyksen.
Numeron yhdistäminen ja numeron valvonta ovat eri tuotteita. Jälkimmäinen on syy tämän olemassaoloon.
Numeron yhdistämiseen kuluva tyypillinen aika, kun koodi skannataan WhatsApp Business -sovelluksesta.
Kuinka kauan asiakkaan vastaus pitää istunnon avoinna maksuttomia tekstiviestejä varten.
Coexistence-numeron lähetysnopeus, jonka Meta määrittää eikä sitä voi nostaa.
Kuinka paljon keskusteluhistoriaa Meta synkronoi API:in, kun numero yhdistetään ensimmäisen kerran.
Usein kysytyt kysymykset
Pitääkö tiimini lopettaa puhelimen käyttö?
Ei. Se on koko Coexistencen tarkoitus. WhatsApp Business -sovellus toimii samalla numerolla ja samoilla keskusteluilla, ja API toimii sen rinnalla.
Menetänkö nykyiset keskusteluni?
Et. Ne pysyvät sovelluksessa, ja Meta synkronoi noin kuuden kuukauden historian API:in numeron yhdistämisen yhteydessä. Ohjelmistolla on siis taustatiedot heti alusta lähtien.
Voinko perua sen?
Kyllä. Numeron voi irrottaa, ja sovellus jatkaa toimintaansa kuten ennenkin. Numeron yhdistäminen ei muuta itse numeroa pysyvästi.
Onko tämä sama asia kuin epäviralliset WhatsApp API:t?
Ei, ja ero ratkaisee, säilyykö numero. Coexistence on Metan virallinen ominaisuus Cloud API:ssa. Epäviralliset yhdyskäytävät käyttävät WhatsApp Webiä linkitettynä laitteena, mikä rikkoo ehtoja ja johtaa numeroiden estämiseen.
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeilu3 päivää ilmaiseksi. Mitään ei veloiteta ennen kuin kokeilu päättyy.