Alla guider
Allt du kan göra på sidorna Samtal och Kundtjänst kan du också göra från dina egna system: en helpdesk, en webbplats, ett telefonsystem eller din egen programvara. Öppna API och integrationer i kontrollpanelen. Bara organisationens ägare och administratörer kan hantera detta. Allt som görs här debiteras organisationen på samma sätt som om det hade gjorts i kontrollpanelen.
Tekniska detaljer, exempel och hela API-referensen finns i utvecklardokumentationen. I den här artikeln förklarar vi vad de olika delarna används till.
Integreringar som stöds
Spiiksi fungerar med följande verktyg. Det finns stegvisa guider för vart och ett i utvecklardokumentationen.
| Integration | Vad den gör | Guide |
|---|---|---|
| Zendesk | En app i ärendets sidopanel: starta ett översatt samtal, översätt kundens kommentarer och dina svar | Zendesk |
| Freshdesk | Samma typ av app i sidopanelen för Freshdesk-ärenden | Freshdesk |
| Salesforce | En komponent på ärendesidor som startar ett översatt samtal med ärendets kontakt | Salesforce |
| Genesys Cloud | En dataåtgärd som startar ett översatt samtal från dina flöden och skript | Genesys Cloud |
| Microsoft Teams | Skriv ”call es” i en kanal för att starta ett samtal och publicera länkarna. ”translate de: …” översätter | Microsoft Teams |
| Telefonnummer (Twilio) | Den som ringer väljer språk i en röstmeny och ansluter till ett samtal. Du kan också ringa ut | Telefonlinjer |
| Telefonsystem (SIP / Asterisk) | En telefonväxel ansluts direkt och varje linje startar ett samtal | SIP |
| Din webbplats | En chattknapp som öppnar en konversation i kundtjänsten | Webbplatschatt |
| Dina egna sidor | Samtal och chattar i ett popupfönster eller inbäddade på sidan med JavaScript SDK | JavaScript SDK |
| Din egen programvara | Samtal, chattar och textöversättning via API:t | Kom igång, API-referens |
Alla finns listade under anslutningar. Samtal som startas via en integrering visas under Samtal, där agenter kan ansluta.
Ställa in telefonnummer och Teams
Twilio, SIP och Teams ställs in i kontrollpanelen, under Anslutningar på sidan API och integrationer:
- Twilio: fyll i dina Twilio-uppgifter, tryck på Anslut och klistra in URL för röst-webhook (klistra in i Twilio) i inställningarna för ditt nummer i Twilio.
- SIP: skapa ett post-id och kopiera uppringningsplanen till din telefonväxel.
- Teams: skapa en utgående webhook i teamet och klistra in dess säkerhetstoken.
Ställa in helpdesk-appar
Zendesk, Freshdesk, Salesforce och Genesys Cloud installeras i respektive verktyg. Skapa en API-nyckel för appen (se nedan), hämta appen via dess guide och följ stegen där.
API-nycklar
Dina egna system använder en API-nyckel för att kommunicera med Spiiksi. Läs om hur nycklar skickas med varje begäran i autentiseringsdokumentationen.
- Beskriv vad nyckeln ska användas till under API-nycklar, till exempel ”Zendesk”.
- Välj Läge: Skarpt läge för riktig användning eller Test för att prova dig fram (se nedan).
- Under Vad nyckeln får göra låter du allt vara aktiverat eller tillåter bara det systemet behöver, till exempel att bara översätta text eller bara visa samtal.
- Tryck på Skapa nyckel och kopiera nyckeln direkt. Den visas inte igen. Förvara den på din server, aldrig på en webbsida.
Återkalla inaktiverar en nyckel direkt, till exempel om den kan ha läckt ut. I listan ser du när varje nyckel användes senast.
Testläge
Med en Test-nyckel får text en tillfällig översättning, samtal kopplar igenom rösterna utan att översätta dem och ingenting debiteras. Nyckeln har bara åtkomst till det som skapats med testnycklar, aldrig dina riktiga samtal och konversationer. Använd den medan du bygger en integrering och byt sedan till en Skarpt läge-nyckel.
Webhooks
En webhook meddelar din server när något händer: ett samtal startar eller avslutas, eller en chatt startar, får ett meddelande eller stängs.
I utvecklardokumentationens avsnitt om webhooks kan du läsa vad varje avisering innehåller och hur du kontrollerar dess signatur.
- Ange din servers Webhook-adress under Webhooks, välj Evenemang (eller Alla evenemang) och tryck på Lägg till webhook.
- Kopiera signeringshemligheten. Den visas inte igen. Din server använder den för att kontrollera att varje leverans verkligen kommer från Spiiksi.
- Testa skickar en testleverans och visar vad din server svarade.
Om din server inte svarar försöker Spiiksi igen, med allt längre mellanrum, i ungefär ett och ett halvt dygn. Under Leveranser ser du varje leverans och om den kom fram. Skicka igen skickar en leverans på nytt. Om tio leveranser i rad misslyckas pausas webhooken. Aktivera reglaget Aktivt igen när servern fungerar.
OAuth-appar
En OAuth-app är till för programvara som flera organisationer ansluter, till exempel en app på en helpdesks marknadsplats. I stället för att lämna ut en API-nyckel godkänner varje organisations administratör appen i Spiiksi och kan koppla från den när som helst.
- Om du skapar en sådan app: läs om OAuth i utvecklardokumentationen och registrera appen under OAuth-appar med dess Appnamn och Omdirigerings-URI:er (https, åtskilda med blanksteg). Du får ett Klient-ID och en Klienthemlighet.
- Om du ansluter någon annans app: Spiiksi visar vad appen vill göra och för vilken organisation. Tryck på Tillåt. Anslutna appar visas under Appar anslutna till den här organisationen, där Koppla från omedelbart stoppar deras åtkomst.
Webbplatschatt och dina egna sidor
- En chattknapp på din webbplats öppnar konversationer i Kundtjänst. Läs mer i Kundtjänst.
- Samtal och chattar kan också öppnas på dina egna sidor, i ett popupfönster eller inbäddade på sidan, med JavaScript SDK (/docs/javascript-sdk).
Säkerhet
- Förvara API-nycklar och hemligheter på din server. Den som har en nyckel kan använda den, och kostnaden debiteras din organisation.
- Ge varje system en egen nyckel med bara den åtkomst det behöver. Då kan du återkalla en nyckel utan att stoppa de andra systemen.
- Spiiksi sparar bara ett fingeravtryck av varje API-nyckel och varje apps klienthemlighet, inte själva nyckeln. Därför kan den inte visas igen.
Var guiden till hjälp?
Frågor om detta?
Fråga assistenten. Den svarar utifrån den här guiden, på svenska.