Cosa sono le API Key di AI4CALL?
Le API Key di AI4CALL sono le credenziali con cui i tuoi applicativi accedono alle API di AI4CALL. Si creano dal portale con il pulsante Nuova API Key, vengono mostrate in chiaro una sola volta e vanno inserite nell'header delle richieste. Puoi eliminare ogni chiave singolarmente, ma attenzione: l'eliminazione è immediata e definitiva.
AI4CALL offre assistenti vocali che rispondono al telefono, capiscono e agiscono. Le aziende li usano senza scrivere codice; sviluppatori e system integrator possono collegarli ai propri software tramite API complete. Le API Key sono la porta d'accesso a queste integrazioni: in questo videotutorial vediamo come generarle, conservarle ed eliminarle in sicurezza.
Come si usano le API Key: header e documentazione degli endpoint
Una API Key è una chiave univoca che il tuo applicativo presenta nell'header di ogni richiesta verso le API di AI4CALL. Su swagger.ai4call.com trovi la documentazione completa degli endpoint, con parametri e formati di ogni chiamata.
Due endpoint per le chiamate in uscita
Tra gli endpoint disponibili, due vanno conosciuti fin da subito: permettono di avviare chiamate in uscita con gli assistenti AI4CALL.
- Webhook outbound call PBX: avvia chiamate in uscita dal tuo centralino. Il parametro IP PBX deve corrispondere a un indirizzo abilitato in Gestione › Abilita IP.
- Webhook outbound call: la chiamata parte dai trunk VoIP di AI4CALL, senza alcuna configurazione sul tuo centralino. Il caller ID deve essere un numero demo o acquistato presente nel tuo account.
In sintesi, cambia il punto da cui parte la chiamata: dal tuo centralino, con un indirizzo IP abilitato, oppure dai trunk VoIP di AI4CALL, lasciando intatta la configurazione del centralino.
Come generare una nuova API Key
Dal portale AI4CALL bastano quattro passaggi:
- Fai clic su Nuova API Key.
- Si apre la finestra Crea nuova API Key, che avvisa che verrà generata una nuova chiave univoca.
- Premi Genera API Key.
- Copia subito la chiave mostrata a schermo e conservala in un luogo sicuro.
Conservare l'API Key: viene mostrata una sola volta
È il passaggio più importante: la chiave viene mostrata in chiaro una sola volta. Copiala e mettila al sicuro prima di chiudere la finestra. Da quel momento compare in tabella mascherata, insieme alla data di creazione, e non è più recuperabile per intero.
Più API Key per applicativi e ambienti diversi
Puoi generare più chiavi e assegnarne una a ciascun applicativo o ambiente. Il vantaggio è concreto: se una chiave viene compromessa, o se dismetti un'integrazione, elimini solo quella. Tutte le integrazioni che usano altre chiavi continuano a funzionare senza interruzioni.
Come eliminare un'API Key in sicurezza
Per eliminare una chiave usa l'icona rossa sulla sua riga e conferma l'operazione. Attenzione: l'eliminazione è immediata e definitiva. Ogni applicativo che usava quella chiave smette subito di funzionare. Per questo tieni sempre traccia di quale chiave è assegnata a ogni integrazione.
Sicurezza delle API Key: trattale come password
L'ultima raccomandazione del videotutorial è semplice: tratta le API Key come password. Quindi non inserire mai una chiave:
- nel codice sorgente condiviso;
- in email o messaggi di chat;
- in applicazioni lato browser, dove chiunque potrebbe vederla.
API Key AI4CALL in sintesi
Crea la chiave con Nuova API Key › Genera API Key e copiala subito: è visibile in chiaro una sola volta. Inseriscila nell'header delle richieste e consulta gli endpoint su swagger.ai4call.com. Usa una chiave per ogni applicativo o ambiente. Eliminala con l'icona rossa: l'effetto è immediato e definitivo. E trattala sempre come una password.
Domande frequenti sulle API Key di AI4CALL
Posso recuperare un'API Key dopo averla generata?
No. La chiave viene mostrata in chiaro una sola volta, al momento della generazione. Dopo compare in elenco mascherata e non è più recuperabile per intero. Se l'hai persa, genera una nuova chiave ed elimina quella vecchia.
Cosa succede quando elimino un'API Key?
L'eliminazione è immediata e definitiva: ogni applicativo che usava quella chiave smette di funzionare. Le altre chiavi restano attive.
Quale endpoint uso per chiamare senza configurare il centralino?
Il Webhook outbound call: la chiamata parte dai trunk VoIP di AI4CALL. Il caller ID deve essere un numero demo o acquistato presente nel tuo account.
Vuoi integrare AI4CALL con i tuoi software?
Parla con il nostro team: ti aiutiamo a collegare gli assistenti vocali AI4CALL ai tuoi applicativi tramite API.