Stripe

  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.