Shopify

  Diese Integration ermöglicht es Ihnen, Ihren Botpress Chatbot mit Shopify, einer führenden E-Commerce-Plattform, zu verbinden. Mit dieser Integration können Sie nahtlose Interaktionen im Zusammenhang mit dem Ladenbetrieb direkt von Ihrem Chatbot aus ermöglichen.

Um die Integration effektiv zu nutzen, müssen Sie den Namen Ihres Shopify-Shops (wie im Browser/URL zu sehen) und das nach der Erstellung einer Shopify-App generierte Zugriffstoken angeben.

## Einrichtungsvideo
[![Bild](https://i.imgur.com/mWb0uV9.png)](https://youtu.be/yjvsoaCvjmU)

## Konfiguration einrichten

Um die Shopify-Integration in Botpress einzurichten, sind die folgenden Konfigurationen erforderlich:

1. **Name des Shops/Stores**: Dieser ist in der URL enthalten, wenn Sie auf Ihren Shopify-Shop zugreifen. Wenn die URL zu Ihrer Shop-Verwaltung beispielsweise \`https://admin.shopify.com/store/botpress-test-store\` lautet, dann ist der Shop-Name, den Sie eingeben müssen, \`botpress-test-store\`.
2. **API-Zugangs-Token**: Dieses Token ist wichtig, damit Botpress mit Ihrem Shopify-Shop kommunizieren kann. Um ein Token zu erhalten, müssen Sie eine neue Shopify-App erstellen (Anleitung unten).

## Shopify App erstellen
1. Gehen Sie im Shopify-Dashboard zu "Apps und Verkaufskanäle".
2. Klicken Sie auf 'Apps entwickeln'.
3. Wählen Sie "Eine App erstellen" und geben Sie Ihrer App einen Namen.
4. Klicken Sie auf "API Credentials" und wählen Sie unter "Access Tokens" die Option "Configure Admin API Scopes".
5. Für diese Integration müssen Sie das Kontrollkästchen "Lesezugriff" für "Kunden", "Bestellungen" und "Produkte" aktivieren. Dadurch erhält der Bot die Berechtigung, jede dieser Eigenschaften zu lesen.
6. Klicken Sie auf "Speichern" und dann auf "App installieren", um die Installation abzuschließen. 
7. Nach der Installation können Sie unter "API Credentials" und "Admin API access token" Ihr Token einsehen/kopieren. 

## Integration aktivieren

So aktivieren Sie die Shopify-Integration in Botpress:

1. Greifen Sie auf das Botpress Admin-Dashboard zu.
2. Gehen Sie auf die Registerkarte "Integrationen".
3. Suchen Sie nach der Shopify-Integration und wählen Sie "Aktivieren" oder "Konfigurieren".
4. Geben Sie den erforderlichen Shop/Store-Namen und das Admin-API-Zugangs-Token ein.
5. Speichern Sie Ihre Konfigurationen.

## Verwendung

### Aktionen
Nachdem Sie die Integration aktiviert haben, kann Ihr Botpress Chatbot mit Shopify kommunizieren, um Produkt- und Kundenanfragen zu beantworten, indem er die folgenden Aktionen ausführt:

- Kundenliste abrufen: Liefert eine Liste von Kunden.
- Kundenbestellliste abrufen: Liefert eine Liste der Bestellungen für einen bestimmten Kunden nach Status (offen, geschlossen, storniert oder beliebig).
- Produktliste abrufen: Gibt eine Liste von Produkten anhand von Id, Titel oder Produkttyp zurück.
- Liste der Produktvarianten abrufen: Liefert eine Liste der Varianten eines Produkts nach Id.

### Ereignisse
Nachdem Sie die Integration aktiviert haben, kann Ihr Botpres-Chatbot Ereignisse von Shopify empfangen, indem er die folgenden Ereignisse verwendet:

- Bestellung erstellt: Wird ausgelöst, wenn eine Bestellung erstellt wird.
- Bestellung aktualisiert: Wird ausgelöst, wenn eine Bestellung aktualisiert wird. 
- Auftrag storniert: Wird ausgelöst, wenn ein Auftrag storniert wird. 
- Kunde angelegt: Wird ausgelöst, wenn ein Kunde angelegt wird.
- Kunde aktualisiert: Wird ausgelöst, wenn ein Kunde aktualisiert wird. 

 Hinweis: Sie können diese Ereignisse nicht mit bestimmten Unterhaltungen verknüpfen. Diese Ereignisse dienen zum Speichern von Ereignisinformationen innerhalb Ihres Chatbots (z. B. zum Speichern von Kunden-/Bestellungsdaten in einer Tabelle zur Abfrage)

## Einschränkungen
1. Es kann sein, dass die API von Shopify Ratenbeschränkungen anwendet.
2. Ereignisse sind nicht mit Konversationen verknüpft.