---
title: "Crie um agente de IA de atendimento que consulta pedidos"
description: "Crie um agente de IA de atendimento ao cliente que lê dúvidas sobre pedidos no Gmail, busca cada pedido no Shopify ou no WooCommerce e redige a resposta."
canonical: "https://aisa.one/pt-br/solutions/ai-customer-support-agent"
---

# Crie um agente de suporte que responde aos e-mails de onde está meu pedido

> Crie um agente de IA de atendimento ao cliente que lê dúvidas sobre pedidos no Gmail, busca cada pedido no Shopify ou no WooCommerce e redige a resposta.

Os lojistas conectam o Gmail e a loja uma vez, seu agente encontra as dúvidas sobre pedidos na caixa de entrada, busca cada pedido no Shopify ou no WooCommerce e redige a resposta para uma pessoa enviar.

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

## Quatro requisições da caixa de entrada à resposta redigida

Cada requisição sai do seu servidor para um lojista, então o Gmail, o Shopify e o WooCommerce respondem só com os dados desse lojista.

### 1. O lojista conecta o Gmail

Crie uma sessão de conexão para o lojista e abra o connectUrl dela. A tela de consentimento do Google abre a partir da página hospedada pela AIsa, e você consulta a sessão até ela terminar. A loja se conecta com credenciais, como na página do agente de Shopify.

```
curl "https://api.aisa.one/apis/v1/connector/connect/gmail?externalUserId=store_8812" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### 2. Encontre as dúvidas sobre pedidos na caixa

gmail.search_threads recebe uma consulta de busca do Gmail e retorna as conversas correspondentes. Depois, gmail.fetch_message_by_thread_id lê a conversa inteira.

```
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": "gmail.search_threads",
    "externalUserId": "store_8812",
    "input": {
      "query": "newer_than:1d (order OR delivery OR refund)",
      "maxResults": 20
    }
  }'
```

### 3. Busque o pedido na loja

Pesquise pelo e-mail do remetente: shopify.list_orders recebe uma consulta email: e woocommerce.list_orders recebe um termo de busca.

Shopify:

```
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": 5,
      "query": "email:jane@example.com"
    }
  }'
```

WooCommerce:

```
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": "woocommerce.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "search": "jane@example.com",
      "perPage": 5
    }
  }'
```

### 4. Registre a resposta no pedido

Seu agente redige a resposta no seu produto para uma pessoa enviar. Em seguida, woocommerce.add_order_note deixa uma nota privada no pedido, uma gravação que o lojista aprova antes.

```
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": "woocommerce.add_order_note",
    "externalUserId": "store_8812",
    "input": {
      "orderId": 1043,
      "note": "Customer asked where the order is. Reply drafted with the tracking link.",
      "customerNote": false
    }
  }'
```

## Deixe seu agente de código criar

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

```text
Adicione consultas de pedidos à nossa caixa de suporte 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.

1. Deixe o lojista conectar o Gmail: chame GET /connect/gmail com o ID dele como externalUserId, abra o connectUrl completo e consulte a sessão de conexão até ela terminar.
2. Deixe o lojista conectar o Shopify (POST /connect/shopify/credentials) ou o WooCommerce (POST /connect/woocommerce/credentials) com os campos que cada app pede.
3. A cada 15 minutos, execute gmail.search_threads para encontrar novas dúvidas sobre pedidos e leia cada conversa com gmail.fetch_message_by_thread_id.
4. Busque os pedidos do remetente com shopify.list_orders (uma consulta email:) ou woocommerce.list_orders (search).
5. Redija no nosso app uma resposta com o status do pedido para um atendente revisar e enviar. Não envie e-mails.

Leia o inputSchema de cada ação antes de escrever as chamadas e me mostre o plano primeiro.
```

Seu agente de código mostra um plano antes de escrever código. O Gmail se conecta com acesso de leitura, então as respostas saem do seu produto ou do cliente de e-mail do lojista.

## Perguntas sobre como criar um agente de IA de atendimento ao cliente

### O que faz um agente de IA de atendimento ao cliente?

Um agente de IA de atendimento ao cliente lê as mensagens que chegam dos clientes, busca nos seus sistemas as informações de que precisa e redige ou envia uma resposta. Com o AIsa Connect, ele lê o Gmail do lojista e busca pedidos na loja Shopify ou WooCommerce dele.

### Ele responde perguntas do tipo onde está meu pedido?

Sim. Ele relaciona o e-mail do remetente aos pedidos e lê o status de envio de cada um, para que o rascunho diga se o pedido está aguardando envio, enviado em parte ou enviado.

### O agente pode enviar a resposta pelo Gmail?

Ainda não. O Gmail se conecta com acesso de leitura, então o agente redige a resposta no seu produto e uma pessoa envia por lá ou pelo Gmail.

### Quais caixas de entrada e lojas o lojista pode conectar?

Gmail para a caixa de entrada, e Shopify ou WooCommerce para os pedidos, todos verificados em produção. A aba Conectores mostra outros apps de suporte e de lojas com suas ações.

### O agente de um lojista pode ver os e-mails de outro?

Não. Cada Connection pertence a um externalUserId, o ID do lojista no seu sistema, e uma execução usa apenas as Connections desse lojista.

### Quanto custa executar um agente de suporte?

Cada execução bem-sucedida custa US$0.0003, então buscar na caixa, ler uma conversa e consultar um pedido custa cerca de US$0.0009 por dúvida. Conectar contas é grátis.

## Tarefas relacionadas

- [Crie um agente de IA para Shopify](https://aisa.one/pt-br/solutions/shopify-ai-agent.md): Os lojistas conectam a loja uma vez, e seu agente lê pedidos e estoque e adiciona tags a pedidos pelo AIsa Connect. Para Criadores de agentes e Vendedores cross-border
- [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
