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

# ServiceTitan

受付担当者は、ServiceTitanで発信者を検索し、電話対応担当者が確認できるよう新しい作業を予約として送信して、既存顧客に次回の予約日時を伝えられます。ServiceTitanのAPIでは、クライアントIDとシークレットを有効期間の短いトークンと交換し、さらにアプリキーも必要ですが、Webhookツールでは対応できないため、Receptionは[Zapier](/docs/ja/reception-ai/integrations/zapier)経由で接続します。

## 始める前に

ServiceTitanのZapierインテグレーションはオープンベータ版で、ServiceTitanから現状有姿で提供されています。接続するには、次の手順に従います。

1. ServiceTitan管理者が、ServiceTitanのZapier登録フォームを送信します。その後、ServiceTitanから次の手順について連絡があります。
2. ServiceTitanで **Settings** → **Integrations** → **API Application Access** に移動し、**Connect New App** を選択して、**Zapier 3.0.X** を選びます。
3. スコープを確認し、**Booking Provider** オプションを選択して、**Allow Access** を選択します。
4. クライアントシークレットを生成し、クライアントIDおよびテナントIDとともにコピーします。

> **Warning**
>
> クライアントシークレットがあればServiceTitanのデータにアクセスできます。安全に保管し、共有しないでください。

## 設定

### Zapierを接続する

まだ接続していない場合は、Reception.aiで[Zapier](/docs/ja/reception-ai/integrations/zapier)に接続します。

### ServiceTitanアクションを追加する

[mcp.zapier.com](https://mcp.zapier.com)のZapier MCPサーバーで、**ServiceTitan (3.0.X)** アプリから[以下のアクション](#actions)を追加します。接続するには、テナントID、クライアントID、クライアントシークレットを入力し、本番環境を選択します。各フィールドには、以下の一覧に従って固定値を設定するか、AIに入力させます。

### ツールを割り当てる

Reception.aiでZapierインテグレーションの **Tools** タブを開き、**Refresh tools** を選択して、各アクションを **Client**（受付担当者）に割り当てます。

### テストする

修理を必要とする新規発信者として[受付担当者をテスト](/docs/ja/reception-ai/receptionist/testing)します。チームが確認できるよう、予約がServiceTitanに表示されます。

## アクション

### 発信者を検索する

| フィールド           | 値                                |
| --------------- | -------------------------------- |
| **Zapierアクション** | **Search Customers**             |
| **Zapierで設定**   | なし。                              |
| **AIに入力させる**    | **Phone**（発信者の電話番号）または **Name**。 |
| **割り当て先**       | **Client**                       |

### 予約を送信する

新しい作業を送信するには、予約を使うのが最も安全です。電話対応担当者がServiceTitanで確認してジョブに変換するため、受付担当者が配車スケジュールに重複予約を入れることはありません。

| フィールド           | 値                                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Zapierアクション** | **Create Booking**                                                                                                 |
| **Zapierで設定**   | **Booking Provider**、**Source**（例：`Reception`）、必要に応じて **Business Unit**、**Job Type**、**Campaign**。                 |
| **AIに入力させる**    | **Name**、**Summary**（問題、発信者の電話番号、対応可能な日時）、**Is First Time Client**、サービス提供先の住所、**Start**（発信者の希望日時）、**External Id**。 |
| **割り当て先**       | **Client**                                                                                                         |

**External Id** は予約ごとに一意である必要があります。発信者の電話番号の後に現在の日付と時刻を付けるよう受付担当者に指示する[手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加してください。

### 顧客の予約を確認する

| フィールド           | 値                                           |
| --------------- | ------------------------------------------- |
| **Zapierアクション** | **Search Appointments**                     |
| **Zapierで設定**   | なし。                                         |
| **AIに入力させる**    | **Search Customers** で取得した **Customer Id**。 |
| **割り当て先**       | **Client**                                  |

## 制限事項

* ZapierのServiceTitanアプリでは、受け入れ可能件数や技術者の空き状況を確認できないため、予約に設定された時刻は発信者の希望であり、確定枠ではありません。
* **Create Job** と **Create Appointment** には、場所、事業部門、ジョブタイプ、キャンペーンのIDが必要で、スケジュールに直接予約されます。これらは電話対応担当者に任せてください。
* このインテグレーションはオープンベータ版であり、ServiceTitanによる正式なサポートはありません。
* 受付担当者が実行する各アクションは、Zapierプランのタスクを消費します。現在Zapierでは、成功した呼び出し1回につき2タスクとしてカウントされます。失敗した呼び出しはカウントされません。プランの上限に達すると、リセットされるまでアクションは停止します。

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

| 問題                                    | 確認事項                                                              |
| ------------------------------------- | ----------------------------------------------------------------- |
| ServiceTitanアクションがReception.aiに表示されない | Zapierでアクションを追加した後、Zapierインテグレーションで **Refresh tools** を選択します。     |
| アクションに **Changed** と表示され、使用されない       | Zapierでアクションを編集しています。**Tools** タブで **Update** を選択します。             |
| ZapierがServiceTitanに接続できない            | 登録が承認されていることと、古いAPIキーではなく3.0.XのクライアントIDとシークレットを使用していることを確認してください。 |
| 予約で `UniqueConstraint` エラーが発生する       | **External Id** が以前の予約と重複しています。日付と時刻が含まれていることを確認してください。           |
| 登録済みの顧客が見つからない                        | 発信者の電話番号だけでなく、名前でも検索してみてください。                                     |