---
title: Shopify
description: 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.
---

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**.

<Steps>
<Step>
**Apri Impostazioni → Integrazioni → Shopify** nel dashboard
(`app.audin.ai`) e premi **Connetti il tuo store**.
</Step>
<Step>
**Inserisci il dominio dello store** nel formato
`mio-store.myshopify.com` e premi **Continua su Shopify**.
</Step>
<Step>
**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.
</Step>
<Step>
**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.
</Step>
</Steps>

## Cosa viene sincronizzato

| Dato Shopify | In Audin | Note |
|---|---|---|
| Clienti | Sezione **eCommerce → Clienti** + lead CRM | Ordini totali, speso, indirizzo, consensi marketing, tag |
| Ordini | **eCommerce → Ordini** | Totali, stato pagamento ed evasione, righe, indirizzi, rischio |
| Prodotti | **eCommerce → Prodotti eComm** | Una voce per **variante** (SKU, prezzo, stock) |
| Spedizioni | **eCommerce → Spedizioni** | Tracking, 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"**.

<Callout type="info">
  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.
</Callout>

## 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.

<Callout type="warn">
  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.
</Callout>

## 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

<Cards>
  <Card
    href="/docs/integrazioni/hubspot"
    title="HubSpot"
    description="Importa contatti, aziende, deal e commerce dal tuo portale HubSpot."
  />
  <Card
    href="/docs/integrazioni"
    title="Integrazioni"
    description="Le altre integrazioni native della piattaforma."
  />
</Cards>
