Una chiave API ti consente di connettere Omnisend a app di terze parti (come moduli personalizzati, CRM o strumenti middleware) e trasferire dati avanti e indietro tramite API.
In questo articolo, imparerai come creare una chiave API e configurare le sue autorizzazioni.
Prima di iniziare
Quando hai bisogno di una chiave API: Integrare Omnisend con app che non sono nella nostra libreria di integrazioni native (ad es., moduli di contatto personalizzati, flussi di lavoro Zapier o strumenti per sviluppatori).
Cosa fa: Autorizza le app esterne ad accedere a dati specifici di Omnisend (Contatti, Campagne, Ordini, ecc.) in base alle autorizzazioni che imposti.
Creazione di una Chiave API
Passaggio 1. Vai a Impostazioni Negozio → Chiavi API → cliccaCrea chiave API.
Passo 2. Digita il nome dell'app che stai collegando (ad es., Zapier, Typeform o la tua integrazione personalizzata).
Se Omnisend riconosce l'app, passerai attraverso una rapida procedura guidata invece di creare manualmente la chiave.
Passo 3. Seleziona le autorizzazioni della chiave API.
Se non sei stato spostato al passaggio di installazione dell'app dopo aver digitato il nome dell'app, prosegui con il processo e scegli le autorizzazioni che la chiave dovrebbe avere.
Ci sono alcune opzioni che puoi controllare. Le autorizzazioni consentono l'accesso ai seguenti dati:
Campagne – scaricare report e liste di destinatari
Contatti – creare, modificare, scaricare e eliminare contatti
Ordini – creare, modificare, scaricare e eliminare ordini
Prodotti – creare, modificare, scaricare e eliminare prodotti
Carrelli – creare, modificare, scaricare e eliminare carrelli
Eventi – attivazione e recupero di eventi personalizzati per Flussi automatizzati
I permessi sono creati per garantire che la tua chiave API trasmetta solo le informazioni che desideri e non abusi della tua integrazione. Puoi creare una combinazione diversa delle autorizzazioni, ad esempio, una chiave che ha accesso solo ai dati dei Contatti e non può accedere a Prodotti o Campagne.
Queste autorizzazioni sono utili quando integri Omnisend in modo esteso nel tuo negozio. Consulta la nostra documentazione per ulteriori informazioni su integrazione API.
Passo 4. Clicca Crea chiave API → Copia la chiave API e usala per la tua integrazione.
⚠️ Importante: Non puoi visualizzare di nuovo la chiave dopo aver chiuso questa schermata. Se la perdi, generane una nuova.
Comprendere le autorizzazioni della chiave API
Le autorizzazioni controllano quali dati di Omnisend la chiave API può accedere.
Ad esempio, una chiave con accesso solo ai Contatti non può modificare Campagne o Prodotti. Questo previene accessi non autorizzati a dati sensibili.
Puoi creare più chiavi con diversi set di permessi – ad esempio, una chiave per un modulo di contatto (Solo contatti) e un'altra per uno strumento di reporting (Campagne + Ordini).
💡 Consiglio: Quando integri Omnisend con flussi di lavoro complessi, rivedi la nostra documentazione completa delle API per casi d'uso avanzati.
Domande frequenti
Quante chiavi API posso creare?
Nessun limite. Crea chiavi separate per ogni integrazione per monitorare l'uso e revocare l'accesso se necessario.
Posso revocare una chiave API?
Sì. Vai a Impostazioni Negozio → Chiavi API, trova la chiave e clicca Elimina.
Le chiavi API sono sensibili al maiuscolo?
Sì. Copia e incolla la chiave esattamente come mostrato per evitare errori.
Se hai bisogno di aiuto, ricorda che siamo qui per te 24/7 a [email protected] e nella chat in-app.