Esta integração permite-lhe ligar o seu chatbot Botpress à Shopify, uma plataforma de comércio eletrónico líder. Com esta integração, pode facilitar interações perfeitas relacionadas com as operações da loja diretamente a partir do seu chatbot. Para utilizar eficazmente a integração, terá de fornecer o nome da sua loja Shopify (como visto no navegador/URL) e o token de acesso gerado após a criação de uma aplicação Shopify. ## Vídeo de configuração [](https://youtu.be/yjvsoaCvjmU) ## Configuração Para configurar a integração do Shopify em Botpress, são necessárias as seguintes configurações: 1. **Nome da loja**: Encontrado no URL ao aceder à sua loja Shopify. Por exemplo, se o URL de acesso ao administrador da sua loja for \`https://admin.shopify.com/store/botpress-test-store\`, então o nome da loja que irá introduzir é \`botpress-test-store\`. 2. **Token de acesso à API**: Este token é essencial para permitir que o Botpress se comunique com sua loja Shopify. Para obter um token, terá de criar uma nova aplicação Shopify (instruções abaixo). ## Criar App Shopify 1. Vá para "Aplicativos e canais de vendas" no painel do Shopify. 2. Clique em "Desenvolver aplicativos". 3. Selecione "Criar uma aplicação" e dê um nome à sua aplicação. 4. Clique em "API Credentials" (Credenciais da API) e, em "Access Tokens" (Tokens de acesso), selecione "Configure Admin API Scopes" (Configurar âmbitos da API do administrador) 5. Para esta integração, terá de selecionar a caixa de acesso "Read" (Ler) para "Customers" (Clientes), "Orders" (Encomendas) e "Products" (Produtos). Isto dará ao bot o acesso para ler cada uma destas propriedades. 6. Clique em "Save" (Guardar) e depois em "Install app" (Instalar aplicação) para concluir a instalação. 7. Após a instalação, pode aceder a "API Credentials" e "Admin API access token" para ver/copiar o seu token. ## Ativar a integração Para ativar a integração do Shopify em Botpress: 1. Aceder ao painel de administração do Botpress . 2. Aceda ao separador "Integrações". 3. Procure a integração do Shopify e selecione "Ativar" ou "Configurar". 4. Introduza o nome da loja/loja e o token de acesso à API do administrador necessários. 5. Salve suas configurações. ## Utilização ### Ações Depois de habilitar a integração, seu chatbot Botpress pode se comunicar com a Shopify para consultas de produtos e clientes usando as ações abaixo: - Obter lista de clientes: Retorna uma lista de clientes. - Obter lista de pedidos de clientes: Retorna uma lista de pedidos de um cliente específico por status (aberto, fechado, cancelado ou qualquer). - Obter lista de produtos: Retorna uma lista de produtos usando Id, Título ou Tipo de produto. - Obter lista de variantes de produtos: Devolve uma lista de variantes de um produto por Id. ### Eventos Depois de habilitar a integração, seu chatbot Botpres pode receber eventos do Shopify usando os eventos abaixo: - Pedido criado: Acionado quando um pedido é criado. - Pedido atualizado: Acionado quando um pedido é atualizado. - Ordem cancelada: Acionado quando uma encomenda é cancelada. - Cliente criado: Acionado quando um cliente é criado. - Cliente atualizado: Acionado quando um cliente é atualizado. Observação: não é possível vincular esses eventos a conversas específicas. Esses eventos servem para armazenar informações de eventos no seu chatbot (por exemplo, armazenar dados de clientes/pedidos em uma tabela para consulta) ## Limitações 1. Pode haver limites de taxa aplicados pela API da Shopify. 2. Os eventos não estão vinculados a conversas.
