> ## 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.

# Como usar a Shopify nas suas conversas

> Siga estes passos para usar a Shopify nas suas conversas.

<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 conectar sua conta Shopify à Treble usando os passos do guia [Configurar a integração com a Shopify](/pt/docs/main-platform/ai-center/agents/reasoning-agent/shopify-install)

## Como usar a Shopify nas suas conversas

1. Acesse a página "AI Center" ou [esta URL](https://app.treble.ai/en/dashboard/ai-center)
2. Clique no botão "Create AI Agent"
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-24.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=929aa7dd1da35210ce4556beec819ad2" alt="ID da loja Shopify" width="1326" height="994" data-path="images/shopify-setup-en-24.png" />
3. Procure a opção "Automate complex tasks" e clique nela
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-25.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=e3e9da08ae3afd7c834dab3ea1a0cb5f" alt="ID da loja Shopify" width="2096" height="1670" data-path="images/shopify-setup-en-25.png" />
4. Dê um nome ao agente e clique no botão "Create"
5. Nesta tela você poderá escrever as instruções para o seu agente de IA
6. Procure a seção "Advanced" e clique no botão "Connected Apps" na parte inferior da tela
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-26.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=c8e6e4671a67da2c4bd33f1d026b6905" alt="ID da loja Shopify" width="1746" height="964" data-path="images/shopify-setup-en-26.png" />
7. Procure o app "Shopify" na lista de apps instalados e clique nele
   <img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-27.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=f2ebd48faa24ba3387e51b71971c9582" alt="ID da loja Shopify" width="2026" height="1528" data-path="images/shopify-setup-en-27.png" />

#### As ferramentas disponíveis são:

* List Accounting Invoices
* Get Accounting Invoice
* Create Accounting Invoice
* Update Accounting Invoice
* List Accounting Contacts
* Get Accounting Contact
* Get Accounting Salesorder
* Create Accounting Salesorder
* List Accounting Salesorders

Selecione qualquer uma das ferramentas e, ao clicar, você verá o terceiro menu suspenso "Parameters" mudar.

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

O menu "Parameters" mostrará os parâmetros da ferramenta; você precisará preenchê-los antes que a ferramenta possa ser usada.

*Algumas ferramentas pedirão que você edite parâmetros. Se não tiver certeza do que alterar, deixe a IA cuidar de todos.*

Alterar parâmetros só é útil se você precisar enviar manualmente um valor fixo para a IA, como uma descrição fixa, fuso horário, moeda ou outro valor específico.

<img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-29.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=3ab9e95830eba9b9a459f8406a49ffa2" alt="ID da loja Shopify" width="1712" height="1226" data-path="images/shopify-setup-en-29.png" />

Isso substituirá o valor que a IA tenta gerar; recomenda-se deixar a IA cuidar disso, a menos que você saiba o valor exato que procura. Você sempre pode atualizar isso se notar algum problema ou mudar de ideia.

Se deixar a IA cuidar de todos os parâmetros, você pode pular o passo 3; caso contrário, insira no passo 3 os valores fixos que deseja usar.

<img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-30.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=4405f3b04b033e685b6afae3542331ab" alt="ID da loja Shopify" width="1710" height="1118" data-path="images/shopify-setup-en-30.png" />

Ao clicar em "Save", você verá a ação configurada no editor do seu agente de IA; já pode usá-la nas suas conversas.

<img src="https://mintcdn.com/trebleai/xe7HJ38y3aI16Euq/images/shopify-setup-en-31.png?fit=max&auto=format&n=xe7HJ38y3aI16Euq&q=85&s=582cdfb76bd2e9ea1e431a7480dd6e2d" alt="ID da loja Shopify" width="1250" height="1060" data-path="images/shopify-setup-en-31.png" />

## Ferramentas Shopify disponíveis

Para referência, estas são as ferramentas Shopify que você pode usar no agente Automate complex tasks:

| Ação                         | Descrição                                             | Útil para                                                                                      |
| ---------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| List Accounting Invoices     | Busca uma lista de faturas no sistema contábil        | Mostrar histórico de faturas, sincronizar dados, painéis, filtrar por status (pago, em aberto) |
| Get Accounting Invoice       | Recupera uma única fatura pelo ID                     | Exibir detalhes completos da fatura, validar status de pagamento, anexar a interações          |
| Create Accounting Invoice    | Cria uma nova fatura no sistema contábil              | Gerar faturas após a compra, automatizar faturamento, sincronizar pedidos com a contabilidade  |
| Update Accounting Invoice    | Modifica uma fatura existente                         | Marcar como pago, atualizar itens, corrigir valores, sincronizar mudanças de status            |
| List Accounting Contacts     | Retorna uma lista de contatos (clientes/fornecedores) | Sincronizar bases de clientes, associar usuários a registros contábeis                         |
| Get Accounting Contact       | Busca um único contato pelo ID                        | Recuperar dados de cobrança, validar informações do cliente, vincular a faturas/pedidos        |
| Get Accounting Salesorder    | Recupera um pedido de venda específico                | Conferir detalhes do pedido, validar status de fulfillment                                     |
| Create Accounting Salesorder | Cria um novo pedido de venda                          | Enviar pedidos para a contabilidade antes da faturamento, fluxos B2B                           |
| List Accounting Salesorders  | Busca uma lista de pedidos de venda                   | Relatórios, sincronizar pipelines de pedidos, conciliar pedidos e faturas                      |
