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
- Imposta il livello di accesso di ogni area: la chiave arriva in solo lettura, che è ciò di cui ha bisogno quasi ogni integrazione. Se la tua deve modificare qualcosa, alza quell'area a Modifica
- 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 raggiunge solo le aree che le apri, con il livello che dai loro. Dalle il minimo di cui l'integrazione ha bisogno: se domani le serve di più, glielo alzi senza cambiare la chiave.
| Area | Cosa apre |
|---|---|
| Catalogo | I tuoi prodotti, marchi, paesi e raggruppamenti di parole chiave, con le loro metriche. Su Modificare, creare raggruppamenti di parole chiave, cambiarne le parole chiave e i prodotti, ed eliminarli |
| Campagne | Campagne, portafogli, gruppi di annunci, target, annunci di prodotto e termini di ricerca, con le loro metriche. In Modificare, creare campagne e portafogli e cambiare offerte, budget e stato su Amazon |
| Connessioni | Gli account Amazon e i negozi Shopify e WooCommerce collegati a Epinium: che cosa hai collegato, non che cosa contiene |
| Dati dei tuoi negozi e piattaforme collegati | Ciò che c'è dentro i tuoi negozi Shopify e WooCommerce: prodotti, scorte, prezzi e il resto di ciò che espongono, e il registro delle modifiche fatte in essi. È ciò che usa un assistente IA per consultare il negozio. In Modificare, creare, modificare ed eliminare prodotti e contenuti direttamente nel negozio, senza revisione preventiva |
| Attività | Le attività di Epinium e i loro suggerimenti. In Modificare, creare attività, approvare o rifiutare i loro suggerimenti e applicare quanto approvato |
| CMO Brain | Il catalogo di playbook di marketing di Epinium |
| Flussi di lavoro | Le tue automazioni, la loro configurazione e le prestazioni delle campagne che ottimizzano |
Ogni area si imposta su uno di tre livelli: Nessun accesso, Vedere o Modificare. Oggi accettano Modificare il Catalogo, le Campagne, i Dati dei tuoi negozi e piattaforme collegati, le Attività e i Flussi di lavoro, e Modificare include Vedere: un'integrazione che scrive legge anche.
Modificare è dei piani Business e Master. In Free e Guru le chiavi leggono e il livello Modificare appare bloccato. Se passi a uno di questi piani, una chiave che aveva già Modificare continua a servire per leggere, ma le sue scritture vengono rifiutate.
Sopra, due modelli spostano tutte le aree insieme: Accesso completo e Solo lettura. Una chiave ha bisogno di almeno un permesso: senza nessuno fallirebbe tutte le sue chiamate, quindi non si può salvare così.
Cosa vedi nella tabella
| Colonna | Cosa ti dice |
|---|---|
| Nome | Quello che le hai dato alla creazione, con il prefisso sotto: i primi caratteri del segreto, per riconoscerla senza rivelare il resto |
| Accesso | Un riepilogo in un'etichetta: Accesso completo, Solo lettura, Personalizzato (una combinazione su misura) o Nessun accesso in rosso, che significa che quella chiave non funziona |
| 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 alzare o abbassare il livello di ogni area. 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.