history-webhook
history sisältää Coexistence-numeron olemassa olevien keskustelujen kertasiirron API:in. Se saapuu käyttöönoton jälkeen, kun historian jakaminen on hyväksytty, ja se on ainoa signaali, jonka integraatio saa siitä, että siirto tapahtui.
Käyttöönoton jälkeinen aikaikkuna, jonka kuluessa synkronointi on aloitettava.
Virhe, joka palautetaan, kun synkronointi on jo käytetty.
Virhe, joka palautetaan, kun yritys tehdään tämän aikaikkunan ulkopuolella.
Mitä se toimittaa
Numerolla jo olleen kahdenkeskisten viestien historian WhatsApp Business -sovelluksessa. Historia siirretään, jotta ohjelmisto ei aloita tyhjän päältä linjalla, jota yritys on käyttänyt vuosia.
Ryhmäkeskustelut eivät kuulu siirtoon. Ne on rajattu kokonaan API:n ulkopuolelle Coexistence-numerolla. Myöskään sovelluksen omille toiminnoille, kuten tunnisteille, pikavastauksille sekä tervehdyksille ja poissaoloviesteille, ei ole API-vastinetta, joten ne jäävät laitteeseen.
Tämä kenttä on olemassa vain Coexistence-numeroilla. Tavalliseen tapaan käyttöönotetulla numerolla ei ole aiempaa sovellushistoriaa siirrettäväksi, joten toimitettavaa ei ole.
Miksi se käynnistyy kerran
Koska siirto kuuluu käyttöönottoon eikä ole jatkuva toiminto.
Yrityksen omistajalta kysytään Embedded Signup -prosessin aikana, halutaanko olemassa olevat keskustelut jakaa. Kyllä-vastaus sallii synkronoinnin suorittamisen. Sen jälkeen ei ole asetusta, jolla toiminnon voisi ottaa uudelleen käyttöön, eikä endpointia, joka toistaisi sen. Toinen yritys palauttaa virhekoodin 2593107, ei myöhemmin poistuvaa nopeusrajoitusta.
Myös määräaika on olemassa. Synkronointi on aloitettava 24 tunnin kuluessa käyttöönotosta, ja myöhempi yritys palauttaa virhekoodin 2593108. Kumman tahansa ehdon laiminlyönti tarkoittaa numeron irrottamista ja koko prosessin suorittamista uudelleen.
Mitä käsittelijän tulee tehdä sille
Käsittele sitä kerran saapuvana, mahdollisesti suurena eränä, ei viestipolun lisäliikenteenä.
- Kuittaa nopeasti ja käsittele asynkronisesti kuten mikä tahansa muu toimitus.
- Poista kaksoiskappaleet viestin tunnisteen perusteella: historia ja reaaliaikaiset viestit voivat mennä päällekkäin käyttöönoton aikana.
- Varaudu siihen, ettei sitä saavu. Omistaja voi kieltäytyä historiasta, jolloin numero ei lähetä tähän kenttään mitään ja integraation on toimittava kummassakin tapauksessa.
- Älä estä käyttöönottoa sen takia. Yhteyttä voi käyttää jo ennen siirron valmistumista.
Yleiset virheet
- Integraation rakentaminen niin, että historia on pakollinen. Monet numerot yhdistetään ilman sitä.
- Synkronoinnin yrittäminen uudelleen virhekoodin 2593107 jälkeen. Kyseessä on kertaluonteinen tapahtuma, joten yritys palauttaa saman virheen.
- Historiaa koskevan päätöksen jättäminen integraatiotyön alkuun, jolloin 24 tunnin aikaikkuna on yleensä jo sulkeutunut.
EasyCoexistence tallentaa käyttöönoton ja historiaa koskevan valinnan yhteyden aikajanalle. Näin tieto numeron synkronoinnista ja sen päivämäärästä on varma fakta, jota ei tarvitse selvittää jälkikäteen.
Usein kysytyt kysymykset
Kuinka paljon historiaa saapuu?
Meta määrittää viimeaikaisten kahdenkeskisten keskustelujen aikaikkunan, ei palveluntarjoaja.
Siirtyvätkö ryhmäkeskustelut?
Eivät. Ryhmät on rajattu kokonaan API:n ulkopuolelle Coexistence-numerolla.
Voinko pyytää siirtoa myöhemmin uudelleen?
Et. Se suoritetaan kerran käyttöönottoa kohden. Uusi yritys edellyttää numeron irrottamista ja yhdistämistä uudelleen.
Mitä tapahtuu, jos omistaja kieltäytyi historiasta?
Tähän kenttään ei saavu mitään, ja API näkee vain numeron yhdistämisen jälkeen saapuvat viestit.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu