Alle veiledninger
Alt du kan gjøre på sidene Samtaler og Kundestøtte, kan også gjøres fra dine egne systemer: en kundestøtteløsning, et nettsted, et telefonsystem eller din egen programvare. Åpne API og integrasjoner i kontrollpanelet. Bare organisasjonens eiere og administratorer kan administrere dette. Alt som gjøres her, belastes organisasjonen på samme måte som tilsvarende handlinger i kontrollpanelet.
Du finner tekniske detaljer, eksempler og hele API-referansen i utviklerdokumentasjonen. Denne artikkelen forklarer hva de ulike delene brukes til.
Støttede integrasjoner
Spiiksi fungerer med disse verktøyene. Du finner en trinnvis veiledning for hver av dem i utviklerdokumentasjonen.
| Integrasjon | Hva den gjør | Veiledning |
|---|---|---|
| Zendesk | En app i sidepanelet for saker: start en oversatt samtale, oversett kundens kommentarer og svarene dine | Zendesk |
| Freshdesk | Den samme sidepanelappen for Freshdesk-saker | Freshdesk |
| Salesforce | En komponent på saksidene som starter en oversatt samtale med kontakten knyttet til saken | Salesforce |
| Genesys Cloud | En datahandling som starter en oversatt samtale fra flytene og skriptene dine | Genesys Cloud |
| Microsoft Teams | «call es» i en kanal starter en samtale og legger ut lenkene; «translate de: …» oversetter | Microsoft Teams |
| Telefonnummer (Twilio) | Innringere velger språk fra en talemelding og blir med i en samtale. Du kan også ringe ut | Telefonlinjer |
| Telefonsystemer (SIP / Asterisk) | En telefonsentral kobles til direkte, og hver linje starter en samtale | SIP |
| Nettstedet ditt | En chatteknapp som åpner en samtale i kundestøtten | Nettstedchat |
| Egne sider | Samtaler og chatter i et sprettoppvindu eller som en del av siden, med JavaScript SDK | JavaScript SDK |
| Egen programvare | Samtaler, chatter og tekstoversettelse via API-et | Hurtigstart, API-referanse |
Alle integrasjonene er oppført under koblinger. Samtaler som startes via en integrasjon, vises under Samtaler, der agenter kan bli med.
Konfigurere telefonnumre og Teams
Twilio, SIP og Teams konfigureres i kontrollpanelet, under Tilkoblinger på siden API og integrasjoner:
- Twilio: Fyll inn Twilio-opplysningene dine, trykk på Koble til, og lim inn Voice webhook-URL (lim inn i Twilio) i innstillingene for nummeret ditt i Twilio.
- SIP: Opprett en oppførings-ID og kopier oppringingsplanen til telefonsentralen.
- Teams: Opprett en utgående webhook i teamet, og lim inn sikkerhetstokenet.
Konfigurere apper for kundestøtte
Zendesk, Freshdesk, Salesforce og Genesys Cloud installeres i de respektive verktøyene. Opprett en API-nøkkel for appen (se nedenfor), last ned appen fra veiledningen for den, og følg trinnene der.
API-nøkler
Dine egne systemer bruker en API-nøkkel til å kommunisere med Spiiksi. Se autentisering for informasjon om hvordan nøklene sendes med hver forespørsel.
- Under API-nøkler beskriver du hva nøkkelen skal brukes til, for eksempel «Zendesk».
- Velg Modus: Direkte for faktisk bruk eller Test for å prøve ut ting (se nedenfor).
- Under Hva nøkkelen kan gjøre lar du alt være slått på, eller begrenser tilgangen til det systemet trenger, for eksempel bare å oversette tekst eller bare å se samtaler.
- Trykk på Opprett nøkkel, og kopier nøkkelen med en gang. Den vises ikke igjen. Oppbevar den på serveren din, aldri på en nettside.
Tilbakekall deaktiverer en nøkkel med en gang, for eksempel hvis den kan ha kommet på avveie. Listen viser når hver nøkkel sist ble brukt.
Testmodus
Med en Test-nøkkel får tekst en eksempeloversettelse, samtaler videresendes uten oversettelse, og ingenting belastes. Testnøkkelen har bare tilgang til det andre testnøkler har opprettet, aldri til ekte samtaler og samtaletråder. Bruk den mens du utvikler en integrasjon, og bytt deretter til en Direkte-nøkkel.
Webhooks
En webhook gir serveren din beskjed når noe skjer: en samtale starter eller avsluttes, eller en chat starter, får en melding eller lukkes.
Se webhooks i utviklerdokumentasjonen for å finne ut hva hver varsling inneholder, og hvordan du kontrollerer signaturen.
- Under Webhooks skriver du inn Webhook-adressen til serveren din, velger Arrangementer (eller Alle arrangementer) og trykker på Legg til webhook.
- Kopier signeringshemmeligheten. Den vises ikke igjen. Serveren din bruker den til å kontrollere at hver levering faktisk kommer fra Spiiksi.
- Test sender en testlevering og viser svaret fra serveren din.
Hvis serveren din ikke svarer, prøver Spiiksi på nytt med stadig lengre mellomrom, i omtrent halvannet døgn. Leveringer viser hver levering og om den kom fram. Send på nytt sender en levering på nytt. Hvis ti leveringer på rad mislykkes, settes webhooken på pause. Slå Aktivt på igjen når serveren fungerer.
OAuth-apper
En OAuth-app er beregnet på programvare som kobles til av mange organisasjoner, for eksempel en app i en markedsplass for kundestøtteverktøy. I stedet for å gi fra seg en API-nøkkel godkjenner administratoren for hver organisasjon appen i Spiiksi, og kan når som helst koble den fra.
- Hvis du lager en slik app: Se OAuth i utviklerdokumentasjonen, og registrer appen under OAuth-apper med Appnavn og Omdirigerings-URI-er (https, atskilt med mellomrom). Du får en Klient-ID og en Klienthemmelighet.
- Hvis du kobler til en app fra noen andre: Spiiksi viser hva appen vil gjøre, og for hvilken organisasjon. Trykk på Tillat. Tilkoblede apper er oppført under Apper koblet til denne organisasjonen, der Koble fra stanser tilgangen deres med en gang.
Nettstedchat og egne sider
- En chatteknapp på nettstedet ditt åpner samtaler i Kundestøtte. Se Kundestøtte.
- Du kan også åpne samtaler og chatter på dine egne sider, i et sprettoppvindu eller som en del av siden, med JavaScript SDK (/docs/javascript-sdk).
Sikkerhet
- Oppbevar API-nøkler og hemmeligheter på serveren din. Alle som har en nøkkel, kan bruke den, og bruken belastes organisasjonen din.
- Gi hvert system sin egen nøkkel med bare tilgangene det trenger. Da kan du tilbakekalle én nøkkel uten å stanse de andre.
- Spiiksi lagrer bare et fingeravtrykk av hver API-nøkkel og hver apphemmelighet, ikke selve nøkkelen. Derfor kan den ikke vises igjen.
Var veiledningen nyttig?
Spørsmål om dette?
Spør assistenten. Den svarer ut fra denne veiledningen, på norsk.