Audin Docs
Integrazioni

Shopify

Collegare uno store Shopify ad Audin — autorizzazione in sola lettura, sincronizzazione di clienti, ordini, prodotti e spedizioni, la sezione eCommerce, il contesto per i bot AI, aggiornamenti in tempo reale e disconnessione.

Versione Markdown di questa pagina

Scarica o copia il contenuto di questa pagina in formato .md — utile per fornirlo a un agente AI che integra questa specifica feature.

Scarica .md

L'integrazione Shopify importa in Audin clienti, ordini, prodotti e spedizioni dello store, li tiene aggiornati in tempo reale e li mette a disposizione del CRM e dei bot AI: durante una conversazione il bot conosce lo storico acquisti del cliente, l'ultimo ordine e lo stato della spedizione.

L'integrazione è in sola lettura: Audin non scrive mai nulla sul tuo store.

Collegare lo store

Serve un utente con permessi di amministratore sullo store Shopify.

Apri Impostazioni → Integrazioni → Shopify nel dashboard (app.audin.ai) e premi Connetti il tuo store.

Inserisci il dominio dello store nel formato mio-store.myshopify.com e premi Continua su Shopify.

Autorizza su Shopify. Vieni portato nell'admin dello store per approvare i permessi richiesti: sono 5, tutti di sola lettura (clienti, ordini — incluso lo storico completo —, prodotti, spedizioni). Hai 10 minuti per completare l'autorizzazione, poi la sessione scade e va ripetuta.

Parte il backfill iniziale. Al ritorno su Audin ("Store collegato con successo!") inizia l'importazione dello storico completo, con una barra di avanzamento per ogni tipo di dato (Clienti / Ordini / Prodotti / Spedizioni). Su store grandi può richiedere tempo; puoi lasciare la pagina.

Cosa viene sincronizzato

Dato ShopifyIn AudinNote
ClientiSezione eCommerce → Clienti + lead CRMOrdini totali, speso, indirizzo, consensi marketing, tag
OrdinieCommerce → OrdiniTotali, stato pagamento ed evasione, righe, indirizzi, rischio
ProdottieCommerce → Prodotti eCommUna voce per variante (SKU, prezzo, stock)
SpedizionieCommerce → SpedizioniTracking, corriere, stato con timeline

Lead automatici. Per ogni cliente Shopify, Audin cerca un lead esistente (prima per telefono, poi per email) e lo collega; se non esiste e il cliente ha un numero di telefono, ne crea uno nuovo. I clienti con la sola email non generano un lead (il collegamento resta possibile in seguito). Sulla scheda del lead compare la card "Cliente eCommerce correlato" con ordini e speso; sulla scheda cliente, la card "Lead CRM correlato".

I prodotti importati da Shopify finiscono nel catalogo prodotti ma sono esclusi di default dalle righe dei Deal: nel selettore prodotti c'è il toggle "Includi prodotti ecommerce" per usarli.

La sezione eCommerce

A store collegato, nel menu compare la categoria eCommerce con quattro pagine — Clienti, Ordini, Spedizioni, Prodotti eComm — ognuna con ricerca, filtri (stato pagamento, canale di vendita, rischio, stato spedizione, stock…) e pagina di dettaglio: il dettaglio ordine mostra righe, totali, indirizzi e pagamento; il dettaglio spedizione la timeline di consegna. Se lo store viene scollegato, la categoria sparisce dal menu.

Il contesto per i bot AI

Quando un bot parla con un contatto collegato a un cliente Shopify, riceve automaticamente nel proprio contesto: profilo cliente (da quando è cliente, totale speso, consensi marketing), ultimo ordine completo (prodotti, totale, stato, spedizione con tracking) e il riepilogo degli ordini precedenti. Non serve configurare alcun tool: il contesto è precaricato a inizio conversazione, e nel dettaglio chiamata è visibile come blocco "Dati Shopify".

Aggiornamento dei dati

  • In tempo reale: lo store notifica Audin a ogni creazione, modifica o cancellazione di clienti, ordini, prodotti e spedizioni (14 tipi di evento), registrati automaticamente alla connessione.
  • Sincronizzazione periodica: una passata incrementale ogni ora fa da rete di sicurezza per gli eventi eventualmente persi.
  • "Forza sync ora" (in alto nella pagina Shopify): ri-esegue un backfill completo dello storico. È sicuro (non crea duplicati) ma può essere lungo; parte al prossimo ciclo di sincronizzazione, non all'istante.

La pagina dell'integrazione mostra tutto lo stato: la tab Panoramica (conteggi e ultimi eventi), Storico sync (ogni esecuzione con esito e numeri), Webhook ricevuti (gli eventi arrivati dallo store) e Webhook registrati, con il pulsante "Verifica con Shopify" che confronta le registrazioni con quelle realmente attive sullo store e suggerisce "Re-registra webhook" in caso di discrepanze.

Disconnessione

Disconnetti store (in alto a destra) offre due opzioni:

  • Disconnetti e mantieni dati storici — i dati già importati restano visibili e i bot continuano a vedere lo storico; ricollegando lo stesso store in futuro, gli aggiornamenti riprendono da dove erano.
  • Disconnetti e cancella tutti i dati Shopify importati — elimina definitivamente clienti, ordini, prodotti e spedizioni importati (richiede di digitare il nome dello store per conferma). I lead del CRM vengono sempre preservati.

In entrambi i casi le notifiche dallo store vengono disattivate e le credenziali di accesso distrutte.

La disconnessione va fatta da Audin: disinstallare l'app direttamente da Shopify non scollega l'integrazione (che resterebbe "connessa" con sincronizzazioni destinate a fallire). Se è successo, usa comunque "Disconnetti store" da Audin.

Limiti attuali

  • Uno store per account.
  • Integrazione in sola lettura: modifiche a clienti/ordini/prodotti si fanno su Shopify, mai da Audin.
  • La data di consegna prevista e l'istante di consegna effettivo non sempre sono disponibili: dipende dai dati che il corriere fornisce a Shopify.

Prossimi passi

On this page