---
title: "Crie um agente de IA para Shopify para seus lojistas"
description: "Crie um agente de IA para Shopify que lê os pedidos e o estoque de cada lojista e adiciona tags aos pedidos revisados, com o AIsa Connect cuidando de cada loja."
canonical: "https://aisa.one/pt-br/solutions/shopify-ai-agent"
---

# Crie um agente de IA para Shopify que trabalha na loja de cada lojista

> Crie um agente de IA para Shopify que lê os pedidos e o estoque de cada lojista e adiciona tags aos pedidos revisados, com o AIsa Connect cuidando de cada loja.

Os lojistas conectam a loja com um token da Admin API, seu agente lê os pedidos não enviados e o estoque, adiciona tags aos pedidos que revisou, e a AIsa mantém separada a Connection de cada loja.

- Página web: https://aisa.one/pt-br/solutions/shopify-ai-agent
- Para quem é: Criadores de agentes e Vendedores cross-border
- Domínio de dados: AIsa Connect
- Roda no AIsa Connect: [AIsa Connect](https://aisa.one/pt-br/products/connect)

## Quatro requisições da loja conectada aos pedidos com tag

Cada etapa é uma requisição do seu servidor para a loja fictícia store_8812, com nomes de campo do schema publicado de cada ação.

### 1. O lojista conecta a loja

Colete no seu produto o token da Admin API e o domínio myshopify.com da loja e repasse uma vez. A AIsa confere os campos, o Shopify valida o token e a Connection fica vinculada ao externalUserId desse lojista.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/connect/shopify/credentials" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "store_8812",
    "apiKey": "shpat_...",
    "credentials": {
      "shopDomain": "acme.myshopify.com"
    }
  }'
```

### 2. Leia os pedidos que precisam de atenção

shopify.list_orders recebe uma consulta de busca do Shopify, como pedidos não enviados, e retorna o número, o status de envio, o total e o cliente de cada pedido.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "first": 50,
      "query": "fulfillment_status:unfulfilled"
    }
  }'
```

### 3. Confira o estoque antes de prometer uma data

shopify.get_inventory_quantities retorna a quantidade disponível de um item em um local, para que seu agente diferencie um pedido atrasado de um sem estoque.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.get_inventory_quantities",
    "externalUserId": "store_8812",
    "input": {
      "inventoryItemId": "gid://shopify/InventoryItem/4410283321",
      "locationId": "gid://shopify/Location/7731205",
      "names": [
        "available"
      ]
    }
  }'
```

### 4. Adicione tags aos pedidos que seu agente revisou

shopify.add_tags grava na loja, então peça autorização ao lojista antes de executá-la. A AIsa envia uma vez e, se o resultado for desconhecido, confira o pedido no Shopify antes de executar de novo.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.add_tags",
    "externalUserId": "store_8812",
    "input": {
      "id": "gid://shopify/Order/5829113872",
      "tags": [
        "agent-reviewed"
      ]
    }
  }'
```

## Deixe seu agente de código criar

Cole isto no Claude Code, no Codex ou no Cursor dentro do repositório do seu produto, e guarde sua chave da AIsa no ambiente do servidor.

```text
Adicione um agente de Shopify a este app com o AIsa Connect (https://aisa.one/docs/resources/aisa-connect).

Leia o guia primeiro. Chame a AIsa só pelo servidor com AISA_API_KEY do ambiente e nunca envie a chave para o navegador.

1. Adicione um formulário de configurações em que o lojista informe o token da Admin API do Shopify e o domínio myshopify.com. Repasse os dois para POST /connect/shopify/credentials com o ID do lojista como externalUserId, explique qualquer erro 400 em palavras simples e não guarde o token.
2. Adicione uma tarefa que execute shopify.list_orders com a consulta fulfillment_status:unfulfilled para um lojista e liste os pedidos.
3. Confira o estoque dos itens de cada pedido com shopify.get_inventory_quantities.
4. Peça ao lojista que aprove uma lista antes de qualquer execução de shopify.add_tags. Trate outcome_unknown como desconhecido e confira o pedido antes de tentar de novo.

Leia o inputSchema de cada ação em GET /apps/shopify/actions antes de escrever as chamadas e me mostre o plano antes de escrever código.
```

Seu agente de código mostra um plano antes de escrever código. Teste com uma loja de desenvolvimento antes que um lojista conecte a dele.

## Perguntas sobre como criar um agente de IA para Shopify

### O que é um agente de IA para Shopify?

Um agente de IA para Shopify é um software que lê e age na loja de um lojista por ele, por exemplo para listar pedidos não enviados, conferir o estoque ou adicionar tags a pedidos. Com o AIsa Connect, cada lojista conecta a própria loja e seu agente executa ações do Shopify só para esse lojista.

### Preciso publicar um app do Shopify?

Não, se você usar o token. Cada lojista cria um token de acesso da Admin API na própria loja e informa no seu produto, e a AIsa faz as chamadas com ele.

### Como o lojista conecta a loja?

Ele informa no seu produto o token de acesso da Admin API, que começa com shpat_, e o domínio myshopify.com da loja. Você repassa os dois uma vez: um campo faltando retorna invalid_request e um token recusado retorna connect_failed.

### Quais ações do Shopify meu agente pode executar?

Perto de 100, entre pedidos, produtos, estoque, clientes, pedidos em rascunho e envios. Cada ação publica o schema de entrada e informa se lê, grava ou exclui dados.

### O agente pode alterar pedidos ou produtos?

Sim. Ações como shopify.add_tags e shopify.update_product gravam na loja, então peça autorização ao lojista antes de executá-las. A AIsa nunca tenta uma execução de novo por conta própria.

### Quanto custa executar um agente de Shopify?

Cada execução bem-sucedida custa US$0.0003 em todos os planos, e execuções com falha são grátis. Conectar uma loja e gerenciar Connections não custa nada.

## Tarefas relacionadas

- [Crie um agente de IA de atendimento ao cliente](https://aisa.one/pt-br/solutions/ai-customer-support-agent.md): Leia as dúvidas sobre pedidos no Gmail do lojista, busque cada pedido na loja e redija a resposta para uma pessoa enviar. Para Criadores de agentes e Equipes corporativas
- [Automatize relatórios de e-commerce](https://aisa.one/pt-br/solutions/ecommerce-reporting.md): Reúna toda semana os pedidos e as campanhas de e-mail de cada lojista e grave o relatório no Notion dele. Para Criadores de agentes e Agências de marketing
