Le chiavi API ti consentono di connettere in modo sicuro il tuo sito web, un'applicazione o un altro strumento al tuo account Brevo, in modo da poter automatizzare attività come l'aggiunta di contatti, l'invio di campagne o l'esportazione di dati.

Buono a sapersi

• Solo il proprietario dell'account o gli utenti con l'autorizzazione per le chiavi API possono accedere alla pagina API Keys & MCP (Chiavi API e MCP), creare una nuova chiave API o eliminare una chiave API esistente. Per saperne di più su utente autorizzazioni e autorizzazione livelli, consulta il nostro articolo dedicato Aggiungi utenti e assegna autorizzazioni in Brevo.
• Ogni volta che una chiave API viene creata o cancellata dall'account, l'account proprietario riceverà una notifica via email, contenente dettagli come l'indirizzo IP e la posizione.

Che cos'è una chiave API?

Una chiave API è un codice utilizzato per identificare e autenticare un'applicazione o un utente. Funge da identificatore univoco e fornisce un token segreto per l'autenticazione. Ad esempio, puoi utilizzare una chiave API per collegare il tuo sito web o sistema informativo a Brevo. Questo ti consentirà di attivare automaticamente e manualmente determinate azioni tra i due.

Con una chiave API puoi anche collegarti alla nostra API per aggiungere automaticamente nuovi contatti e svolgere attività più complesse, come:

• Creare e programmare campagne dall'API.
• Esportare utenti appartenenti a particolari liste.
• Esportare le statistiche di una campagna, ecc.

Per accedere alla lista completa dei comandi che puoi utilizzare con la nostra API, consulta la relativa documentazione.

Dove posso trovare le mie chiavi API?

Per proteggere e rendere più sicure le tue chiavi API esistenti, queste non sono visibili sul tuo account Brevo. Nella pagina Chiavi API e MCP vengono visualizzate solo le ultime cifre delle chiavi, in modo da poter distinguere tra diverse chiavi, se necessario:

Ecco perché le consigliamo vivamente di memorizzare la sua chiave API in un ambiente sicuro quando la crea. Se ha perso la sua chiave API, le consigliamo di crearne una nuova, memorizzarla in un ambiente sicuro e sostituire quella precedente.

Creazione di una chiave API

Quando configuri un'integrazione con il tuo account Brevo, potresti dover creare una nuova chiave API:

1. Clicca sul menu a discesa dell'account e seleziona Settings (Impostazioni) > SMTP & API (SMTP e API) > API Keys & MCP (Chiavi API e MCP).
2. Clicca su Generate a new API key (Genera una nuova chiave API).
   
3. Inserisci il codice a 6 cifre che hai ricevuto via email e clicca su Verify (Verifica).
   💡 Buono a sapersi

   Se non ricevi il codice, puoi richiederlo via email o tramite SMS dopo 1 minuto.
4. Dai un nome alla tua chiave API. Ricorda di specificare con quale integrazione verrà utilizzata la chiave API in modo da poterla riconoscere facilmente.
5. Imposta una data di scadenza da 7 giorni a 1 anno o scegli nessuna scadenza per la chiave API.
   ❗️ Importante

   Scegliere No expiration (Senza scadenza) significa che la chiave non ha una data di scadenza fissa. Non lo esenta dalla politica di inattività separata di Brevo:

   • Data di scadenza raggiunta: riceverai un promemoria via email 3 giorni prima e il giorno in cui la chiave scade.
   • 90 giorni di inattività: anche se non è impostata alcuna data di scadenza, la chiave viene disattivata se non effettua una chiamata API con successo entro 90 giorni. Riceverai un promemoria via email 7 giorni prima e il giorno stesso in cui ciò accade.
6. Clicca su Generate (Genera).
   
7. Copia la tua chiave API e conservala in un posto sicuro.
   
   ❗️ Importante

   La chiave API è visibile solo durante questa fase. Dopo aver creato la tua chiave API, non potrai più copiarla e, se la perdi, dovrai crearne una nuova.
   
8. (Opzionale) Attiva l'opzione Create MCP server API key (Crea una chiave API server MCP) per generare una versione della chiave API che ti consenta di collegare un sistema di intelligenza artificiale a Brevo tramite il protocollo MCP. Per ulteriori informazioni, consulta il nostro articolo dedicato Che cos'è il protocollo MCP (Model Context Protocol)?
   💡 Buono a sapersi

   Se attivi l’opzione Create MCP server API key (Crea una chiave API server MCP), la chiave API creata nella fase 4 viene disattivata e viene invece generata una versione MCP della chiave API.
9. Clicca su OK.

La nuova chiave API è stata creata.

Disattivazione di una chiave API

Se vuoi sospendere temporaneamente l'uso di una chiave API invece di cancellarla completamente, puoi disattivarla:

1. Clicca sul menu a discesa dell'account e seleziona Settings (Impostazioni) > SMTP e API > API Keys & MCP (Chiavi API e MCP).
2. Seleziona la chiave API che desideri disattivare.
3. Clicca su Deactivate API key (Disattiva chiave API).
   

Hai disattivato con successo la tua chiave API.

Per riattivare una chiave, selezionala di nuovo e clicca su Activate API key (Attiva chiave API).

Elimina una chiave API

Se il tuo account è stato compromesso o se non utilizzi più un'integrazione che richiede una particolare chiave API, puoi eliminare quella chiave API:

1. Clicca sul menu a discesa dell'account e seleziona Settings (Impostazioni) > SMTP e API > API Keys & MCP (Chiavi API e MCP).
2. Selezionare la chiave API che si desidera eliminare.
3. Clicca su Elimina chiave API.

La chiave API è stata eliminata correttamente.

Migliori pratiche di gestione delle chiavi API

Le chiavi API ti forniscono un accesso completo al tuo account Brevo e devono essere protette al pari di una password. Ecco alcune migliori pratiche da tenere a mente quando lavori con le chiavi API:

• Utilizza una chiave API diversa per ogni integrazione e specifica il nome dell'integrazione nel nome della chiave API, in modo da sapere esattamente quale chiave corrisponde a ciascuna integrazione. In questo modo, se una chiave API viene compromessa, puoi eliminarla senza influire sulle altre integrazioni.
• Conserva le chiavi API in un ambiente sicuro, non in un documento Word o su un post-it.
• Non mostrare mai pubblicamente la tua chiave API. Assicurati di nascondere la tua chiave API o, meglio ancora, tagliala completamente negli screenshot o nei video.
• Non inviare mai una chiave API via email, in quanto ciò consentirà l'accesso al tuo account Brevo se qualcuno viola il tuo account email.
• Elimina sempre le chiavi API che non usi più per limitare i rischi di fuga delle informazioni.
• Mantieni attive le chiavi che usi effettuando almeno una chiamata API andata a buon fine ogni 90 giorni, anche se non è impostata alcuna data di scadenza, per evitare una disattivazione imprevista. 
• Attiva il blocco degli indirizzi IP in modo che le chiamate API provenienti da indirizzi IP non riconosciuti vengano bloccate finché non li autorizzi. Per ulteriori informazioni, consulta il nostro articolo dedicato Miglioramento della sicurezza mediante l'autorizzazione di indirizzi IP per le chiamate API.

Risoluzione dei problemi relativi alle chiavi API

Se riscontri problemi con le tue chiavi API, consulta i seguenti suggerimenti per la risoluzione dei problemi prima di contattare il nostro team di assistenza.

La mia chiave API mostra "Expires: never" (Scaduta: mai), ma ho ricevuto un avviso di inattività

Non hai selezionato alcuna data di scadenza durante la creazione della chiave API, ma hai comunque ricevuto un avviso via email in cui si indica che la chiave verrà disattivata per inattività.

Cause e soluzioni comuni

Verifica della correzione

Effettua una chiamata API di prova utilizzando la chiave API, quindi verifica nella pagina API Keys & MCP (Chiavi API e MCP) che il suo stato risulti attivo.

Se il problema persiste, contatta il nostro team di assistenza e fornisci uno screenshot del messaggio di errore.

Ho ricevuto un'email di sicurezza con il messaggio "Verify a new IP" (Verifica un nuovo IP)

Hai ricevuto un'email da Brevo che ti chiedeva di confermare o smentire una chiamata API effettuata da un indirizzo IP non riconosciuto, e non sei sicuro se sia legittima o cosa fare dopo.

Cause e soluzioni comuni

Verifica della correzione

Vai alla pagina Authorized IPs (IP autorizzati) e verifica che l'indirizzo IP mostri lo stato previsto (autorizzato o rimosso).

Se continui a ricevere avvisi per indirizzi IP che non riconosci dopo aver cambiato la tua chiave API, contatta il nostro team di supporto.

⏭️ E adesso?

• Autorizzazione e blocco degli indirizzi IP per la sicurezza di API e SMTP
• Il mio account è stato compromesso, cosa devo fare?
• Che cos'è il Model Context Protocol (MCP)?

🤔 Domande?

In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.

Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.