For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/it/getting-started/api-keys.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
Chiavi API
Le chiavi API sono credenziali programmatiche per chiamare l’API di Voice Logica — ogni chiave è limitata alle operazioni che consenti e può essere ristretta a un singolo indirizzo IP. La stessa chiave collega anche i client MCP (ChatGPT, Claude) al tuo workspace. Le chiavi vivono in Team and access → API Keys.
Creare una chiave API
Sezione intitolata “Creare una chiave API”-
Apri la scheda API Keys
Vai su Team and access nel gruppo Account della barra laterale, seleziona la scheda API Keys e fai clic sul pulsante “Api Key”.

api-keys-0 -
Assegna un nome e limita l’IP
Dai un nome descrittivo che ne rifletta lo scopo — “CRM Integration”, “Webhook Handler”, “Initiate Call”. Facoltativamente inserisci un indirizzo IP per limitare le chiamate a un solo indirizzo; lascia vuoto per consentire qualsiasi IP.

api-keys-1 -
Scegli le operazioni consentite
In API operation restrictions, attiva le operazioni che la chiave può chiamare. Sono raggruppate per area — Calls, Agents, VoIP & SIP, SMS, Workflows, MCP, Billing e Shopify. Lascia tutto attivo per l’accesso completo, oppure disattiva ciò che la chiave non deve fare.

api-keys-2 -
Crea e copia la chiave
Fai clic su “Create API Key”. Il valore completo della chiave viene mostrato solo questa volta — copialo subito e conservalo al sicuro.

api-keys-3
Gestire le chiavi
Sezione intitolata “Gestire le chiavi”La tabella API Keys elenca ogni chiave con nome, chiave mascherata, ultimo utilizzo e data di creazione.

- Modifica — aggiorna nome, restrizione IP e operazioni consentite. Il valore della chiave non viene più mostrato e non può essere cambiato.
- Elimina — rimuove definitivamente la chiave. Non è annullabile, e qualsiasi applicazione che la usa perde subito l’accesso.
Usare la chiave API
Sezione intitolata “Usare la chiave API”Autentica le richieste inviando la chiave nell’header x-api-key:
x-api-key: YOUR_API_KEYAd esempio, avviare una chiamata IA in uscita:
curl -X POST https://api.voicelogica.ai/api/v1/phones/calls/initiate-call \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "destinationNumber": "+302101234567", "agentId": "your-agent-id", "voipPhoneId": "your-voip-phone-id" }'destinationNumber è obbligatorio; passa agentId per le chiamate IA in uscita, e voipPhoneId oppure sipTrunkId per scegliere la linea di uscita. Il riferimento interattivo completo di ogni endpoint è su api.voicelogica.ai/api-docs.
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”Perché le mie richieste API restituiscono 401 Unauthorized?
Verifichi che la chiave sia inviata nell’header x-api-key, non come token Bearer. Controlli anche che la chiave non sia stata eliminata dalla tabella delle chiavi API e, se ha una restrizione IP, che la richiesta provenga esattamente da quell’indirizzo.
Perché le mie richieste API restituiscono 403 Forbidden?
Le restrizioni della chiave API non includono l’endpoint che sta chiamando. Modifichi la chiave e attivi il gruppo di operazioni pertinente.
Prossimi passi
Sezione intitolata “Prossimi passi”Serve aiuto?
Sezione intitolata “Serve aiuto?”In caso di problemi, il team di supporto di Voice Logica è a disposizione:
