Impostazioni
Impostazioni sviluppatore
Chiavi personali, client applicativi e collegamento di un agente o della CLI: i comandi della pagina Sofia API, e quale scegliere.
Questa sezione è l’ingresso di tutto ciò che è programmatico. La documentazione di riferimento si trova nelle schede API, Agents e Aggiungi Sofia alla tua app; questa pagina descrive i comandi dell’interfaccia. Apri le impostazioni, sezione «Sofia API».
Accesso
La pagina ha due schede: «Accesso personale» e «Client applicativi».
La tua chiave personale
- Crea la chiave. «Nuova chiave»: dalle un nome se vuoi, una scadenza (7 giorni, 30 giorni, 90 giorni, 1 anno o senza scadenza) e i suoi permessi. Sono tutti selezionati di default; tieni solo ciò di cui il tuo strumento ha bisogno.
- Copiala subito. Viene mostrata una sola volta, e Sofia ne conserva solo l’impronta.
- Usala. Inviala nell’header
Authorization: Bearerdi ogni chiamata. Una chiave agisce su tutte le tue attività, con i tuoi diritti.
Collegare un assistente IA
Per Claude, ChatGPT, Cursor, Gemini CLI o Claude Code, il connettore delle applicazioni connesse è spesso più semplice: non richiede alcuna chiave. Vedi Il connettore IA.
CLI e agenti
«Copia le istruzioni per l’agente» dà il testo da incollare nel tuo agente perché usi l’API. Il comando sofia, pubblicato su npm con il nome sofia-post, racchiude l’API per pubblicare da un terminale, da uno script o da un’attività pianificata; la sua installazione è nella scheda «Agents».
Client applicativi
Un client applicativo serve a costruire qualcosa che altri utenti di Sofia autorizzeranno, anziché qualcosa che agisce come te.
- Crea il client. «Nuovo client»: un nome, un logo di almeno 180 × 180 pixel, l’indirizzo della tua informativa sulla privacy, da uno a cinque URL di reindirizzamento in HTTPS e i permessi che l’app può chiedere. Il nome e il logo vengono mostrati alle persone durante l’autorizzazione.
- Copia le credenziali. Ottieni un Client ID e un Client Secret. Un client pubblico, per un’app il cui codice è pubblico, non ha un secret e si autentica con PKCE; questa scelta è definitiva.
- Implementa il flusso. Vedi la scheda «Aggiungi Sofia alla tua app».
Chiave o client OAuth?
| Criterio | Chiave personale | Client applicativo |
|---|---|---|
| Agisce come | Te | La persona che lo autorizza |
| Adatto per | I tuoi script e le tue automazioni | Un prodotto che altri utenti di Sofia useranno |
| Configurazione | Copiare la chiave | Dichiarare un client e implementare il flusso |
| Per revocare | «Revoca» la chiave | La persona toglie l’accesso in «Applicazioni connesse», oppure elimini il client |
Se automatizzi la tua pubblicazione, usa la chiave. Costruisci un client solo quando sono in gioco gli account di altre persone.
Per andare oltre
- API: endpoint, payload e impostazioni per rete, nella scheda API.
- CLI: pubblicare da un terminale, nella scheda Agents.
- Connettore IA: collegare Claude, Cursor o ChatGPT, vedi Il connettore IA.