--- title: Gestione API e configurazioni tecniche description: Crea e gestisci le tue chiavi API, credenziali HTTP e parametri di integrazione per l’invio e la ricezione di messaggi. --- [Passa al contenuto](https://knowledge.qlara.ai/it-it/gestione-api-e-configurazioni-tecniche#main-content) Italiano - Italia Mostra sottomenu per le traduzioni [Ulteriore assistenza](https://knowledge.qlara.ai/it-it/kb-tickets/new?hsLang=it-it) [![Logo\_Qlara-composto-occhi](https://knowledge.qlara.ai/hubfs/Logo_Qlara-composto-occhi.svg)](https://lora.agiletelecom.com/) Apri navigazione principale Chiudi navigazione principale - Italiano - Italia Mostra sottomenu per le traduzioni - [Ulteriore assistenza](https://knowledge.qlara.ai/it-it/kb-tickets/new) - [Contattaci](mailto:qlara@agiletelecom.com) [Contattaci](mailto:qlara@agiletelecom.com) In che modo possiamo aiutarti? - Non sono presenti suggerimenti perché il campo di ricerca è vuoto. 1. [Qlara Knowledge Base](https://knowledge.qlara.ai/it-it?hsLang=it-it) 2. [Account e Impostazioni](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it) 3. [GESTIONE API](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#gestione-api) # Gestione API e configurazioni tecniche ## Crea e gestisci le tue chiavi API, credenziali HTTP e parametri di integrazione per l’invio e la ricezione di messaggi. #### **Gestione API e configurazioni tecniche** La sezione **API e configurazioni** consente di gestire tutte le impostazioni necessarie per l’integrazione della piattaforma Qlara con sistemi esterni o applicazioni proprietarie. Da qui puoi creare **chiavi API**, configurare **autenticazioni HTTP**, impostare **filtri IP** e definire **callback URL** per ricevere notifiche automatiche di consegna. Puoi accedere a questa sezione da: **Impostazioni → Account personale → API e configurazioni.**     ### **1. Creazione di una nuova API Key** Le **API Key** permettono di autenticare i tuoi sistemi quando inviano richieste HTTP alla piattaforma Qlara. Per crearne una nuova: 1. Clicca su **Aggiungi nuova chiave**. 2. Verrà generata automaticamente una chiave univoca. 3. **Copia la chiave subito** — per motivi di sicurezza non sarà più visibile in chiaro dopo la creazione. > Le chiavi salvate vengono mostrate solo in forma offuscata. > È consigliato creare chiavi diverse per ogni applicazione o ambiente (es. test, produzione).     ### **2. Gestione delle credenziali HTTP** Le **credenziali HTTP** sono utilizzate per autenticare le chiamate dirette ai servizi di invio messaggi tramite protocollo HTTPS. Per configurarle: 1. Clicca su **Aggiungi nuove credenziali**. 2. Inserisci il nome utente e la password dedicati all’account API. 3. Salva la configurazione. > Puoi utilizzare queste credenziali per autenticarti nei metodi di invio HTTP forniti da Qlara. > Le password vengono memorizzate in forma cifrata e non sono mai visualizzabili integralmente.   ### **3. Filtri IP** Per una maggiore sicurezza, è possibile limitare le richieste API a specifici indirizzi IP o range IP. Per aggiungere un filtro: 1. Clicca su **Aggiungi filtro IP**. 2. Inserisci l’indirizzo IP o il range da autorizzare (es. 192.168.1.0/24). 3. Salva le modifiche. > Solo le richieste provenienti dagli IP configurati verranno accettate. > L’assenza di filtri consente l’accesso da qualsiasi IP, pertanto si raccomanda di impostarli sempre in ambienti di produzione.   ### **4. URL Delivery (Callback)** Questa sezione permette di configurare l’**URL di notifica** che riceverà automaticamente gli aggiornamenti sullo stato dei messaggi (delivery report). Per attivarlo: 1. Seleziona il tipo di **notifica delivery POST** dal menu a tendina:   - **Disabilitato** - **Abilitato (Legacy)** – formato compatibile con versioni precedenti - **Abilitato JSON** – formato consigliato per nuove integrazioni 2. Inserisci l’**URL di notifica** (es. https://api.tuodominio.com/delivery). 3. Clicca su **Salva**. > Quando un messaggio cambia stato (es. consegnato, fallito), la piattaforma invierà un payload JSON all’URL configurato.   ### **5. Best practice per l’integrazione** - Utilizza **connessioni HTTPS** per tutte le chiamate API. - Conserva le chiavi API in un sistema sicuro (es. secret manager o vault). - Non condividere le credenziali HTTP con utenti esterni. - In caso di sospetto accesso non autorizzato, **revoca immediatamente** la chiave e rigenerane una nuova. - Imposta sempre un **callback URL di test** per verificare la corretta ricezione delle notifiche di delivery.     ### **Nota** Queste configurazioni sono destinate principalmente agli utenti che inviano traffico tramite **integrazione diretta (HTTP/REST API)**. Gli utenti che utilizzano esclusivamente la console web non necessitano di impostare chiavi API o filtri IP. - [Inizia](https://knowledge.qlara.ai/it-it/inizia?hsLang=it-it#main-content) - [COSA FA QLARA](https://knowledge.qlara.ai/it-it/inizia?hsLang=it-it#cosa-fa-qlara) - [Rubrica](https://knowledge.qlara.ai/it-it/rubrica?hsLang=it-it#main-content) - [IMPORT CONTATTI](https://knowledge.qlara.ai/it-it/rubrica?hsLang=it-it#import-contatti) - [CONTATTI](https://knowledge.qlara.ai/it-it/rubrica?hsLang=it-it#contatti) - [CONTATTO SINGOLO](https://knowledge.qlara.ai/it-it/rubrica?hsLang=it-it#contatto-singolo) - [CONTATTI MULTIPLI](https://knowledge.qlara.ai/it-it/rubrica?hsLang=it-it#contatti-multipli) - [Messaggistica](https://knowledge.qlara.ai/it-it/messaggistica?hsLang=it-it#main-content) - [ARCHIVIO CAMPAGNE](https://knowledge.qlara.ai/it-it/messaggistica?hsLang=it-it#archivio-campagne) - [CAMPAGNE IN BOZZA](https://knowledge.qlara.ai/it-it/messaggistica?hsLang=it-it#campagne-in-bozza) - [IMPOSTAZIONI](https://knowledge.qlara.ai/it-it/messaggistica?hsLang=it-it#impostazioni) - [SMS](https://knowledge.qlara.ai/it-it/messaggistica?hsLang=it-it#sms) - [WHATSAPP](https://knowledge.qlara.ai/it-it/messaggistica?hsLang=it-it#whatsapp) - [RCS](https://knowledge.qlara.ai/it-it/messaggistica?hsLang=it-it#rcs) - [Social Media](https://knowledge.qlara.ai/it-it/social-media?hsLang=it-it#main-content) - [CREARE POST](https://knowledge.qlara.ai/it-it/social-media?hsLang=it-it#creare-post) - [FORMATI E LIMITI](https://knowledge.qlara.ai/it-it/social-media?hsLang=it-it#formati-e-limiti) - [PUBBLICAZIONE E GESTIONE](https://knowledge.qlara.ai/it-it/social-media?hsLang=it-it#pubblicazione-e-gestione) - [Marketing Team](https://knowledge.qlara.ai/it-it/marketing-team?hsLang=it-it) - [Email](https://knowledge.qlara.ai/it-it/email?hsLang=it-it#main-content) - [CONNETTERE UN DOMINIO EMAIL A QLARA](https://knowledge.qlara.ai/it-it/email?hsLang=it-it#connettere-un-dominio-email-a-qlara) - [CREA UNA CAMPAGNA EMAIL](https://knowledge.qlara.ai/it-it/email?hsLang=it-it#crea-una-campagna-email) - [Gestisci](https://knowledge.qlara.ai/it-it/gestisci?hsLang=it-it#main-content) - [SITO VETRINA](https://knowledge.qlara.ai/it-it/gestisci?hsLang=it-it#sito-vetrina) - [PRENOTAZIONI](https://knowledge.qlara.ai/it-it/gestisci?hsLang=it-it#prenotazioni) - [Automazioni](https://knowledge.qlara.ai/it-it/automazioni?hsLang=it-it#main-content) - [CREA AUTOMAZIONI](https://knowledge.qlara.ai/it-it/automazioni?hsLang=it-it#crea-automazioni) - [AGENT STUDIO](https://knowledge.qlara.ai/it-it/automazioni?hsLang=it-it#agent-studio) - [Inbox](https://knowledge.qlara.ai/it-it/inbox?hsLang=it-it#main-content) - [SETTINGS INBOX](https://knowledge.qlara.ai/it-it/inbox?hsLang=it-it#settings-inbox) - [Media & Gallery](https://knowledge.qlara.ai/it-it/media-gallery?hsLang=it-it#main-content) - [GALLERIA MEDIA](https://knowledge.qlara.ai/it-it/media-gallery?hsLang=it-it#galleria-media) - [Calendario](https://knowledge.qlara.ai/it-it/calendario?hsLang=it-it#main-content) - [CALENDARIO INVII E PUBBLICAZIONI](https://knowledge.qlara.ai/it-it/calendario?hsLang=it-it#calendario-invii-e-pubblicazioni) - [Analisi](https://knowledge.qlara.ai/it-it/analisi?hsLang=it-it#main-content) - [EXPORT](https://knowledge.qlara.ai/it-it/analisi?hsLang=it-it#export) - [STORICO INVII](https://knowledge.qlara.ai/it-it/analisi?hsLang=it-it#storico-invii) - [STATO DI CONSEGNA](https://knowledge.qlara.ai/it-it/analisi?hsLang=it-it#stato-di-consegna) - [Account e Impostazioni](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#main-content) - [FATTURAZIONE](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#fatturazione) - [CAMBIO PASSWORD](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#cambio-password) - [PROFILO PERSONALE](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#profilo-personale) - [PROFILO AZIENDALE](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#profilo-aziendale) - [BRAND](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#brand) - [GESTIONE API](https://knowledge.qlara.ai/it-it/account-e-impostazioni?hsLang=it-it#gestione-api) - [AI](https://knowledge.qlara.ai/it-it/ai?hsLang=it-it#main-content) - [USARE L'AI](https://knowledge.qlara.ai/it-it/ai?hsLang=it-it#usare-lai) - [MODELLI AI](https://knowledge.qlara.ai/it-it/ai?hsLang=it-it#modelli-ai) - [Assistenza e Supporto](https://knowledge.qlara.ai/it-it/assistenza-e-supporto?hsLang=it-it#main-content) - [SUPPORTO E ASSISTENZA](https://knowledge.qlara.ai/it-it/assistenza-e-supporto?hsLang=it-it#supporto-e-assistenza) - [Security & Compliance](https://knowledge.qlara.ai/it-it/security-compliance?hsLang=it-it#main-content) - [SECURITY PROCEDURE](https://knowledge.qlara.ai/it-it/security-compliance?hsLang=it-it#security-procedure) [![Logo\_Qlara-composto-occhi](https://knowledge.qlara.ai/hubfs/Logo_Qlara-composto-occhi.svg "Logo_Qlara-composto-occhi")](https://lora.agiletelecom.com) [mailto:qlara@agiletelecom.com](mailto:qlara@agiletelecom.com) Copyright © 2026, Agile Telecom S.p.A.