API e integrazioni

Puoi fare tutto ciò che fai nelle pagine Chiamate e Assistenza clienti anche dai tuoi sistemi: un helpdesk, un sito web, un sistema telefonico o un tuo software. Nella dashboard, apri API e integrazioni. Solo i proprietari e gli amministratori dell'organizzazione possono gestire questa sezione; tutto ciò che viene fatto tramite queste integrazioni viene addebitato all'organizzazione, proprio come se fosse fatto dalla dashboard.

I dettagli tecnici, gli esempi e il riferimento completo delle API sono disponibili nella documentazione per sviluppatori. Questo articolo spiega a cosa serve ogni sezione.

Integrazioni supportateChiedi

Spiiksi funziona con questi strumenti. Per ognuno trovi una guida passo passo nella documentazione per sviluppatori.

Sono tutte elencate in connettori. Le chiamate avviate tramite un'integrazione compaiono in Chiamate, dove gli operatori possono unirsi.

Configurare i numeri di telefono e Teams

Twilio, SIP e Teams si configurano nella dashboard, in Connettori nella pagina API e integrazioni:

• Twilio: inserisci i tuoi dati Twilio, premi Connetti e incolla URL del webhook vocale (da incollare in Twilio) nelle impostazioni del tuo numero su Twilio.
• SIP: crea un ID voce e copia il dialplan nel tuo centralino.
• Teams: crea un webhook in uscita nel team e incolla il relativo token di sicurezza.

Configurare le app per helpdesk

Zendesk, Freshdesk, Salesforce e Genesys Cloud si installano direttamente nei rispettivi strumenti. Crea una chiave API per l'app (vedi sotto), scarica l'app dalla relativa guida e segui i passaggi indicati.

Chiavi APIChiedi

I tuoi sistemi usano una chiave API per comunicare con Spiiksi. Nella sezione autenticazione trovi le istruzioni su come inviare le chiavi con ogni richiesta.

1. In Chiavi API, descrivi a cosa serve la chiave, ad esempio “Zendesk”.
2. Scegli la Modalità: Produzione per l'uso reale o Test per fare delle prove (vedi sotto).
3. In Cosa può fare la chiave, lascia tutte le opzioni attive oppure consenti solo ciò che serve al sistema, ad esempio solo tradurre testi o solo visualizzare le chiamate.
4. Premi Crea chiave e copiala subito. Non verrà mostrata di nuovo: conservala sul tuo server, mai in una pagina web.

Revoca disattiva subito una chiave, ad esempio se temi che sia stata esposta. L'elenco mostra quando è stata usata ogni chiave l'ultima volta.

Modalità di testChiedi

Con una chiave Test, i testi ricevono una traduzione simulata, le chiamate trasmettono le voci senza tradurle e non viene addebitato nulla. La chiave dà accesso solo a ciò che è stato creato con chiavi di test, mai alle tue chiamate e conversazioni reali. Usala mentre sviluppi un'integrazione, poi passa a una chiave Produzione.

WebhookChiedi

Un webhook avvisa il tuo server quando succede qualcosa: una chiamata inizia o termina, una chat inizia, riceve un messaggio o viene chiusa.

Nella documentazione per sviluppatori trovi la sezione webhook, con i dettagli sui contenuti di ogni notifica e su come verificarne la firma.

1. In Webhook, inserisci l'Indirizzo webhook del tuo server, scegli gli Eventi (o Tutti gli eventi) e premi Aggiungi webhook.
2. Copia il segreto di firma. Non verrà mostrato di nuovo: il tuo server lo usa per verificare che ogni notifica provenga davvero da Spiiksi.
3. Test invia una notifica di prova e mostra la risposta del tuo server.

Se il tuo server non risponde, Spiiksi riprova a intervalli sempre più lunghi, per circa un giorno e mezzo. Consegne mostra ogni tentativo e il relativo esito; Invia di nuovo ne ripete uno. Se dieci tentativi consecutivi non vanno a buon fine, il webhook viene sospeso. Quando il tuo server funziona di nuovo, riattiva l'interruttore Attivo.

App OAuthChiedi

Un'app OAuth è pensata per i software a cui si collegano molte organizzazioni, ad esempio un'app nel marketplace di un helpdesk. Invece di fornire una chiave API, l'amministratore di ogni organizzazione autorizza l'app su Spiiksi e può scollegarla in qualsiasi momento.

• Se crei un'app di questo tipo: consulta la sezione OAuth nella documentazione per sviluppatori e registrala in App OAuth con il suo Nome app e gli URI di reindirizzamento (https, separati da spazi). Riceverai un ID client e un Segreto client.
• Se colleghi l'app di qualcun altro: Spiiksi mostra cosa vuole fare l'app e per quale organizzazione; premi Consenti. Le app collegate sono elencate in App collegate a questa organizzazione, dove Disconnetti ne revoca subito l'accesso.

Chat sul sito web e pagine personalizzateChiedi

• Un pulsante di chat sul tuo sito web apre le conversazioni di Assistenza clienti; consulta Assistenza clienti.
• Puoi anche aprire chiamate e chat direttamente nelle tue pagine, in una finestra pop-up o integrate nella pagina, con l'SDK JavaScript (/docs/javascript-sdk).

SicurezzaChiedi

• Conserva le chiavi API e i segreti sul tuo server. Chiunque abbia una chiave può usarla e gli addebiti saranno a carico della tua organizzazione.
• Assegna a ogni sistema una chiave distinta con solo le autorizzazioni necessarie, così puoi revocarne una senza interrompere le altre.
• Spiiksi conserva solo un'impronta digitale di ogni chiave API e del segreto client di ogni app, non la chiave o il segreto stessi. Per questo non possono essere mostrati di nuovo.