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.