Stripe

  Collegate il vostro chatbot Botpress con Stripe, una famosa piattaforma di pagamento online che facilita le transazioni tra le aziende e i loro clienti. Stripe vi permette di gestire pagamenti, abbonamenti, fatture e altro ancora.

## Impostazione e configurazione

Per configurare l'integrazione, è necessario fornire la propria `apiKey` di Stripe . Questa chiave può essere ottenuta dalla dashboard di Stripe . Una volta configurata l'integrazione, è possibile utilizzare le azioni integrate per gestire i dati di Stripe .

### Prerequisiti

Prima di attivare l'integrazione Botpress Stripe  , assicurarsi di disporre di quanto segue:

- Un account Botpress cloud  .
- `apiKey` generata da Stripe.

### Abilitare l'integrazione

Per abilitare l'integrazione di Stripe in Botpress, procedere come segue:

1. Accedere al pannello di amministrazione di Botpress .
2. Andare alla sezione "Integrazioni".
3. Individuare l'integrazione Stripe e fare clic su "Abilita" o "Configura".
4. Fornire la `apiKey` richiesta.
5. Salvare la configurazione.

## Uso

Una volta abilitata l'integrazione, è possibile iniziare a utilizzare le funzionalità di Stripe dal proprio chatbot Botpress . L'integrazione offre diverse azioni per interagire con Stripe, come `createPaymentLink` , `createSubsLink` (per generare link di pagamento per gli abbonamenti), `listPaymentLinks` (ID e URL), `listProductPrices` (se il prezzo ha la proprietà "recurring", il prodotto è di tipo abbonamento), `findPaymentLink` (per URL, ID di ritorno) e `deactivatePaymentLink` (per ID). E le azioni per i clienti, `elencoClienti` (filtro opzionale per e-mail), `ricercaClienti` (per e-mail, nome e/o telefono), `creaCliente` e `creaOrRecuperaCliente` (se l'utente esiste già, la sua e-mail è già stata registrata, recuperarla. Se ci sono più utenti con la stessa email, restituisce un array di essi. Se non esiste, lo crea).

## Eventi supportati

- **Carica fallita**: Questo evento si verifica quando un addebito non riesce in Stripe.
- **Abbonamento cancellato**: Questo evento si verifica quando un abbonamento viene cancellato/eliminato in Stripe.
- **Abbonamento aggiornato**: Questo evento si verifica quando un abbonamento viene aggiornato in Stripe. Ad esempio, quando l'abbonamento viene annullato, ma non termina immediatamente, `cancel_at_period_end` diventa vero.
- **Pagamento della fattura non riuscito**: Questo evento si verifica quando il pagamento di una fattura non riesce in Stripe.
- **Intento di pagamento fallito**: Questo evento si verifica quando un intento di pagamento fallisce in Stripe.

Questi eventi consentono al chatbot di rispondere a varie situazioni relative a spese, pagamenti e abbonamenti in Stripe.