---
title: "注文を調べる AI カスタマーサポートエージェントを作る"
description: "Gmail の注文に関する問い合わせを読み、Shopify や WooCommerce で注文を調べて返信の下書きを作る AI カスタマーサポートエージェントを、AIsa Connect で作れます。"
canonical: "https://aisa.one/ja/solutions/ai-customer-support-agent"
---

# 「注文はどこ？」メールに答えるサポートエージェントを作る

> Gmail の注文に関する問い合わせを読み、Shopify や WooCommerce で注文を調べて返信の下書きを作る AI カスタマーサポートエージェントを、AIsa Connect で作れます。

店舗が Gmail とストアを一度接続すると、エージェントが受信トレイで注文の問い合わせを見つけ、Shopify や WooCommerce で各注文を調べます。返信は下書きにして担当者が送ります。

- ウェブページ：https://aisa.one/ja/solutions/ai-customer-support-agent
- 向いているチーム：エージェント開発者、エンタープライズチーム
- データ領域：AIsa Connect
- AIsa Connect で動作：[AIsa Connect](https://aisa.one/ja/products/connect)

## 受信トレイから返信の下書きまで 4 つのリクエスト

各リクエストはサーバーから 1 つの店舗のために送られるため、Gmail、Shopify、WooCommerce はその店舗のデータだけを返します。

### 1. 店舗が Gmail を接続

店舗の接続セッションを作成して connectUrl を開きます。Google の同意画面は AIsa のホスト型ページから表示され、完了するまでセッションをポーリングします。ストアは Shopify エージェントのページと同じく認証情報で接続します。

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

### 2. 受信トレイで注文の問い合わせを探す

gmail.search_threads は Gmail の検索クエリを受け取り、一致するスレッドを返します。続いて gmail.fetch_message_by_thread_id で会話全体を読み取ります。

```
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. ストアで注文を調べる

送信者のメールアドレスで検索します。shopify.list_orders は email: クエリを、woocommerce.list_orders は検索語を受け取ります。

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. 対応内容を注文に記録

エージェントはプロダクト内で返信の下書きを作り、担当者が送ります。その後 woocommerce.add_order_note で注文に非公開のメモを残します。これは書き込みなので、店舗が先に承認します。

```
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
    }
  }'
```

## コーディングエージェントに作らせる

ヘルプデスクのリポジトリで Claude Code、Codex、Cursor にこのプロンプトを貼り付けてください。AIsa キーはサーバーの環境変数に置きます。

```text
AIsa Connect（https://aisa.one/docs/resources/aisa-connect）を使って、サポートの受信トレイに注文の照会を追加してください。

まずガイドを読んでください。AIsa はサーバーからだけ呼び出し、AISA_API_KEY は環境変数から読み込みます。

1. 店舗が Gmail を接続できるようにします。店舗の ID を externalUserId として GET /connect/gmail を呼び出し、connectUrl を省略せずに開き、完了するまで接続セッションをポーリングします。
2. 各アプリが求める項目で、Shopify（POST /connect/shopify/credentials）または WooCommerce（POST /connect/woocommerce/credentials）を接続できるようにします。
3. 15 分ごとに gmail.search_threads で新しい注文の問い合わせを探し、各スレッドを gmail.fetch_message_by_thread_id で読み取ります。
4. shopify.list_orders（email: クエリ）または woocommerce.list_orders（search）で送信者の注文を調べます。
5. 注文状況を含む返信の下書きをアプリ内に作り、サポート担当者が確認して送ります。メールは送信しないでください。

呼び出しを書く前に各アクションの inputSchema を読み、先に計画を見せてください。
```

コーディングエージェントはコードを書く前に計画を示します。Gmail は読み取り権限で接続するため、返信はプロダクトか店舗のメールソフトから送ります。

## AI カスタマーサポートエージェントの開発についてのよくある質問

### AI カスタマーサポートエージェントは何をしますか？

AI カスタマーサポートエージェントは、顧客から届いたメッセージを読み、必要な情報をシステムで調べて、返信を下書きまたは送信します。AIsa Connect で作る場合は、店舗の Gmail を読み、その店舗の Shopify や WooCommerce で注文を調べます。

### 「注文はどこ？」という質問に答えられますか？

はい。送信者のメールアドレスを注文と照合し、各注文の発送状況を読み取ります。下書きでは、注文が発送待ち、一部発送済み、発送済みのどれかを伝えられます。

### エージェントは Gmail から返信を送れますか？

現時点ではできません。Gmail は読み取り権限で接続するため、エージェントはプロダクト内で返信の下書きを作り、担当者がプロダクトか Gmail から送ります。

### 店舗はどの受信トレイとストアを接続できますか？

受信トレイは Gmail、注文は Shopify または WooCommerce で、いずれも本番環境で検証済みです。コネクタのタブには、ほかのヘルプデスクやストアのアプリとアクションも掲載しています。

### ある店舗のエージェントがほかの店舗のメールを見ることはありますか？

ありません。すべての Connection はシステム内の店舗 ID である 1 つの externalUserId に属し、実行に使われるのはその店舗の Connection だけです。

### サポートエージェントの実行にはいくらかかりますか？

成功した実行は 1 回 $0.0003 です。受信トレイの検索、スレッドの読み取り、注文の照会で、問い合わせ 1 件あたり約 $0.0009 です。アカウントの接続は無料です。

## 関連タスク

- [Shopify AI エージェントを作る](https://aisa.one/ja/solutions/shopify-ai-agent.md)：店舗がストアを一度接続すれば、エージェントが AIsa Connect で注文と在庫を読み取り、注文にタグを付けます。エージェント開発者、越境 EC 事業者 向け
- [EC レポートを自動化](https://aisa.one/ja/solutions/ecommerce-reporting.md)：毎週、各店舗の注文とメールキャンペーンを取得し、レポートをその店舗の Notion に書き込みます。エージェント開発者、マーケティング代理店 向け
