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

# Shopmonkey

[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使うと、通話相手が車の持ち込みを希望した際に、ReceptionがShopmonkeyのカレンダーへ予約を追加できます。

> **Warning**
>
> この方法で予約を作成しても、Shopmonkeyは予約の重複を確認しないため、Receptionが
> 同じ時間枠に重複予約を入れる可能性があります。その時刻は店舗で確認後に確定するリクエストであることを通話相手に伝えるか、
> 営業時間と作業ベイの上限をReceptionの指示に追加してください。

## セットアップ

### APIキーを作成する

Shopmonkeyで、管理者が **Settings** → **Integration** → **API Keys** を開き、**Get Started** または **Add New Key** を選択します。**Create API Key** を選択し、すぐにキーをコピーしてください。Shopmonkeyでキーが表示されるのは一度だけです。キーには、作成したユーザーと同じ権限が付与されます。

### Webhookツールを作成する

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

| フィールド            | 値                                                                                                                                                                                                                                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名前**           | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                            |
| **説明**           | 「通話相手が日付と時刻を選んだら、店舗のカレンダーに予約を追加します。最初に時刻を確認してください。」                                                                                                                                                                                                                                                        |
| **メソッド**         | POST                                                                                                                                                                                                                                                                                                       |
| **URL**          | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                              |
| **リクエストヘッダー**    | `Authorization`：`Bearer `の後にAPIキー                                                                                                                                                                                                                                                                          |
| **ボディパラメーター**    | `name`（文字列、必須）：「サービス内容と通話相手の名前。例：オイル交換 - Jane Doe。」  `startDate`（文字列、必須）：「UTCでの開始時刻をISO 8601形式で指定。例：2026-11-04T15:00:00.000Z。」  `endDate`（文字列、必須）：「同じ形式で終了時刻を指定。通話相手が希望するサービスにそれ以上の時間がかからない限り、開始時刻の1時間後にします。」  `color`（文字列、必須）：「常に正確な値 `blue` を使用します。」  `note`（文字列、必須）：「通話相手の名前、電話番号、車両の年式、メーカー、モデル、依頼内容。」 |
| **エージェントへの割り当て** | **Receptionist**                                                                                                                                                                                                                                                                                           |

**Enable** を選択します。

### テストする

オイル交換を予約して、[Receptionをテストします](/docs/ja/reception-ai/receptionist/testing)。Shopmonkeyのカレンダーに、現地時間の正しい時刻で予約が表示されることを確認してください。

`color`には、`aqua`、`black`、`blue`、`brown`、`gray`、`green`、`orange`、`purple`、`red`、`yellow`のいずれかを指定する必要があります。電話予約が目立つよう、チームが他の予約で使用していない色を選んでください。

## 制限事項

* Shopmonkeyの顧客検索では電話番号のリストを送信する必要がありますが、Webhookツールでは送信できません。そのため、Receptionは通話相手を検索したり、予約を顧客や車両の記録にリンクしたりできません。代わりに、通話相手の詳細はメモに保存されます。
* このツールでは、予約日時の変更やキャンセルはできません。これらにはURL内の予約IDが必要です。

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

| 問題                   | 確認事項                                                           |
| -------------------- | -------------------------------------------------------------- |
| Shopmonkeyから401が返される | ヘッダーは`Bearer `の後に有効なキーを続ける必要があります。`Bearer`の後にはスペースを入れてください。    |
| 予約時刻が正しくない           | 時刻はUTCで指定する必要があります。正しく変換できるよう、Receptionの指示に店舗のタイムゾーンを追加してください。 |
| `color`に関する400が返される  | Shopmonkeyの色名のいずれかを小文字で使用してください。                               |
| 予約に顧客情報が含まれていない      | 最初に通話相手の名前、電話番号、車両情報を収集するよう、説明でReceptionに指示してください。             |