> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# BigCommerce

受付は、発信者の注文をBigCommerceストアで検索し、その状況を案内できます。[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)は、BigCommerce Orders APIを通じて顧客のメールアドレスから注文を検索します。

> **Warning**
>
> 注文には、顧客の氏名、住所、電話番号、購入内容が含まれます。情報を共有する前に、
> 発信者がその顧客本人であることを受付が確認する必要があります。以下のツール説明では、
> 注文番号と注文時のメールアドレスの両方を尋ね、両方が一致した場合にのみ
> 注文について案内するよう設定します。

## はじめる前に

### 読み取り専用APIアカウントを作成する

BigCommerceのコントロールパネルで、**Settings** → **Store-level API accounts** を開き、APIアカウントを作成します。「Reception」などの名前を付け、**Orders** スコープを **read-only** に設定し、それ以外のすべてのスコープを **None** に設定します。スコープは後から変更できません。

### 認証情報をコピーする

アカウントを保存し、**Access token** と **API path** をコピーします。APIパスは `https://api.bigcommerce.com/stores/STORE_HASH/v3/` のような形式で、`/stores/` の後の部分がストアハッシュです。アクセストークンは秘密情報として管理してください。

## Webhookツールを作成する

**Integrations** に移動して **Add integration** を選択し、**Webhook Tool** を選びます。

| フィールド                | 値                                                                                                                                                           |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_bigcommerce_order`                                                                                                                                    |
| **Description**      | 「発信者が注文について尋ねたときに、その注文を検索する。まず注文番号と注文時のメールアドレスを尋ね、メールアドレスは一文字ずつ言ってもらう。注文のidと請求先メールアドレスの両方が発信者の回答と一致する場合にのみ、注文の詳細を共有する。一致しない場合は、注文が見つからないことを伝え、折り返し連絡を提案する。」 |
| **Method**           | GET                                                                                                                                                         |
| **URL**              | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                                                                   |
| **Request Headers**  | `X-Auth-Token`：アクセストークン  `Accept`：`application/json`                                                                                                        |
| **Query Parameters** | `email`（文字列、必須）：「発信者が伝えたメールアドレス。」  `sort`（文字列、必須）：「常に正確な値 `date_created:desc`。」  `limit`（数値、必須）：「常に正確な値 `5`。」                                               |
| **Assign to agents** | **Receptionist**                                                                                                                                            |

`sort` と `limit` の値により、古い注文ではなく、顧客の最新の注文から順に返されます。

**Enable** を選択し、テスト注文を使って[受付をテスト](/docs/ja/reception-ai/receptionist/testing)します。正しい注文番号とメールアドレスで注文について尋ねた後、間違ったメールアドレスでも尋ね、2回目の通話では詳細が案内されないことを確認してください。

> **Tip**
>
> レスポンスには、各注文の請求先住所と支払い情報が含まれます。受付が電話で共有してよい情報について、
> [ルールまたは手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加してください。
> たとえば、注文状況と注文日のみを共有するよう設定できます。

## トラブルシューティング

| 問題                 | 確認事項                                                                    |
| ------------------ | ----------------------------------------------------------------------- |
| BigCommerceが401を返す | ヘッダー名は `X-Auth-Token` とし、クライアントIDやクライアントシークレットではなくアクセストークンを指定する必要があります。 |
| BigCommerceが403を返す | APIアカウントに **Orders** の読み取り専用スコープがありません。このスコープを設定した新しいアカウントを作成してください。    |
| BigCommerceが404を返す | URL内のストアハッシュと、URLに `/v2/orders` が使用されていることを確認してください。                    |
| レスポンスが空になる         | そのメールアドレスに該当する注文がありません。発信者が購入時に使用したメールアドレスを伝えたか確認してください。                |