Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

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.

Aloita ilmainen kokeilu3 päivää ilmaiseksi. Mitään ei veloiteta ennen kuin kokeilu päättyy.
+1 415 555 0188
WhatsApp Business -sovellusTiimi vastaa puhelimella, kuten ennenkin
Cloud APIOmat järjestelmäsi tai tekoälyavustaja samalla linjalla
Molemmat näkevät saman keskustelun. API:n lähettämät viestit näkyvät sovelluksessa, ja se, mitä tiimi kirjoittaa sovelluksessa, saapuu smb_message_echoes-tapahtumana, joten ohjelmisto ei koskaan vastaa ihmisen päälle, joka on jo vastannut.
Emme tallenna viestejä oletuksenaBusiness-sovellus + Cloud APIMCP Claudelle ja ChatGPT:lleKäyttövalmis 2 minuutissa

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.

EnnenYksi numero, yksi valinta
Pidä sovellus

Tiimi vastaa puhelimella. Mitään ei voi automatisoida, kytkeä järjestelmiin eikä mitata.

Ei API:a
Siirry API:in

Ohjelmisto pääsee numeroon käsiksi. Business-sovellus lakkaa toimimasta numerolla ja tiimi vaihtaa työkaluja.

Ei sovellusta
NytYksi numero, molemmat
Yksi numero
WhatsApp Business -sovellusCloud API

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

Puhelin säilyyYritys, jolla on yksi numero

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 numeroa, yksi tiliToimisto, konsultti tai kehittäjä

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.

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

    Edellytys
    HTTPS-endpoint, joka palauttaa hub.challenge-arvon Metan GET-pyyntöön
    Aika
    Noin minuutti
    Saat
    Kohde, jonka Meta voi vahvistaa heti, kun numero yhdistetään
    Mitään ei ole vielä yhdistetty. Tämä ratkaisee, minne viestit päätyvät.
    Palveluntarjoaja välissäTallennetaan heidän palvelimilleen
    Meta
    Heidän alustansaVastaanottaa ja tallentaa viestit
    SinäKopio, heidän aikataulullaan
    EasyCoexistenceVain asetukset
    Meta
    EndpointisiEi vielä vahvistettu
    MeAsetamme reitin, emme ole sillä
  2. 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.

    Edellytys
    Pääsy Business Portfolioon ja puhelin, jossa numero on
    Aika
    Kahdesta kolmeen minuuttia
    Saat
    Cloud API liitettynä numeroon, jota sovellus käyttää edelleen
    Toinen kanava ilmestyy. Ensimmäistä ei poisteta.
    Siirron jälkeenYksi kanava
    Numero
    Vain Cloud APIBusiness-sovellus ei enää toimi tällä numerolla
    Coexistencen jälkeenKaksi kanavaa
    Numero
    WhatsApp Business -sovellusSamat keskustelut ja historia
    Cloud APISamalla linjalla
  3. Ohjaa 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.

    Edellytys
    Ensimmäisen vaiheen endpoint, jonka Meta on nyt vahvistanut
    Aika
    Voimassa heti, kun käyttöönotto on valmis
    Saat
    Viestit kulkevat Metalta sinulle, emmekä ole viestireitillä
    Mitkä tapahtumat menevät minne, kun ohitus on voimassa.
    Toiminnalliset tapahtumatToimitetaan meille
    account_updateYhteyden tilan muutokset
    phone_number_quality_updateLaatu ja läpimeno
    account_review_updateTarkistusten tulokset
    ViestireittiToimitetaan sinulle
    messagesKaikki, mitä asiakas lähettää
    smb_message_echoesMitä tiimi lähettää sovelluksesta
    PalvelimesiSuoraan, ei koskaan kauttamme
  4. Pidä 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.

    Edellytys
    Sovellus avataan ensisijaisella laitteella aina välillä
    Aika
    Jatkuvasti
    Saat
    Valvottu yhteys ja reitti, joka säilyy uudelleenyhdistämisen yli
    Mitä uudelleenyhdistäminen palauttaa itsestään ja mitä on asetettava takaisin.
    Meta palauttaaAutomaattisesti
    LähetysCloud API toimii taas
    Toiminnalliset tapahtumatValvonta jatkuu
    Katoaa sovelluksen mukanaOn asetettava uudelleen
    Webhook-ohituksesiPoistuu sovelluksen asennuksen mukana
    Viestien toimitus sinulleLoppuu hiljaa
    Asetamme 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.
Vapaa teksti0–24 tuntia asiakkaan viimeisestä viestistäVain viestipohjasen jälkeen, kunnes asiakas kirjoittaa uudelleen
Kello käynnistyy alusta aina, kun asiakas lähettää jotain. Tämä sääntö rikkoo integraatioita tuotannossa, koska testaus tapahtuu aina sekunteja viestin jälkeen, kun vapaa teksti vielä toimii.

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.

Toimitetaan suoraan endpointiisiViestien reitti. Oletuksena se ei koskaan kulje kauttamme.
  • messagesKaikki, mitä asiakas lähettää numeroon
  • smb_message_echoesMitä tiimisi lähettää WhatsApp Business -sovelluksesta
Toimitetaan meilleToiminnallinen reitti. Tästä valvonta koostuu.
  • account_updateYhteyden tila: poistettu, irrotettu, yhdistetty uudelleen, rajoitettu
  • phone_number_quality_updateLaatuluokituksen ja läpimenon muutokset
  • account_alertsMetan tilille antamat hälytykset
  • account_review_updateMetan tarkistuksen tulokset
  • business_capability_updateViestirajan ja ominaisuuksien muutokset
  • phone_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.

Numeron yhteys katkaistiinWebhook, luotettava lähde

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.

Yhteys oli hiljaa neljätoista päivääOma tila

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.

Webhook-reittisi katosi uudelleenyhdistämisessäPalautetaan automaattisesti

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

Käyttötunnus lakkasi toimimastaKaksi tokenia, yksi vastaus

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.

Laatu heikkeniKysellään

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.

2 minutes

Numeron yhdistämiseen kuluva tyypillinen aika, kun koodi skannataan WhatsApp Business -sovelluksesta.

24 hours

Kuinka kauan asiakkaan vastaus pitää istunnon avoinna maksuttomia tekstiviestejä varten.

20 msg/s

Coexistence-numeron lähetysnopeus, jonka Meta määrittää eikä sitä voi nostaa.

6 months

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.

Lue lisää