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.
