Utilizza l'API di Omnisend per connettere piattaforme ecommerce personalizzate (come Magento o OpenCart) o costruire integrazioni avanzate che trasferiscono dati di contatto, ordine, prodotto ed evento tra il tuo negozio e Omnisend.
Questo articolo spiega quando utilizzare l'API, cosa fa e quali guide all'integrazione seguire.
Prima di iniziare
✅ Questa guida è per:
Magento, OpenCart o piattaforme ecommerce personalizzate.
Sviluppatori che costruiscono integrazioni di app di terze parti.
Utenti avanzati che aggiungono funzionalità personalizzate (webhook, eventi personalizzati).
❌ Non necessario per:
Shopify, WooCommerce o BigCommerce (queste piattaforme si integrano automaticamente - nessuna configurazione API richiesta).
Requisiti:
Genera una chiave API (richiesta per tutte le richieste API).
Conoscenza di base delle API REST e JSON (o assumi uno sviluppatore).
Accesso al backend/codice del tuo negozio.
Che cos'è l'API di Omnisend?
L'API di Omnisend consente al tuo negozio o app di inviare automaticamente dati a Omnisend – nessun caricamento manuale richiesto.
Ad esempio, quando un cliente effettua un ordine, l'API passa i dettagli dell'ordine a Omnisend in modo da poter attivare le email di Conferma d'ordine. Oppure, quando un visitatore naviga tra i prodotti, l'API traccia la loro attività per i flussi di lavoro di Abbandono della navigazione.
Omnisend fornisce due tipi di API:
API REST – trasmette dati tra il backend del tuo negozio e Omnisend (contatti, ordini, prodotti, eventi).
API JavaScript – traccia l'attività del sito web (visualizzazioni di pagina, visualizzazioni di prodotto, aggiunte al carrello) per flussi di lavoro comportamentali.
Quando utilizzare l'API
Utilizza l'API se:
Gestisci una piattaforma ecommerce personalizzata (non Shopify/WooCommerce/BigCommerce).
Sei su Magento, OpenCart o un'altra piattaforma senza un plugin Omnisend nativo.
Vuoi creare integrazioni personalizzate (ad es., sincronizzare i contatti da un CRM, attivare flussi di lavoro basati su eventi dell'app).
Hai bisogno di funzionalità avanzate come webhook, tracciamento di eventi personalizzati o sincronizzazione dei dati in tempo reale.
Non utilizzare l'API se:
Sei su Shopify, WooCommerce o BigCommerce – utilizza invece il plugin nativo (installazione più veloce, senza codifica).
Iniziare
Passo 1. Rivedi la documentazione API:
Guida Rapida – nozioni di base sull'API REST (autenticazione, endpoint, formato della richiesta).
Guida all'API JavaScript – configurazione del tracciamento del sito web.
Passo 2. Genera una chiave API:
Segui questa guida per creare una chiave con i permessi corretti (Contatti, Ordini, Prodotti, Eventi).
Passo 3. Testa la tua integrazione:
Usa Log API (Impostazioni Negozio → Log API) per eseguire il debug delle richieste e confermare che i dati vengano trasmessi correttamente.
Guide all'integrazione specifiche per funzionalità
Una volta che la tua connessione API di base funziona, completa queste guide per abilitare funzionalità specifiche di Omnisend:
Contatti & Sincronizzazione Dati. Passa le informazioni di contatto a Omnisend– sincronizza le liste dei contatti iscritti, aggiungi proprietà personalizzate, aggiorna i dettagli del contatto.
Recupero Ordini & Carrello:
Abilita i flussi di lavoro per il Carrello abbandonato – passa i dati del carrello per attivare le email/SMS del carrello abbandonato.
Abilita i flussi di Conferma d'ordine e Conferma di spedizione – passa i dati dell'ordine per attivare le email transazionali.
Tracciamento Prodotto:
Imposta il Selettore Prodotto – consenti agli utenti di selezionare prodotti nell'Editor email e nei flussi automatizzati.
Abilita i flussi di lavoro per l'abbandono del Prodotto e l'Abbandono della navigazione – traccia le visualizzazioni dei prodotti e le aggiunte al carrello.
Eventi personalizzati. Trigger eventi personalizzati per Flussi automatizzati– passare dati personalizzati (ad es., "prova avviata," "abbonamento rinnovato") per attivare flussi di lavoro.
Analisi e Reporting (Beta). Esporta i dati analitici con l'API Statistiche– analizzare le prestazioni della campagna e del flusso, le metriche di coinvolgimento, l'attribuzione dei ricavi, le metriche di vendita a livello di prodotto (unità ordinate totali e attribuite), deliverability e dati sulla crescita dell'audience per strumenti BI, dashboard personalizzate o integrazioni con data warehouse.
Moduli e Tracciamento delle Prestazioni (Beta). Esporta i dati dei moduli con l'API Moduli– recupera elenchi di moduli, report sulle prestazioni, invii di contatto e dati dei Test A/B per dashboard personalizzate o integrazioni di terze parti.
Domande frequenti
Ho bisogno di competenze di programmazione per utilizzare l'API?
Sì. Dovrai comprendere le API REST, JSON e il codice backend del tuo negozio. Se non sei uno sviluppatore, assumi uno o utilizza un'integrazione nativa (Shopify/WooCommerce/BigCommerce).
Qual è la differenza tra REST API e JavaScript API?
REST API trasferisce dati tra server (contatti, ordini, prodotti)
API JavaScript traccia il comportamento degli utenti sul tuo sito web (visualizzazioni di pagina, visualizzazioni di prodotto, aggiunte al carrello)
La maggior parte delle integrazioni utilizza entrambi.
Posso utilizzare l'API insieme a integrazioni native?
Sì. Ad esempio, gli utenti di Shopify possono utilizzare l'API JavaScript per tracciare eventi personalizzati anche se l'integrazione principale (ordini, contatti) è automatica.
Come posso risolvere gli errori dell'API?
Controlla Log API (Impostazioni Negozio → Log API) per vedere i dettagli della richiesta/risposta. Problemi comuni: chiave API errata, campi richiesti mancanti e limite di frequenza superato.
Hai ulteriori domande? Parla con noi a [email protected] o nella chat in-app.