Połącz swojego chatbota Botpress z Stripe, popularną platformą płatności online, która ułatwia transakcje między firmami a ich klientami. Stripe umożliwia zarządzanie płatnościami, subskrypcjami, fakturami i nie tylko. ## Konfiguracja Aby skonfigurować integrację, musisz podać swój Stripe `apiKey`. Klucz ten można uzyskać z pulpitu nawigacyjnego Stripe . Po skonfigurowaniu integracji można używać wbudowanych akcji do zarządzania danymi Stripe . ### Wymagania wstępne Przed włączeniem integracji Botpress Stripe należy upewnić się, że dostępne są następujące elementy: - Konto w chmurze Botpress . - `apiKey` wygenerowany z Stripe. ### Włącz integrację Aby włączyć integrację Stripe w Botpress, wykonaj następujące kroki: 1. Uzyskaj dostęp do panelu administracyjnego Botpress . 2. Przejdź do sekcji "Integracje". 3. Znajdź integrację Stripe i kliknij "Włącz" lub "Konfiguruj". 4. Podaj wymagany `apiKey`. 5. Zapisz konfigurację. ## Użycie Po włączeniu integracji można rozpocząć korzystanie z funkcji Stripe z poziomu chatbota Botpress . Integracja oferuje kilka akcji do interakcji z Stripe, takich jak `createPaymentLink`, `createSubsLink` (do generowania linków do płatności subskrypcyjnych), `listPaymentLinks` (identyfikatory i adresy URL), `listProductPrices` (jeśli cena ma właściwość "recurring", produkt jest typu subskrypcji), `findPaymentLink` (według adresu URL, zwróć identyfikator) i `deactivatePaymentLink` (według identyfikatora). Akcje dla klientów, `listCustomers` (opcjonalny filtr według adresu e-mail), `searchCustomers` (według adresu e-mail, nazwy i/lub telefonu), `createCustomer` i `createOrRetrieveCustomer` (jeśli użytkownik już istnieje, jego adres e-mail został już zarejestrowany, pobierz go. Jeśli istnieje wielu użytkowników z tym samym adresem e-mail, zwróć ich tablicę. Jeśli nie istnieje, tworzy go). ## Obsługiwane zdarzenia - **Charge Failed**: To zdarzenie występuje, gdy ładowanie nie powiedzie się w Stripe. - **Subskrypcja usunięta**: To zdarzenie ma miejsce, gdy subskrypcja zostanie anulowana/usunięta w Stripe. - **Aktualizacja subskrypcji**: To zdarzenie ma miejsce, gdy subskrypcja jest aktualizowana w Stripe. Na przykład, gdy subskrypcja jest anulowana, ale nie kończy się natychmiast, `cancel_at_period_end` staje się prawdą. - **Płatność za fakturę nie powiodła się**: To zdarzenie ma miejsce, gdy płatność za fakturę nie powiedzie się w Stripe. - **Płatność nie powiodła się**: To zdarzenie występuje, gdy zamiar płatności nie powiedzie się w Stripe. Zdarzenia te pozwalają chatbotowi reagować na różne sytuacje związane z opłatami, płatnościami i subskrypcjami w Stripe.
