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

# WooCommerce

受付担当は、WooCommerceストアで発信者の注文を検索し、注文状況を伝えられます。[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)がWooCommerce REST APIを通じてストアの注文を検索します。

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

## 始める前に

### ストアの設定を確認する

ストアではHTTPSを使用し、きれいなパーマリンクを有効にする必要があります。WordPressで **設定** → **パーマリンク** を開き、**基本** 以外のオプションを選択してください。

### 読み取り専用APIキーを作成する

WordPressで **WooCommerce** → **設定** → **高度な設定** → **REST API** を開き、**キーを追加** を選択します。「Reception」などの説明を入力してユーザーを選び、**権限** を **読み取り** に設定して、**APIキーを生成** を選択します。**コンシューマーキー** と **コンシューマーシークレット** をコピーしてください。シークレットは一度しか表示されません。

### ヘッダー値を作成する

WooCommerceでは、HTTP Basic認証でキーを認証します。パソコン上でヘッダー値を作成します。

```bash
printf 'CONSUMER_KEY:CONSUMER_SECRET' | base64
```

## Webhookツールを作成する

**インテグレーション** に移動して **インテグレーションを追加** を選択し、**Webhookツール** を選びます。

| フィールド            | 値                                                                                                                                                      |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **名前**           | `find_woocommerce_order`                                                                                                                               |
| **説明**           | 「発信者から注文について質問されたときに検索します。まず注文番号と注文時のメールアドレスを尋ね、メールアドレスは一文字ずつ確認してください。番号と請求先メールアドレスの両方が発信者の回答と一致する注文の詳細のみ共有します。一致しない場合は、注文が見つからないと伝え、折り返し連絡を提案してください。」 |
| **メソッド**         | GET                                                                                                                                                    |
| **URL**          | `https://YOUR-STORE.com/wp-json/wc/v3/orders`                                                                                                          |
| **リクエストヘッダー**    | `Authorization`を`Basic `の後にエンコード済みの値を続けた値に設定                                                                                                           |
| **クエリパラメーター**    | `search`（文字列、必須）：「発信者が伝えたメールアドレス。」  `per_page`（数値、必須）：「常に正確な値`5`。」                                                                                     |
| **エージェントへの割り当て** | **受付担当**                                                                                                                                               |

**有効化** を選択し、テスト用の注文で[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)します。正しい注文番号とメールアドレスで問い合わせた後、誤ったメールアドレスでも問い合わせ、2回目の通話では詳細が伝えられないことを確認してください。

> **Tip**
>
> レスポンスには、住所を含む各注文のすべてのフィールドが含まれます。電話で受付担当が共有できる情報について、
> [ルールまたは手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加してください。たとえば、注文状況、
> 注文日、追跡番号だけに限定します。

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

| 問題                             | 確認事項                                                                                                        |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| WooCommerceが401を返す             | ヘッダー値を再エンコードしてください。一部のホスティングサービスでは、WordPressに届く前に`Authorization`ヘッダーが削除されます。ホスティング事業者に、このヘッダーを通すよう依頼してください。 |
| 404 `rest_no_route`            | URL内のストアアドレスを確認し、パーマリンクが **基本** に設定されていないことを確認してください。                                                       |
| 既知の注文が見つからない                   | 検索では、注文に保存された請求先情報との照合が行われます。発信者が購入時に使用したメールアドレスを伝えたか確認してください。                                              |
| ファイアウォールまたはセキュリティプラグインにブロックされる | プラグインまたはホスティングサービスのファイアウォールで、`/wp-json/wc/`へのリクエストを許可してください。                                                |