# Shopify

> Saiba como implementar o seu próprio bot da Shopify para ajudar os clientes da sua loja e cuidar das vendas
>
> - **Canonical URL:** https://www.builderbot.app/pt/plugins/shopify
> - **Documentation Index:** https://www.builderbot.app/llms.txt
> - **Full Corpus:** https://www.builderbot.app/llms-full.txt

> **NOTE:**
> Se precisar de Ajuda para gerar sua chave de API da Shopify, visite estes recursos [Shopify Api Key](https://www.shopify.com/partners/blog/17056443-how-to-generate-a-shopify-api-token)

Para integrar o plugin em seus outros fluxos, você precisa instalar a biblioteca:

## Install

```bash (npm)
    npm install @builderbot-plugins/shopify
```

```typescript
    import 'dotenv/config'
    import { createBot, MemoryDB, createProvider, createFlow } from '@builderbot/bot'
    import { createShopifyFlow } from '@builderbot-plugins/shopify'
    import BaileysProvider from "@builderbot/provider/baileys";

    const main = async () => {

        const provider = createProvider(BaileysProvider)

        const { flow } = await createShopifyFlow({
            modelName: 'gpt-3.5-turbo-16k',
            openApiKey: "YOUR_OPEN_API_KEY_HERE",
            shopifyApiKey: "YOUR_SHOPIFY_API_KEY_HERE",
            shopifyDomain: "YOUR_SHOPIFY_DOMAIN_HERE"
        })

        await createBot({
            database: new MemoryDB(),
            provider,
            flow: createFlow(flow)
        })

    }

    main()
```

## SmartFlows

Ok, um smartflow nada mais é do que um fluxo como sabemos, É só que este tem algo que o torna especial!

Esse algo é a capacidade de se comunicar com a IA para entender o que o usuário está tentando nos dizer.

Para adicionar um smartflow, siga o código que mostro abaixo

```ts

    /* stuff code */

    const byeFlow = addKeyword('bye').addAnswer('bye, i hope see you soon');

    const smartFlowBye = {
        name: 'BYE_FLOW',
        description: [
            "I'm an expert in goodbyes,",
            "I'm the right person to respond when the user says bye or is saying goodbye."
        ].join(' '),
        flow: byeFlow
    }

    const extra = { 
        flows: [smartFlowBye]
    }

    const { flow } = await createShopifyFlow({
        modelName: 'gpt-3.5-turbo-16k',
        openApiKey: "YOUR_OPEN_API_KEY_HERE",
        shopifyApiKey: "YOUR_SHOPIFY_API_KEY_HERE",
        shopifyDomain: "YOUR_SHOPIFY_DOMAIN_HERE",
    }, extra)

    await createBot({
        database: new MemoryDB(),
        provider,
        flow: createFlow(flows)
    })

```
A resposta do bot deve ser algo assim.

![ByeFlow](https://imgur.com/eCafkEH.jpg)

## NormalFlows

Por vezes, só precisamos de um fluxo comum para dar respostas imediatas e controladas. Nesse caso, vamos simplesmente adicionar o fluxo para acionar uma ação quando o usuário disser obrigado.

```ts
    const gratefullFlow = addKeyword('/thanks/', 
    { sensitive: false, regex: true }).addAnswer("Thank you for trusting our store ❤️");

    const flows = flow.concat(gratefullFlow)

    const { flow } = await createShopifyFlow({
        modelName: 'gpt-3.5-turbo-16k',
        openApiKey: "YOUR_OPEN_API_KEY_HERE",
        shopifyApiKey: "YOUR_SHOPIFY_API_KEY_HERE",
        shopifyDomain: "YOUR_SHOPIFY_DOMAIN_HERE"
    })

    await createBot({
        database: new MemoryDB(),
        provider,
        flow: createFlow(flows)
    })
```

![normalFlow](https://imgur.com/8USmljn.jpg)

## Tests
Alguns testes realizados no plugin podem ser encontrados no seguinte link.

Os seguintes testes foram realizados em vários cenários da vida real, variando do desconhecimento à ambiguidade

- [Tests](https://docs.google.com/spreadsheets/d/12zfSJ8F1Uij-vHg3tQxbpFBIrNFbRJ5Y-i0Vw7afDlo/)

## Accuracy
__ACCURACY FROM PLUGIN__

O plugin foi submetido a vários testes de conversação, que vão desde perguntas directas a outras mais conversacionais.

aqui alguns exemplos

![pricing](https://imgur.com/Hqg2iKe.jpg)
![image](https://imgur.com/XWixElU.jpg)
![colors](https://imgur.com/wfdYgQf.jpg)

O plugin tem 97% de precisão quando a Conversa não é ambígua

O plugin tem uma precisão de 96% quando a conversa é inequívoca. Isto significa que é tão exacta como a própria pergunta.
Isto não diminui o seu potencial.

TODO:

- [ ] Melhorar a conversa história.

- [ ] Gerenciar pergunta ambígua no mesmo fluxo.

- [ ] Melhorar trigueros resposta por agentes.

- [ ] Linguagem dinâmica falada pelo utilizador.

## References
__REFERENCE:__\
[Shopify pluggin](https://github.com/codigoencasa/bot-plugins/tree/feature/shopify/packages/shopify)\
[Telegram provider](https://github.com/codigoencasa/bot-plugins/tree/feature/shopify/packages/telegram)
