Stripe

  Conecte su chatbot Botpress con Stripe, una popular plataforma de pago en línea que facilita las transacciones entre las empresas y sus clientes. Stripe le permite gestionar pagos, suscripciones, facturas y mucho más.

## Instalación y configuración

Para configurar la integración, deberá proporcionar su Stripe `apiKey`. Esta clave puede obtenerse en el panel de control de Stripe . Una vez configurada la integración, podrá utilizar las acciones integradas para gestionar sus datos de Stripe .

### Requisitos previos

Antes de habilitar la integración Botpress Stripe  , asegúrese de que dispone de lo siguiente:

- Una cuenta en la nube Botpress .
- `apiKey` generada a partir de Stripe.

### Habilitar Integración

Para habilitar la integración de Stripe en Botpress, siga estos pasos:

1. Acceda a su panel de administración Botpress .
2. Navega hasta la sección "Integraciones".
3. Localiza la integración Stripe y haz clic en "Activar" o "Configurar."
4. Proporcione la `apiKey` requerida.
5. 5. Guarde la configuración.

## Uso

Una vez habilitada la integración, puede empezar a utilizar las funcionalidades de Stripe desde su chatbot Botpress . La integración ofrece varias acciones para interactuar con Stripe, como `createPaymentLink` , `createSubsLink` (Para generar enlace de pago de suscripción), `listPaymentLinks` (IDs y URLs), `listProductPrices` (Si el precio tiene la propiedad "recurring", el producto es de tipo suscripción.), `findPaymentLink` (Por URL, devuelve ID), y `deactivatePaymentLink` (Por ID). Y acciones para Clientes, `listCustomers` (Filtro opcional por email), `searchCustomers` (Por email, nombre o/y teléfono), `createCustomer` y `createOrRetrieveCustomer` (Si el usuario ya existe, su email ya ha sido registrado, obténgalo. Si hay varios usuarios con el mismo email, devuelve un array de ellos. Si no existe, lo crea).

## Eventos Soportados

- Carga Fallida**: Este evento ocurre cuando una carga falla en Stripe.
- Suscripción eliminada**: Este evento se produce cuando se cancela/elimina una suscripción en Stripe.
- Suscripción actualizada**: Este evento se produce cuando se actualiza una suscripción en Stripe. Por ejemplo, cuando la suscripción se cancela, pero no finaliza inmediatamente, `cancel_at_period_end` se convierte en verdadero.
- Pago de factura fallido**: Este evento se produce cuando falla el pago de una factura en Stripe.
- Pago fallido**: Este evento ocurre cuando un intento de pago falla en Stripe.

Estos eventos permiten a su chatbot responder a diversas situaciones relacionadas con cargos, pagos y suscripciones en Stripe.