> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highcovery.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify

> Come collegare il tuo negozio Shopify a Highcovery

## Panoramica

L'integrazione Shopify sincronizza automaticamente i tuoi prodotti tra il negozio e Highcovery. Possiamo anche gestire il tracking di affiliazione direttamente dal tuo tema.

## Configurare la connessione

<Steps>
  <Step title="Selezionare la piattaforma">
    Apri **Connessioni** nella dashboard e clicca sul logo **Shopify** sotto *Sincronizzazione prodotti*.
  </Step>

  <Step title="Copiare la chiave API">
    Highcovery genera una chiave API per il tuo negozio. Copiala con il pulsante accanto al campo – ti servirà tra poco nell'app Shopify.
  </Step>

  <Step title="Installare Highcovery dallo Shopify App Store">
    Apri lo **App Store** nel tuo admin Shopify, cerca **Highcovery** e installa l'app sul tuo negozio. Conferma i permessi richiesti.
  </Step>

  <Step title="Incollare la chiave API nell'app">
    Dopo l'installazione, l'app Highcovery si apre direttamente nel tuo admin Shopify. Incolla la chiave API copiata prima e salva.
  </Step>

  <Step title="La connessione si stabilisce automaticamente">
    L'app contatta Highcovery con la tua chiave API e il dominio del tuo negozio. Lo stato nel dashboard passa a **Connesso** e la sincronizzazione prodotti si avvia.
  </Step>
</Steps>

<Note>La chiave API collega il tuo negozio Shopify al tuo account Highcovery. Senza di essa, l'app in Shopify non sa a quale account Highcovery appartiene.</Note>

## Disconnettere o verificare di nuovo

Nella pagina Connessioni puoi in qualsiasi momento:

* **Disconnetti** – ferma la sincronizzazione prodotti e rimuove il collegamento dell'app in Highcovery. L'app in Shopify **non** viene disinstallata automaticamente; se vuoi puoi rimuoverla manualmente dal tuo admin Shopify sotto **Apps**.
* **Verifica di nuovo** – quando lo stato di affiliazione è rosso, puoi avviare una verifica manuale.

## Perché una connessione si interrompe?

Una connessione esistente può passare a *fallita* per diversi motivi:

* **L'app è stata disinstallata** – se qualcuno con accesso admin disinstalla l'app Highcovery in Shopify, perdiamo l'accesso immediatamente.
* **Token di accesso scaduto o revocato** – Shopify può revocare i token, ad es. dopo eventi di sicurezza, cambi di piano o inattività prolungata.
* **Negozio in pausa, chiuso o congelato** – Shopify blocca l'accesso API a questi negozi, e sembra una connessione interrotta.
* **Errori webhook prolungati** – se Shopify non riesce a raggiungerci per aggiornamenti di ordini o prodotti (ad es. per disservizi), segnaliamo la connessione per riverifica.

## Ripristinare una connessione interrotta

<Steps>
  <Step title="Controllare l'admin Shopify">
    Accedi al tuo admin Shopify e apri **Apps**. Verifica che l'app Highcovery sia ancora installata.
  </Step>

  <Step title="Se l'app manca – reinstallare">
    Cerca **Highcovery** nello Shopify App Store e installa nuovamente l'app.
  </Step>

  <Step title="Reinserire la chiave API">
    Apri l'app Highcovery nel tuo admin Shopify e incolla la chiave API dalla pagina Connessioni.
  </Step>

  <Step title="Verificare la connessione">
    Nel dashboard clicca su **Verifica di nuovo**. Lo stato della connessione si aggiorna immediatamente.
  </Step>
</Steps>

<Warning>Usa sempre la stessa chiave API che appartiene al tuo account Highcovery. Una chiave sbagliata collegherà il negozio all'account sbagliato.</Warning>

<Tip>Per problemi ricorrenti, contatta [support@highcovery.com](mailto:support@highcovery.com) con il dominio del tuo negozio e un timestamp approssimativo del disservizio – ci permette di controllare efficacemente i log del server.</Tip>