連携›音声エージェントからジョブを予約する

音声エージェントからジョブを予約する

ElevenLabs Agents、Vapi、Retell 上の AI 電話エージェントが発信者を特定し、通話中のうちに訪問を予約できるようにします。

インストールするものはありません。3 つのプラットフォームはいずれも、通話向けに作られた小さく高速なツールセット — voice プロファイル — で Crisphive の MCP サーバーに接続します。

接続する前に

すべてのジョブタイプにデフォルトの所要時間を設定してください（設定 → ジョブタイプ）。エージェントには修理にどれくらいかかるかが分かりません。デフォルトのジョブタイプ “General” にはすでに設定されており、エージェントがタイプを指定しない場合に使われます。
API キーを作成します — 試すには chsk_test_…、実際の通話には chsk_live_…。必要なのは customers_view、customers_manage、job_view、job_create、job_manage だけです。

エージェントを接続する

Server URL:  https://api.crisphive.com/mcp?profile=voice
Header:      Authorization: Bearer chsk_live_…   (chsk_test_… for sandbox)

プラットフォーム	追加する場所	注意点
ElevenLabs Agents	MCP server integrations → Add Custom MCP Server。`Authorization` ヘッダーを追加し、サーバーをエージェントに紐付けます。	ツールの承認は Fine-Grained（音声ツールを自動承認）または No Approval に設定してください — “Always Ask” だと通話が一時停止します。MCP は Zero Retention や HIPAA のワークスペースでは使えません。
Vapi	Tools → Create Tool → MCP。その後、アシスタントでツールを選択します。	`?profile=voice` は外さないでください: Vapi はサーバーが提供するすべてのツールをインポートします。SSE ではなく、デフォルトの HTTP トランスポートを使ってください。
Retell	Agent → MCPs → Add MCP（URL とヘッダー）。その後、ツールを追加します。	ヘッダー認証のみです。Retell は失敗したツール呼び出しをリトライしません。

音声ツール

ツール	エージェントが使うタイミング
`phone` を指定した `listCustomers`	すべての通話の最初に: 発信者を E.164 形式（`+16135550142`）の番号で検索します。完全一致です。
`listJobTypes`	発信者の説明をジョブタイプに対応付けます。
`bookAndConfirmJobRequest`	予約本体 — 1 回の呼び出しで作成・スケジュール・確定を行います。
`listJobRequestBookingWindows`	発信者が空いている日を知りたいとき。
`getJobRequest`	予約内容を読み上げます（「予約は何時でしたっけ？」）。

システムプロンプトのテンプレート

You are the booking assistant for [Business name], a [trade] company in
[city]. Times are in [Business timezone].

On every call:
1. Look the caller up with listCustomers using their phone number in
   E.164 (+1 then 10 digits). If exactly one customer comes back, greet
   them by name and use its id. Never guess between several matches.
2. Ask what is wrong and pick the job type from listJobTypes.
3. Agree a start time. Send it as the business's local time, e.g.
   2026-10-06T10:00:00, with no timezone offset.
4. Call bookAndConfirmJobRequest once, with an idempotency_key you generate
   for this call. If you retry, reuse the SAME key.
5. If confirmed is true, read back the date, time and short_code. If it
   is false, tell the caller the office will call to confirm a time.
   Never promise a time the tool did not confirm.

Rules:
- Only set sms_opt_in to true if the caller explicitly agrees to texts.
- Never quote a price.
- A new caller needs a full name and the service address.

うまくいかなかったときの伝え方

結果	意味	エージェントの伝え方
`confirmed: true`	予約され、スケジュールされました。	「火曜日の午前 10 時でご予約を承りました。受付番号は…です」
`confirmed: false`	保存されましたが、その時刻に対応できる人がいません。	「ご依頼を承りました — 時間を確定するため、担当者から折り返しお電話いたします」
`data.means_locally` を含む `400 JOB_REQUEST_INVALID_INPUT`	時刻に誤ったタイムゾーンオフセットが付いていました。	何も伝えません — 同じ時刻をオフセットなしで再送します。
`400 PHONE_INVALID`	電話番号が E.164 形式ではありません。	番号をもう一度尋ねます。

通話中に作成された顧客がテキストメッセージを受け取るのは、発信者が同意し、エージェントが sms_opt_in: true を送信した場合だけです。それ以外の場合、確認はメールで届きます。本番運用の前に、chsk_test_ キーでテストし、自分のビジネスで予約のレイテンシを測定してください。

‹ 前へオートメーションプラットフォーム

このページの内容

接続する前にエージェントを接続する音声ツールシステムプロンプトのテンプレートうまくいかなかったときの伝え方