Shopify

  Questa integrazione consente di collegare il chatbot Botpress con Shopify, una delle principali piattaforme di e-commerce. Grazie a questa integrazione, è possibile facilitare le interazioni con le operazioni del negozio direttamente dal chatbot.

Per utilizzare efficacemente l'integrazione, è necessario fornire il nome del negozio Shopify (come visibile nel browser/URL) e il token di accesso generato dopo la creazione di un'app Shopify.

## Video di configurazione
[![immagine](https://i.imgur.com/mWb0uV9.png)](https://youtu.be/yjvsoaCvjmU)

## Configurazione

Per impostare l'integrazione di Shopify in Botpress, sono necessarie le seguenti configurazioni:

1. **Nome del negozio**: Si trova nell'URL quando si accede al negozio Shopify. Ad esempio, se l'URL dell'amministrazione del negozio è \`https://admin.shopify.com/store/botpress-test-store\`, il nome del negozio da inserire è \`botpress-test-store\`.
2. **Token di accesso all'API**: Questo token è essenziale per consentire a Botpress di comunicare con il vostro negozio Shopify. Per ottenere un token è necessario creare una nuova applicazione Shopify (le istruzioni sono riportate di seguito).

## Creare un'applicazione Shopify
1. Andare su "App e canali di vendita" nella dashboard di Shopify.
2. Cliccate su "Sviluppa applicazioni".
3. Selezionate "Crea un'app" e date un nome alla vostra applicazione.
4. Fare clic su "Credenziali API" e, sotto "Token di accesso", selezionare "Configura gli ambiti API dell'amministratore".
5. Per questa integrazione è necessario selezionare la casella di accesso 'Read' per 'Customers', 'Orders' e 'Products'. Questo darà al bot l'accesso alla lettura di ciascuna di queste proprietà.
6. Fare clic su "Salva" e poi su "Installa app" per terminare l'installazione. 
7. Dopo l'installazione è possibile andare su "Credenziali API" e "Token di accesso API Admin" per visualizzare/copiare il token. 

## Abilitare l'integrazione

Per attivare l'integrazione con Shopify in Botpress:

1. Accedere alla dashboard di amministrazione di Botpress .
2. Andare alla scheda "Integrazioni".
3. Cercare l'integrazione Shopify e selezionare "Abilita" o "Configura".
4. Inserite il nome del negozio/deposito e il token di accesso all'API Admin richiesti.
5. Salvare le configurazioni.

## Utilizzo

### Azioni
Dopo aver abilitato l'integrazione, il chatbot Botpress può comunicare con Shopify per le domande sui prodotti e sui clienti utilizzando le azioni riportate di seguito:

- Ottieni elenco clienti: Restituisce un elenco di clienti.
- Ottenere l'elenco degli ordini dei clienti: Restituisce un elenco di ordini per un cliente specifico in base allo stato (aperto, chiuso, annullato o qualsiasi).
- Ottieni elenco prodotti: Restituisce un elenco di prodotti in base a Id, Titolo o Tipo di prodotto.
- Elenco delle varianti dei prodotti: Restituisce un elenco di varianti di un prodotto per Id.

### Eventi
Dopo aver abilitato l'integrazione, il chatbot Botpres può ricevere eventi da Shopify utilizzando gli eventi indicati di seguito:

- Ordine creato: Si attiva quando viene creato un ordine.
- Ordine aggiornato: Si attiva quando un ordine viene aggiornato. 
- Ordine annullato: Attivato quando un ordine viene annullato. 
- Cliente creato: Attivato quando viene creato un cliente.
- Cliente aggiornato: Attivato quando un cliente viene aggiornato. 

 Nota: non è possibile collegare questi eventi a conversazioni specifiche. Questi eventi servono per memorizzare le informazioni sugli eventi all'interno del chatbot (ad esempio, per memorizzare i dati dei clienti/ordini in una tabella da interrogare).

## Limitazioni
1. L'API di Shopify potrebbe applicare dei limiti di velocità.
2. Gli eventi non sono collegati alle conversazioni.