> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar a integração com a Shopify

> Siga estes passos para configurar a integração com a Shopify na Treble.

<Warning>
  Esta funcionalidade está em **beta**. Por favor, solicite ao seu CSM que a ative na sua conta antes de seguir estes passos.
</Warning>

## Pré-requisitos

* Você precisa de uma conta Shopify
* Você precisa estar logado como administrador da conta Shopify
* Você precisa de uma loja Shopify

Este guia está dividido em três partes:

1. Criar um app personalizado da Shopify que permita à Treble acessar os seus dados da Shopify
2. Instalar o app personalizado da Shopify na sua loja Shopify
3. Vincular o app personalizado da Shopify à Treble

## 1. Criar um app personalizado da Shopify

1. Acesse o admin da Shopify [https://admin.shopify.com/](https://admin.shopify.com/) e, no canto inferior esquerdo da tela, clique em "Settings"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-1.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=14ce6f2aec240945e01de5ce43b89c23" alt="Página de configurações da Shopify" width="1244" height="2158" data-path="images/shopify-setup-en-1.png" />
2. Na página de configurações, clique em "Apps"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-2.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=de1fd40c7c5463cd400f5a91d6bd0143" alt="Página de apps da Shopify" width="2280" height="2118" data-path="images/shopify-setup-en-2.png" />
3. Você verá esta tela se não tiver apps criados ou instalados; se já tiver, eles também aparecerão aqui. O que nos interessa é o botão "Develop apps" no canto superior direito
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-3.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=d99c34c233cfce9905ba9b280544d05c" alt="Página de apps da Shopify" width="2344" height="1562" data-path="images/shopify-setup-en-3.png" />
4. Por causa de como a Shopify funciona, você precisará criar um app personalizado: clique no botão "Create an app" *(Observação: Isso não é o mesmo que criar apps no Shopify Dev Dashboard)*
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-4.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=d7f87c462876ebdfeac4ef8302b88b02" alt="Página de criação de app na Shopify" width="1908" height="1540" data-path="images/shopify-setup-en-4.png" />
5. No campo App name, digite "Treble" e escolha qualquer e-mail disponível da sua organização no menu suspenso
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-6.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=d92132e16310e14fbfdb88ef75eaef16" alt="Página de criação de app na Shopify" width="1666" height="1040" data-path="images/shopify-setup-en-6.png" />
6. Clique no botão "Create app"

### Depois que o app for criado, configure as credenciais

1. Clique na aba "API credentials"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-8.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=1138851db0936041f22bb64c8e49c011" alt="Página de criação de app na Shopify" width="1856" height="1236" data-path="images/shopify-setup-en-8.png" />
2. Clique em "Configure Admin API scopes"; você verá uma lista de caixas de seleção. As seguintes devem estar marcadas:
   * `read_customers`
   * `write_inventory`
   * `read_inventory`
   * `read_locations`
   * `write_orders`
   * `read_orders`
   * `write_products`
   * `read_products`
     <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-9.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=83e6703e93f3e0c66a968fee9bebd95d" alt="Página de criação de app na Shopify" width="2024" height="2258" data-path="images/shopify-setup-en-9.png" />
3. Clique em "Save"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-10.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=6ed6624f28b11ab26474f5ca42eae56d" alt="Página de criação de app na Shopify" width="1306" height="670" data-path="images/shopify-setup-en-10.png" />
4. O app personalizado foi criado 🎉

## 2. Instalar o app personalizado da Shopify na sua loja

Depois de criar o app, você precisa instalá-lo na sua loja Shopify.
Você deve ver um botão "Install app" na aba API credentials

1. Clique no botão "Install app"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-11.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=a18528f380d53b120d1a6f132bbc8bb7" alt="Página de criação de app na Shopify" width="1860" height="874" data-path="images/shopify-setup-en-11.png" />
2. No modal de confirmação, clique no botão "Install"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-12.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=397f1ce284fc40a3ceb7a77be0d17572" alt="Página de criação de app na Shopify" width="1904" height="898" data-path="images/shopify-setup-en-12.png" />
   Você confirma que o app que criamos terá acesso aos seus dados da Shopify; isso é necessário para continuar
3. Em seguida você verá esta tela com um token. É **muito importante guardá-lo em um lugar seguro, como um gerenciador de senhas**; **a Shopify só permite visualizá-lo uma vez**. Se você perdê-lo, será preciso repetir o processo desde a seção 1
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-13.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=a79abac6215a5d7fcc2faf6cdf73e32f" alt="Página de criação de app na Shopify" width="1972" height="1088" data-path="images/shopify-setup-en-13.png" />
4. **Clique em "Reveal token once" e salve-o**; você usará na seção 3

## 3. Vincular o app personalizado da Shopify à Treble

Nesta etapa você precisa de:

* O token do app Shopify da seção 2
* O ID da sua loja Shopify

Para saber o ID da sua loja Shopify, olhe a URL da loja; deve ser algo como [https://yourstore.myshopify.com](https://yourstore.myshopify.com) — a parte "yourstore" é o ID da loja
No nosso exemplo, o ID da loja é `treble-ixclr4yg`

<img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-14.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=185a69882584b557e8ad1f2bee9a7760" alt="ID da loja Shopify" width="1670" height="714" data-path="images/shopify-setup-en-14.png" />

1. Faça login na Treble [https://app.treble.ai/](https://app.treble.ai/)
2. Acesse a página "Settings"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-16.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=be3e21e41cb83e0b8937b73fb19365d4" alt="ID da loja Shopify" width="2312" height="1764" data-path="images/shopify-setup-en-16.png" />
3. Clique na aba **"Integrations"** ou nesta [URL](https://app.treble.ai/en/dashboard/settings/integrations/native-integrations)
4. Clique na subaba "Connected Apps"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-19.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=49ef04c6c15b98dd812fb4c49f5c1a3d" alt="ID da loja Shopify" width="2688" height="1106" data-path="images/shopify-setup-en-19.png" />
5. Procure o botão "Connect App" e selecione "Shopify" na lista de opções disponíveis
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-20.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=1c513cb91462c8613f21e62b2f92e884" alt="ID da loja Shopify" width="1970" height="1516" data-path="images/shopify-setup-en-20.png" />
6. Você verá um formulário em que deve informar:
   * Admin API access token: é o token que você obteve na seção 2
   * Store ID: é o ID da loja; neste exemplo é `treble-ixclr4yg`, mas você deve usar o seu
   * Quando os dois valores estiverem preenchidos, clique em "Authorize"
     <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-22.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=855336e4d550a33288263e532862d9a3" alt="ID da loja Shopify" width="1914" height="1624" data-path="images/shopify-setup-en-22.png" />
7. Se der certo, você verá a mensagem "App connected successfully" e o app Shopify na lista de apps conectados
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-23.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=074b6733e52dd69b38d3bd88f169e574" alt="ID da loja Shopify" width="2670" height="1374" data-path="images/shopify-setup-en-23.png" />