Alle vejledninger
Alt det, du kan gøre på siderne Opkald og Kundeservice, kan også gøres fra dine egne systemer: et helpdesk-system, et website, et telefonsystem eller din egen software. Åbn API og integrationer i kontrolpanelet. Kun organisationens ejere og administratorer kan administrere det. Alt, der gøres via integrationerne, faktureres til organisationen på samme måde som det tilsvarende i kontrolpanelet.
De tekniske detaljer, eksempler og den fulde API-reference finder du i dokumentationen for udviklere. Denne artikel forklarer, hvad de enkelte dele bruges til.
Understøttede integrationer
Spiiksi fungerer sammen med disse værktøjer. Der findes en trinvis vejledning til hver integration i dokumentationen for udviklere.
| Integration | Hvad den gør | Vejledning |
|---|---|---|
| Zendesk | En app i ticket-panelet: start et tolket opkald, oversæt kundens kommentarer og dine svar | Zendesk |
| Freshdesk | Den samme app i ticket-panelet i Freshdesk | Freshdesk |
| Salesforce | En komponent på Case-sider, der starter et tolket opkald med kontaktpersonen på sagen | Salesforce |
| Genesys Cloud | En datahandling, der starter et tolket opkald fra dine flows og scripts | Genesys Cloud |
| Microsoft Teams | "call es" i en kanal starter et opkald og lægger links op; "translate de: …" oversætter | Microsoft Teams |
| Telefonnummer (Twilio) | Den, der ringer op, vælger sprog i en stemmemenu og deltager i et opkald; du kan også ringe ud | Telefonlinjer |
| Telefonsystemer (SIP / Asterisk) | Et PBX-system opretter direkte forbindelse, og hver linje starter et opkald | SIP |
| Dit website | En chatknap, der åbner en samtale i Kundeservice | Website-chat |
| Dine egne sider | Opkald og chats i et pop op-vindue eller som en del af siden via JavaScript SDK'et | JavaScript SDK |
| Din egen software | Opkald, chats og tekstoversættelse via API'et | Hurtig start, API-reference |
Du finder dem alle under connectors. Opkald, der startes via en integration, vises under Opkald, hvor medarbejdere kan deltage.
Konfiguration af telefonnumre og Teams
Twilio, SIP og Teams konfigureres i kontrolpanelet under Connectors på siden API og integrationer:
- Twilio: Indtast dine Twilio-oplysninger, tryk på Tilslut, og indsæt Voice-webhook-URL (indsæt i Twilio) i indstillingerne for dit nummer hos Twilio.
- SIP: Opret et entry-id, og kopiér dialplanen til dit PBX-system.
- Teams: Opret en udgående webhook i teamet, og indsæt dens sikkerhedstoken.
Konfiguration af helpdesk-apps
Zendesk, Freshdesk, Salesforce og Genesys Cloud installeres i de pågældende værktøjer. Opret en API-nøgle til appen (se nedenfor), download appen via dens vejledning, og følg trinnene dér.
API-nøgler
Dine egne systemer bruger en API-nøgle til at kommunikere med Spiiksi. Se godkendelse for at få mere at vide om, hvordan nøgler sendes med hver forespørgsel.
- Under API-nøgler skal du beskrive, hvad nøglen skal bruges til, f.eks. “Zendesk”.
- Vælg Tilstand: Live til brug i praksis eller Test til at afprøve ting (se nedenfor).
- Under Hvad nøglen må gøre kan du lade alt være slået til eller kun give adgang til det, systemet har brug for, f.eks. kun at oversætte tekst eller kun at se opkald.
- Tryk på Opret nøgle, og kopiér nøglen med det samme. Den vises ikke igen. Opbevar den på din server, aldrig på en webside.
Tilbagekald deaktiverer straks en nøgle, f.eks. hvis den kan være blevet lækket. Listen viser, hvornår hver nøgle sidst blev brugt.
Testtilstand
Med en Test-nøgle får du en eksempeloversættelse af tekst, og opkaldene går igennem uden tolkning. Der opkræves ikke betaling. Nøglen har kun adgang til det, der er oprettet med testnøgler, aldrig dine rigtige opkald og samtaler. Brug den, mens du bygger en integration, og skift derefter til en Live-nøgle.
Webhooks
En webhook giver din server besked, når noget sker: et opkald starter eller slutter, en chat starter, får en besked eller lukkes.
Se webhooks i dokumentationen for udviklere for at få mere at vide om indholdet af hver besked, og hvordan du kontrollerer dens signatur.
- Under Webhooks skal du indtaste din servers Webhook-adresse, vælge Arrangementer (eller Alle arrangementer) og trykke på Tilføj webhook.
- Kopiér signeringshemmeligheden. Den vises ikke igen. Din server bruger den til at kontrollere, at hver levering faktisk kommer fra Spiiksi.
- Test sender en testlevering og viser, hvad din server svarede.
Hvis din server ikke svarer, prøver Spiiksi igen med stadigt længere mellemrum i cirka halvandet døgn. Leveringer viser hver levering, og om den nåede frem. Send igen sender en levering på ny. Hvis ti leveringer i træk mislykkes, sættes webhooken på pause. Slå kontakten Aktivt til igen, når din server fungerer.
OAuth-apps
En OAuth-app er til software, som mange organisationer forbinder, f.eks. en app i en helpdesk-markedsplads. I stedet for at udlevere en API-nøgle godkender administratoren for hver organisation appen hos Spiiksi og kan afbryde forbindelsen når som helst.
- Hvis du udvikler sådan en app: Se OAuth i dokumentationen for udviklere, og registrér appen under OAuth-apps med dens Appnavn og Omdirigerings-URI'er (https, adskilt af mellemrum). Du får et Client-ID og en Client-hemmelighed.
- Hvis du forbinder en andens app: Spiiksi viser, hvad appen vil gøre, og for hvilken organisation. Tryk på Tillad. Forbundne apps vises under Apps forbundet med denne organisation, hvor Afbryd straks stopper deres adgang.
Website-chat og dine egne sider
- En chatknap på dit website åbner samtaler i Kundeservice. Se Kundeservice.
- Opkald og chats kan også åbnes på dine egne sider, i et pop op-vindue eller som en del af siden, med JavaScript SDK'et (/docs/javascript-sdk).
Sikkerhed
- Opbevar API-nøgler og hemmeligheder på din server. Alle, der har en nøgle, kan bruge den, og brugen faktureres til din organisation.
- Giv hvert system sin egen nøgle med adgang til det, systemet har brug for. Så kan du tilbagekalde én nøgle uden at stoppe de andre systemer.
- Spiiksi gemmer kun et fingeraftryk af hver API-nøgle og hver apps client-hemmelighed, ikke selve nøglen. Derfor kan den ikke vises igen.
Var vejledningen nyttig?
Spørgsmål til dette?
Spørg assistenten. Den svarer ud fra denne vejledning, på dansk.