Chiavi API
Accesso: Impostazioni → Chiavi API
Una chiave API è la password che un programma —il tuo ERP, un foglio di calcolo collegato, una dashboard tua— usa per leggere i tuoi dati di Epinium senza entrare nell'app. In questa schermata si creano, se ne cambiano i permessi e si annullano.
Qui si spiega la schermata. Per sapere quali informazioni puoi consultare con una chiave e come usarla da un programma, vedi la guida dell'API.
Vuoi solo collegare un assistente IA?
Non serve creare nessuna chiave. Vai su Impostazioni → MCP e autorizza l'assistente dal browser.
Le richieste consumano crediti
Ogni chiamata all'API spende crediti del tuo account, gli stessi che usano le funzioni di IA. I prezzi per risorsa sono in Impostazioni → Crediti, alla voce API pubblica e connettore MCP.
Due cose che evitano brutte sorprese: ti viene addebitato solo quello che viene consegnato, quindi una chiamata che fallisce non spende nulla; e nelle richieste di metriche quello che costa è l'intervallo di date, non il numero di righe. Se rimani senza crediti, la chiamata viene rifiutata prima di essere eseguita e la risposta indica cosa accorciare.
Il dettaglio delle intestazioni di costo e di quell'errore è nella guida dell'API.
Creare una chiave
- Premi Crea chiave API
- Dalle un nome che ti ricordi a cosa serve (per esempio, integrazione ERP): è l'unica cosa che vedrai poi per distinguerle
- Spunta i permessi che le servono
- Salva e copia il segreto che compare
- Incollalo nello strumento che dovrà usarlo
Il segreto si vede una volta sola
Alla creazione della chiave il suo valore completo appare una volta soltanto. Appena chiudi la finestra non è più recuperabile, né da Epinium né dal supporto.
I permessi
Ogni chiave porta con sé i permessi che spunti e raggiunge solo ciò che quei permessi aprono. Spunta il minimo di cui l'integrazione ha bisogno: se domani gliene servono di più, glieli aggiungi senza cambiare la chiave.
| Permesso | Le consente di consultare |
|---|---|
| Catalogo (lettura) | I tuoi prodotti, marchi, paesi e cluster |
| Campagne (lettura) | Campagne, gruppi di annunci, target, annunci di prodotto e termini di ricerca |
| Connessioni (lettura) | Gli account Amazon collegati a Epinium |
| Attività (lettura) | Le attività di Epinium e i loro suggerimenti |
| Skills (lettura) | Il catalogo di playbook di marketing di Epinium |
| Workflow (lettura) | Le tue automazioni, la loro configurazione e a quali campagne arrivano |
| Workflow (scrittura) | Oltre a consultarle, modificare la configurazione delle tue automazioni |
Una chiave senza alcun permesso spuntato non può consultare nulla.
Cosa vedi nella tabella
| Colonna | Cosa ti dice |
|---|---|
| Nome | Quello che le hai dato alla creazione |
| Prefisso | I primi caratteri del segreto. Servono a riconoscere una chiave quando ne hai diverse, senza rivelare il resto |
| Permessi | A cosa arriva quella chiave |
| Ultimo utilizzo | Quando è stata usata l'ultima volta. Se compare Mai usata, nessuno è riuscito a collegarla |
| Creata | La data di emissione |
La colonna Ultimo utilizzo è il modo rapido per trovare chiavi dimenticate: una che da mesi non viene usata quasi sempre è di troppo, e ogni chiave attiva è una porta aperta in più.
Cambiare i permessi di una chiave
Puoi modificare una chiave esistente e spuntare o togliere permessi. Il cambiamento si applica all'istante e la chiave resta la stessa: non c'è niente da toccare dove l'hai configurata.
È il modo migliore per ampliare o restringere la portata di un'integrazione, perché evita di generare un nuovo segreto e di ridistribuirlo.
Revocare una chiave
Revocare annulla la chiave per sempre. Qualsiasi integrazione che la usi smette di funzionare all'istante, quindi conviene sapere prima chi la usa: la colonna Ultimo utilizzo e il nome che le hai dato sono l'indizio.
Una chiave revocata non si può riattivare. Se l'integrazione deve tornare a funzionare, se ne crea una nuova e si sostituisce il segreto dove era impostato.
Se perdi il segreto
Non è recuperabile. L'unica strada è revocare la chiave e crearne un'altra, e poi cambiare il segreto nello strumento che lo usava.
Per questo conviene salvarlo appena creato nel gestore di password del team, e non in una mail o in una chat.
Se sei un'agenzia
Questa sezione compare anche nel tuo account di agenzia, come MCP e a differenza delle Connessioni. E dove crei la chiave ne cambia la portata:
- Creata nel tuo account di agenzia, la chiave è tua e raggiunge gli account che i tuoi clienti ti hanno condiviso. Ogni richiesta deve dire su quale opera.
- Creata dentro l'account di un cliente, la chiave è di quel cliente e raggiunge solo le sue connessioni.
Se quello che vuoi è collegare un assistente IA, non serve nessuna chiave: vedi Impostazioni → MCP.