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

# ServiceM8

以下の[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使うと、発信者が作業を依頼した際に、受付担当者がServiceM8で見積もりやジョブを作成し、新しい発信者を顧客として追加できます。

## 始める前に

ServiceM8で **Settings** → **API Keys** を開き、キーを作成します。以下のすべてのツールは、`X-Api-Key` リクエストヘッダーでこのキーを送信します。キーを持つ人は誰でもServiceM8のデータを読み取り、変更できるため、共有ドキュメントには記載しないでください。

## ツールを作成する

各ツールについて、**Integrations** に移動し、**Add integration**、**Webhook Tool** の順に選択して、**Assign to agents** を **Receptionist** に設定します。

### ジョブを作成する

| フィールド         | 値                                                                                                                                                          |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名前**        | `create_servicem8_job`                                                                                                                                     |
| **説明**        | 「発信者が作業を依頼した場合や見積もりを希望した場合に、ジョブを作成する。」                                                                                                                     |
| **メソッド**      | POST                                                                                                                                                       |
| **URL**       | `https://api.servicem8.com/api_1.0/job.json`                                                                                                               |
| **リクエストヘッダー** | `X-Api-Key`：APIキー                                                                                                                                          |
| **本文パラメーター**  | `status`（文字列、必須）：「常に正確な値 `Quote` を使用する。」  `job_address`（文字列、必須）：「郵便番号を含む、作業が必要な場所の完全な住所。」  `job_description`（文字列、必須）：「発信者の名前と電話番号に続けて、必要な作業と伝えられた詳細を記載する。」 |

通話から直接作業を予定に入れる場合は、`Quote` の代わりに `Work Order` を使用します。

### 新しい顧客を追加する

| フィールド         | 値                                                              |
| ------------- | -------------------------------------------------------------- |
| **名前**        | `create_servicem8_client`                                      |
| **説明**        | 「これまで利用したことがないと発信者が伝えた場合、新しい顧客として追加する。」                        |
| **メソッド**      | POST                                                           |
| **URL**       | `https://api.servicem8.com/api_1.0/company.json`               |
| **リクエストヘッダー** | `X-Api-Key`：APIキー                                              |
| **本文パラメーター**  | `name`（文字列、必須）：「発信者の氏名または会社名。」  `address`（文字列）：「郵便番号を含む顧客の住所。」 |

各ツールで **Enable** を選択し、見積もりを依頼して[受付担当者をテスト](/docs/ja/reception-ai/receptionist/testing)します。新しい見積もりがServiceM8に表示されます。

## 制限事項

* ServiceM8が両方のツールに返すのは `OK` のみです。新しいレコードのIDは、受付担当者が読み取れないレスポンスヘッダーに含まれるため、ジョブを顧客にリンクできません。チームがServiceM8でリンクする必要があります。
* ServiceM8では、電話番号とメールアドレスは顧客の連絡先という別レコードに保存されますが、顧客ツールでは作成できません。代わりに、発信者の電話番号はジョブの説明に保存されます。
* 既存の顧客を検索するには `$filter` パラメーターが必要ですが、Webhookツールのパラメーター名には `$` を使用できないため、受付担当者は発信者を検索できません。

顧客とジョブをリンクして作成するには、[Zapier](/docs/ja/reception-ai/integrations/zapier)経由でServiceM8の **Create Client** アクションと **Create Job** アクションを使用します。

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

| 問題                  | 確認事項                                                                             |
| ------------------- | -------------------------------------------------------------------------------- |
| ServiceM8から401が返される | ヘッダー名が `X-Api-Key` で、有効なキーが設定されている必要があります。                                       |
| statusに関する400エラー    | `status` は `Quote`、`Work Order`、`Unsuccessful`、`Completed` のいずれかと完全に一致する必要があります。 |
| ジョブに住所がない           | ジョブを作成する前に完全な住所を尋ねるよう、受付担当者への説明に記載してください。                                        |
| ServiceM8から429が返される | ServiceM8のリクエスト上限に達しています。1分待ってからもう一度お試しください。                                     |