Panoramica

SIP Caller ti permette di definire API Key per integrarlo con sistemi esterni. Puoi definire tutte le API Key di cui hai bisogno, assegnando una scadenza e dei ruoli. Un sistema esterno può utilizzare la REST API fornita da SIP Caller, autenticandosi con il Token dell'API Key generato come descritto di seguito.

Ruoli richiesti

Per creare o modificare una API Key, l'utente necessita di uno dei seguenti ruoli:

• Amministratore

Per visualizzare una API Key, l'utente necessita di uno dei seguenti ruoli:

• Lettore Account

Crea una API Key

Per creare una API Key:

1. Vai su "Impostazioni" > "API Keys", e poi fai clic su "Crea".
   
2. Specifica un nome per la API Key.
3. Seleziona una scadenza. Nota che questa non può essere estesa una volta creata la API Key.
4. Abilita i ruoli che vuoi concedere alle applicazioni che utilizzeranno questa API Key. Nota che questi non possono essere modificati una volta creata la API Key. I ruoli disponibili sono i seguenti:
   • Phone System Queues Monitor: questo ruolo è richiesto per utilizzare il modulo SIP Caller Queues Monitor e monitorare il tuo sistema telefonico in tempo reale.
   • Campaign Reader: questo ruolo permette di leggere le campagne e i numeri delle campagne.
   • Campaign Admin: questo ruolo permette di duplicare le campagne, cambiare lo stato di una campagna, ed eliminare le campagne.
   • Campaign Number Admin: questo ruolo permette di aggiungere e rimuovere numeri da una campagna.
   • Campaign Number Provider: questo ruolo permette di aggiungere numeri a una campagna.
5. Fai clic su "Salva" per creare la API Key.
   
6. Verrà mostrata una finestra di dialogo, contenente il Token per la API Key appena creata. Copia il valore e salvalo in un posto sicuro. Questo token non verrà mostrato di nuovo, e non può essere recuperato, poiché SIP Caller non lo memorizzerà. Se lo perdi, dovrai creare un'altra API Key.

Modifica una API Key

Per modificare una API Key:

1. Vai su "Impostazioni" > "API Keys", e poi fai clic sulla API Key che vuoi modificare.
   
2. A questo punto, puoi modificare solo il nome, e visualizzare la data e l'ora di creazione e scadenza, e i ruoli assegnati alla API Key. Se hai bisogno di modificare altri valori, dovrai creare un'altra API Key.

Elimina una API Key

Quando hai bisogno di revocare l'accesso di un'applicazione a SIP Caller, dovrai eliminare la API Key. Per farlo:

1. Vai su "Impostazioni" > "API Keys", e poi seleziona la API Key che vuoi eliminare.
2. Fai clic sul pulsante Elimina e conferma l'operazione.