Shopify

  Ta integracja umożliwia połączenie chatbota Botpress z Shopify, wiodącą platformą e-commerce. Dzięki tej integracji możesz ułatwić płynne interakcje związane z operacjami sklepu bezpośrednio z chatbota.

Aby skutecznie korzystać z integracji, należy podać nazwę sklepu Shopify (widoczną w przeglądarce/URL) oraz token dostępu wygenerowany po utworzeniu aplikacji Shopify.

## Wideo konfiguracji
[![image](https://i.imgur.com/mWb0uV9.png)](https://youtu.be/yjvsoaCvjmU)

## Konfiguracja

Aby skonfigurować integrację Shopify w Botpress, wymagane są następujące konfiguracje:

1. **Nazwa sklepu**: Znajduje się w adresie URL podczas uzyskiwania dostępu do sklepu Shopify. Na przykład, jeśli adres URL administratora sklepu to \` https://admin.shopify.com/store/botpress-test-store\`, wówczas nazwa sklepu, którą należy wprowadzić, to \`botpress-test-store\`.
2. **Token dostępu API**: Ten token jest niezbędny, aby umożliwić Botpress komunikację ze sklepem Shopify. Aby uzyskać token, należy utworzyć nową aplikację Shopify (instrukcje poniżej).

## Utwórz aplikację Shopify
1. Przejdź do sekcji "Aplikacje i kanały sprzedaży" na pulpicie nawigacyjnym Shopify.
2. Kliknij "Opracuj aplikacje".
3. Wybierz opcję "Utwórz aplikację" i nadaj aplikacji nazwę.
4. Kliknij "API Credentials" i w sekcji "Access Tokens" wybierz "Configure Admin API Scopes".
5. W przypadku tej integracji należy zaznaczyć pole dostępu "Odczyt" dla "Klientów", "Zamówień" i "Produktów". Da to botowi dostęp do odczytu każdej z tych właściwości.
6. Kliknij "Zapisz", a następnie "Zainstaluj aplikację", aby zakończyć instalację. 
7. Po instalacji możesz przejść do "API Credentials" i "Admin API access token", aby wyświetlić/skopiować swój token. 

## Włącz integrację

Aby aktywować integrację Shopify w Botpress:

1. Uzyskaj dostęp do panelu administracyjnego Botpress .
2. Przejdź do zakładki "Integracje".
3. Wyszukaj integrację Shopify i wybierz "Włącz" lub "Konfiguruj".
4. Wprowadź wymaganą nazwę sklepu i token dostępu API administratora.
5. Zapisz konfigurację.

## Użycie

### Działania
Po włączeniu integracji chatbot Botpress może komunikować się z Shopify w celu zadawania pytań dotyczących produktów i klientów przy użyciu poniższych akcji:

- Get Customer List: Zwraca listę klientów.
- Get Customer Order List: Zwraca listę zamówień dla określonego klienta według statusu (otwarte, zamknięte, anulowane lub dowolne).
- Get Product List: Zwraca listę produktów przy użyciu identyfikatora, tytułu lub typu produktu.
- Get Product Variants List: Zwraca listę wariantów produktu według Id.

### Zdarzenia
Po włączeniu integracji chatbot Botpres może odbierać zdarzenia z Shopify przy użyciu poniższych zdarzeń:

- Order Created: Uruchamiane po utworzeniu zamówienia.
- Order Updated: Wyzwalane, gdy zamówienie jest aktualizowane. 
- Zamówienie anulowane: Wyzwalane, gdy zamówienie zostanie anulowane. 
- Customer Created: Wyzwalane po utworzeniu klienta.
- Customer Updated: Wyzwalane, gdy klient zostanie zaktualizowany. 

 Uwaga: Nie można powiązać tych zdarzeń z konkretnymi konwersacjami. Zdarzenia te służą do przechowywania informacji o zdarzeniach w chatbocie (np. przechowywanie danych klienta/zamówienia w tabeli do zapytań).

## Ograniczenia
1. Mogą obowiązywać limity stawek stosowane przez API Shopify.
2. Zdarzenia nie są powiązane z konwersacjami.