Stripe

  Ligue o seu chatbot Botpress a Stripe, uma popular plataforma de pagamentos online que facilita as transacções entre as empresas e os seus clientes. Stripe permite-lhe gerir pagamentos, subscrições, facturas e muito mais.

## Instalação e configuração

Para configurar a integração, terá de fornecer a sua Stripe `apiKey`. Esta chave pode ser obtida a partir do Stripe Dashboard. Uma vez configurada a integração, pode utilizar as acções incorporadas para gerir os seus dados de Stripe .

### Pré-requisitos

Antes de ativar a integração Botpress Stripe  , certifique-se de que tem o seguinte:

- Uma conta Botpress cloud  .
- `apiKey` gerada a partir de Stripe.

### Ativar a integração

Para ativar a integração Stripe em Botpress, siga estes passos:

1. Aceda ao seu painel de administração de Botpress .
2. Navegue até à secção "Integrações".
3. Localize a integração Stripe e clique em "Enable" (Ativar) ou "Configure" (Configurar).
4. Forneça a `apiKey` necessária.
5. Salve a configuração.

## Utilização

Uma vez que a integração esteja habilitada, você pode começar a usar os recursos do Stripe a partir do seu chatbot Botpress . A integração oferece diversas ações para interagir com Stripe, como `createPaymentLink` , `createSubsLink` (Para gerar Link de Pagamento de Assinatura), `listPaymentLinks` (IDs e URLs), `listProductPrices` (Se o preço tiver a propriedade "recurring", o produto é do tipo assinatura.), `findPaymentLink` (Por URL, retornar ID), e `deactivatePaymentLink` (Por ID). E as acções para Clientes, `listCustomers` (filtro opcional por e-mail), `searchCustomers` (por e-mail, nome e/ou telefone), `createCustomer` e `createOrRetrieveCustomer` (se o utilizador já existe, o seu e-mail já foi registado, obtenha-o. Se houver vários utilizadores com o mesmo nome, o utilizador será registado. Se existirem vários utilizadores com o mesmo email, devolve um array com eles. Se não existir, cria-o).

## Eventos suportados

- Falha de carregamento**: Este evento ocorre quando uma cobrança falha em Stripe.
- **Subscription Deleted**: Este evento ocorre quando uma subscrição é cancelada/eliminada em Stripe.
- **Subscrição actualizada**: Este evento ocorre quando uma subscrição é actualizada em Stripe. Por exemplo, quando a subscrição é cancelada, mas não termina imediatamente, `cancel_at_period_end` torna-se verdadeiro.
- **Falha no pagamento da fatura**: Este evento ocorre quando um pagamento de fatura falha em Stripe.
- **Payment Intent Failed**: Este evento ocorre quando uma intenção de pagamento falha em Stripe.

Estes eventos permitem que o seu chatbot responda a várias situações relacionadas com cobranças, pagamentos e subscrições em Stripe.