Yhdistä Botpress-botti WhatsAppiin Coexistencen avulla
Käytä Botpressin WhatsApp-integraatiota Manual Configuration -tilassa. Liitä yhdistetyn numeron access token ja phone number id, valitse verify token ja jätä App ID ja Client Secret tyhjiksi. Aseta sitten Botpressin webhook-URL ja tämä verify token numeron webhook-kohteeksi, niin Meta toimittaa jokaisen viestin botille.
Botpressin Client Secret -kenttä: jos se jätetään tyhjäksi, webhookin allekirjoituksen tarkistus ohitetaan.
Webhook-kentät, jotka Botpressin ohje tilaa, mukaan lukien viestit ja viestipohjien tilapäivitykset.
Asiakaspalveluikkuna, jonka asiakkaan viesti avaa ja jonka aikana voi lähettää mitä tahansa palveluviestiä.
Mikä Botpressin määritys toimii Coexistence-numeron kanssa?
Manual Configuration. Muut vaihtoehdot yhdistävät numeron Botpressin oman Meta-sovelluksen kautta, mikä on numeron erillinen käyttöönotto eikä tapa käyttää jo yhdistettyä numeroa.
Avaa WhatsApp-integraatiossa Configuration-valikko ja valitse Manual Configuration. Se pyytää kentät Verify Token, Access Token ja Default Bot Phone Number ID sekä valinnaisesti App ID, Client Secret ja WABA ID.
Access token, phone number id ja WABA id tulevat yhteydestä: hallintapaneeli näyttää ne, ja get_api_credentials palauttaa ne avustajalle. Verify token on mikä tahansa valitsemasi merkkijono. App ID ja Client Secret jäävät tyhjiksi. Botpressin ohje esittää secretin täytettävänä kenttänä, mutta integraation määrityksessä se on merkitty valinnaiseksi, ja ilman sitä allekirjoituksen tarkistus ohitetaan. Sillä on merkitystä, koska Meta allekirjoittaa jokaisen toimituksen Tech Providerin sovelluksen secretillä, jota millään asiakkaalla ei ole.
Miten Botpressin webhook saa Metan viestit?
Numeron webhook-kohteen kautta. Botpressin ohjeessa liität sen webhook-URL:n ja verify tokenin Meta-sovelluksen WhatsApp-asetuksiin. Tässä sinulla ei ole omaa Meta-sovellusta: Meta reitittää numeron tapahtumat sille kohteelle, jonka yhteys nimeää. Kopioi siis Botpressin integraatiolle näyttämä webhook-URL ja aseta se samalla verify tokenilla kohteeksi hallintapaneelissa tai set_webhook_destination-työkalulla.
Meta lähettää vahvistus-GET-pyynnön, Botpress vastaa siihen ja toimitus alkaa. Kun Botpress tallentaa manuaalisen määrityksen, se tarkistaa tokenin myös kysymällä Graphilta, mikä sovellus sen myönsi, joten virheellinen tai peruutettu token epäonnistuu tallennusvaiheessa eikä vasta ensimmäisellä viestillä.
Botpressin käsittelijä käsittelee myös smb_message_echoes-tapahtumaa, jonka Meta lähettää, kun joku vastaa WhatsApp Business -sovelluksesta. Puhelimesta lähetetty vastaus näkyy siis botille eikä jää sen ulottumattomiin.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
Mitä botin pitää tietää Coexistencesta?
Sen, että ihminen saattaa jo keskustella. WhatsApp Business -sovellus toimii numerolla edelleen, joten asiakas voi saada vastauksen sekä puhelimesta että botilta samalla minuutilla. Päätä kulussa, mitä tapahtuu, kun echo saapuu: useimmat tiimit pysäyttävät botin siltä yhteystiedolta hetkeksi, jotta väliin tullutta henkilöä ei keskeytetä.
Toinen asia on ajoitus. Saapuviin viesteihin vastaava botti toimii 24 tunnin asiakaspalveluikkunassa, jossa vapaa teksti on sallittu. Kulku, joka lähettää jotain vuorokautta myöhemmin, kuten seurannan tai muistutuksen, tarvitsee hyväksytyn viestipohjan, ja vapaa teksti palauttaa siinä virheen 131047. Botpressin ohje tilaa viestipohjan tilakentät juuri tällaisia ennakoivia viestejä varten.
Lisäksi läpimeno on Coexistence-numerolla kiinteästi 20 viestiä sekunnissa, mikä on selvästi enemmän kuin keskusteleva botti lähettää.
Yleiset virheet
- Client Secretin täyttäminen oman Meta-sovelluksesi secretillä. Allekirjoitus ei koskaan täsmää, ja Botpress vastaa jokaiseen toimitukseen 401:llä.
- OAuth- tai sandbox-vaihtoehdon valitseminen Manual Configurationin sijaan. Ne yhdistävät numeron Botpressin omalla sovelluksella, eivät jo yhdistetyllä.
- Echojen sivuuttaminen. Ilman sääntöä puhelimesta lähetetyille vastauksille botti vastaa sen henkilön päälle, joka on jo tullut väliin.
Yhdistä numero osoitteessa easycoexistence.com, liitä sen token ja phone number id Botpressin Manual Configuration -asetukseen ja aseta Botpressin webhook-URL kohteeksi. Hinta alkaen US$ 9 numeroa kohti kuukaudessa, laskien US$ 1:een numeroita lisättäessä, ja ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Onko allekirjoituksen tarkistuksen ohittaminen turvallista?
Suoja siirtyy URL-osoitteeseen. Botpress luo webhook-URL:n integraatiokohtaisesti, joten pidä se salassa. Media on silti haettava Metalta tokenilla, mitä väärennetty tapahtuma ei voi jäljitellä.
Voiko sama numero syöttää myös n8n:ää?
Numerolla on yksi webhook-kohde. Osoita se yhteen järjestelmään ja välitä tapahtumat sieltä eteenpäin, jos toinen tarvitsee niitä.
Onko WABA id pakollinen Botpressille?
Sen määrityksessä se on toistaiseksi valinnainen, ja sen mukaan siitä tulee pakollinen tulevassa pääversiossa, joten täytä se yhteydestä.
Kulkevatko viestit EasyCoexistencen kautta?
Eivät. Meta toimittaa ne suoraan Botpressin webhook-URL:ään, eikä sisältöä tallenneta meidän puolellamme.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu