API ja integraatiot

Kaikki, mitä Puhelut- ja Asiakastuki-sivuilla voi tehdä, onnistuu myös omissa järjestelmissäsi: helpdeskissä, verkkosivustolla, puhelinjärjestelmässä tai omassa ohjelmistossasi. Avaa hallintapaneelissa API ja integraatiot. Vain organisaation omistajat ja ylläpitäjät voivat hallita näitä toimintoja. Niiden käyttö laskutetaan organisaatiolta samalla tavalla kuin vastaavien toimintojen käyttö hallintapaneelissa.

Tekniset tiedot, esimerkit ja koko API-viite löytyvät kehittäjädokumentaatiosta. Tässä artikkelissa kerrotaan, mihin kukin osa on tarkoitettu.

Tuetut integraatiotKysy

Spiiksi toimii seuraavien työkalujen kanssa. Kehittäjädokumentaatiosta löydät jokaiselle vaiheittaisen ohjeen.

Kaikki integraatiot on lueteltu liittimissä. Integraation kautta aloitetut puhelut näkyvät kohdassa Puhelut, josta asiakaspalvelijat voivat liittyä niihin.

Puhelinnumeroiden ja Teamsin käyttöönotto

Twilio, SIP ja Teams määritetään hallintapaneelissa Liittimet-kohdassa API ja integraatiot -sivulla:

• Twilio: täytä Twilio-tietosi, valitse Yhdistä ja liitä Voice webhook -osoite (liitä Twilioon) numerosi asetuksiin Twiliossa.
• SIP: luo merkinnälle tunniste ja kopioi dialplan puhelinvaihteeseesi.
• Teams: luo tiimiin lähtevä webhook ja liitä sen suojaustunnus.

Helpdesk-sovellusten käyttöönotto

Zendesk, Freshdesk, Salesforce ja Genesys Cloud asennetaan kyseisissä palveluissa. Luo sovellukselle API-avain (katso alta), lataa sovellus sen ohjeesta ja noudata ohjeen vaiheita.

API-avaimetKysy

Omat järjestelmäsi käyttävät API-avainta Spiiksin kanssa viestimiseen. Ohjeet avaimen lähettämiseen kunkin pyynnön yhteydessä löydät todennusohjeesta.

1. Lisää kohdassa API-avaimet avaimelle kuvaus, esimerkiksi ”Zendesk”.
2. Valitse Tila: Tulkkausesimerkki oikeaan käyttöön tai Testaa kokeilua varten (katso alta).
3. Jätä kohdassa Mitä avaimella saa tehdä kaikki vaihtoehdot käyttöön tai salli vain järjestelmän tarvitsemat toiminnot, esimerkiksi vain tekstin kääntäminen tai vain puheluiden tarkastelu.
4. Valitse Luo avain ja kopioi avain heti. Sitä ei näytetä uudelleen. Säilytä se palvelimellasi, älä koskaan verkkosivulla.

Peru-toiminto poistaa avaimen käytöstä heti, esimerkiksi jos epäilet sen joutuneen vääriin käsiin. Luettelossa näkyy, milloin kutakin avainta on käytetty viimeksi.

TestitilaKysy

Testaa-avaimella teksti käännetään testikäännöksellä, puheluissa äänet välitetään kääntämättä eikä käytöstä laskuteta. Avaimella näkee vain testiavaimilla luodut tiedot, ei koskaan oikeita puheluitasi tai keskustelujasi. Käytä tätä integraation rakentamiseen ja siirry sen jälkeen Tulkkausesimerkki-avaimeen.

WebhookitKysy

Webhook ilmoittaa palvelimellesi tapahtumista: puhelu alkaa tai päättyy, chat alkaa, saa viestin tai sulkeutuu.

Kehittäjädokumentaation webhookit-sivulta näet, mitä kukin ilmoitus sisältää ja miten sen allekirjoitus tarkistetaan.

1. Lisää kohdassa Webhookit palvelimesi Webhookin osoite, valitse Tapahtumat (tai Kaikki tapahtumat) ja valitse Lisää webhook.
2. Kopioi allekirjoitussalaisuus. Sitä ei näytetä uudelleen; palvelimesi käyttää sitä tarkistaakseen, että jokainen lähetys on todella peräisin Spiiksiltä.
3. Testaa lähettää testilähetyksen ja näyttää, mitä palvelimesi vastasi.

Jos palvelimesi ei vastaa, Spiiksi yrittää uudelleen yhä pidemmin väliajoin noin puolentoista vuorokauden ajan. Lähetykset näyttää jokaisen lähetyksen ja sen, saapuiko se perille. Lähetä uudelleen lähettää yhden lähetyksen uudelleen. Jos kymmenen peräkkäistä lähetystä epäonnistuu, webhook keskeytetään. Ota sen Aktiivinen-kytkin uudelleen käyttöön, kun palvelimesi toimii taas.

OAuth-sovelluksetKysy

OAuth-sovellus on tarkoitettu ohjelmistoille, jotka yhdistetään useisiin organisaatioihin, kuten helpdesk-palvelun sovelluskaupan sovelluksille. API-avaimen luovuttamisen sijaan kunkin organisaation ylläpitäjä hyväksyy sovelluksen Spiiksissä ja voi katkaista sen yhteyden milloin tahansa.

• Jos kehität tällaisen sovelluksen: katso kehittäjädokumentaation OAuth-ohje ja rekisteröi sovellus kohdassa OAuth-sovellukset lisäämällä sen Sovelluksen nimi ja Paluuosoitteet (https, välilyönnein erotettuina). Saat Asiakastunnuksen ja Asiakassalaisuuden.
• Jos yhdistät jonkun toisen sovelluksen: Spiiksi näyttää, mitä sovellus haluaa tehdä ja minkä organisaation puolesta. Valitse Salli. Yhdistetyt sovellukset näkyvät kohdassa Tähän organisaatioon yhdistetyt sovellukset, jossa voit katkaista niiden yhteyden heti valitsemalla Katkaise yhteys.

Verkkosivuston chat ja omat sivusiKysy

• Verkkosivustosi chat-painike avaa Asiakastuki-keskusteluja. Katso Asiakastuki.
• Puhelut ja chatit voi avata myös omilla sivuillasi ponnahdusikkunassa tai osana sivua JavaScript SDK:n avulla (/docs/javascript-sdk).

TietoturvaKysy

• Säilytä API-avaimet ja salaisuudet palvelimellasi. Kuka tahansa avaimen haltija voi käyttää sitä, ja käytöstä laskutetaan organisaatiotasi.
• Anna jokaiselle järjestelmälle oma avain ja vain sen tarvitsemat oikeudet. Näin voit poistaa yhden avaimen käytöstä pysäyttämättä muita järjestelmiä.
• Spiiksi tallentaa jokaisesta API-avaimesta ja sovelluksen asiakassalaisuudesta vain sormenjäljen, ei itse avainta tai salaisuutta. Siksi niitä ei voi näyttää uudelleen.