ナビゲーションにスキップ

ServiceTitan

顧客を検索し、新規予約をServiceTitanに送信して、予約日時を発信者に伝えます。

受付担当者は、ServiceTitanで発信者を検索し、電話対応担当者が確認できるよう新しい作業を予約として送信して、既存顧客に次回の予約日時を伝えられます。ServiceTitanのAPIでは、クライアントIDとシークレットを有効期間の短いトークンと交換し、さらにアプリキーも必要ですが、Webhookツールでは対応できないため、Receptionは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とともにコピーします。

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

設定

1

Zapierを接続する

まだ接続していない場合は、Reception.aiでZapierに接続します。

2

ServiceTitanアクションを追加する

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

3

ツールを割り当てる

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

4

テストする

修理を必要とする新規発信者として受付担当者をテストします。チームが確認できるよう、予約が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 は予約ごとに一意である必要があります。発信者の電話番号の後に現在の日付と時刻を付けるよう受付担当者に指示する手順を追加してください。

顧客の予約を確認する

フィールド値
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 が以前の予約と重複しています。日付と時刻が含まれていることを確認してください。
登録済みの顧客が見つからない発信者の電話番号だけでなく、名前でも検索してみてください。