Esta integración le permite conectar su chatbot Botpress con Shopify, una plataforma líder de comercio electrónico. Con esta integración, puedes facilitar interacciones fluidas relacionadas con las operaciones de la tienda directamente desde tu chatbot. Para utilizar eficazmente la integración, tendrás que proporcionar el nombre de tu tienda Shopify (como se ve en el navegador/URL) y el token de acceso generado tras crear una aplicación Shopify. ## Vídeo de instalación [![imagen](https://i.imgur.com/mWb0uV9.png)](https://youtu.be/yjvsoaCvjmU) ## Configuración Para configurar la integración de Shopify en Botpress, se requieren las siguientes configuraciones: 1. **Nombre de la tienda**: Se encuentra en la URL al acceder a su tienda Shopify. Por ejemplo, si la URL a la administración de su tienda es \`https://admin.shopify.com/store/botpress-test-store\`, entonces el nombre de la tienda que introducirá será \`botpress-test-store\`. 2. **Token de acceso a la API**: Este token es esencial para permitir que Botpress se comunique con tu tienda Shopify. Para obtener un token necesitarás crear una nueva app de Shopify (instrucciones más abajo). ## Crear aplicación Shopify 1. Ve a 'Apps y canales de venta' en el panel de control de Shopify. 2. Haz clic en 'Desarrollar Apps'. 3. Selecciona 'Crear una App' y dale un nombre a tu app. 4. 4. Haga clic en "Credenciales de API" y en "Tokens de acceso", seleccione "Configurar ámbitos de API de administración". 5. 5. Para esta integración tendrás que marcar la casilla de acceso "Leer" para "Clientes", "Pedidos" y "Productos". Esto le dará al bot el acceso para leer cada una de estas propiedades. 6. Haz clic en 'Guardar' y luego en 'Instalar app' para finalizar la instalación. 7. 7. Después de la instalación puedes ir a "Credenciales API" y "Admin API access token" para ver/copiar tu token. ## Habilitar integración Para activar la integración de Shopify en Botpress: 1. Accede al panel de administración de Botpress . 2. Ve a la pestaña "Integraciones". 3. Busca la integración con Shopify y selecciona "Activar" o "Configurar." 4. Introduce el Nombre de la tienda/tienda y el token de acceso a la API de administración necesarios. 5. 5. Guarde la configuración. ## Uso ### Acciones Después de habilitar la integración, su chatbot Botpress puede comunicarse con Shopify para consultas sobre productos y clientes utilizando las siguientes acciones: - Obtener lista de clientes: Devuelve una lista de clientes. - Obtener lista de pedidos de clientes: Devuelve una lista de pedidos de un cliente específico por estado (abierto, cerrado, cancelado o cualquiera). - Obtener lista de productos: Devuelve una lista de productos utilizando Id, Título o Tipo de producto. - Obtener lista de variantes de productos: Devuelve una lista de variantes de un producto por Id. ### Eventos Después de habilitar la integración, su Botpres chatbot puede recibir eventos de Shopify utilizando los eventos a continuación: - Pedido Creado: Se activa cuando se crea un pedido. - Pedido Actualizado: Se activa cuando se actualiza un pedido. - Orden cancelada: Se dispara cuando se cancela un pedido. - Cliente creado: Se dispara cuando se crea un cliente. - Cliente actualizado: Se activa cuando se actualiza un cliente. Nota: No puede vincular estos eventos a conversaciones específicas. Estos eventos son para almacenar información de eventos dentro de su chatbot (por ejemplo, almacenar datos de clientes/pedidos en una tabla para consultar) ## Limitaciones 1. Puede haber límites de tarifa aplicados por la API de Shopify. 2. Los eventos no están vinculados a conversaciones.