確実に予約までつなげる不在着信自動SMS返信:Twilio + Crisphive

リアルタイムの空き枠照会、明示的な予約確定ゲート、リトライ処理、ディスパッチへの引き継ぎを備えた不在着信予約ワークフローを構築します。

執筆者:Logan Le読了目安 1 分2128 回閲覧4.7 (64)
A young man holding a smartphone gestures to an older man holding papers as they sit at a cluttered desk with a computer.

確実に予約までつなげる不在着信自動SMS返信を構築するには、発信者からの返信を確定した案件(ジョブ)へと変換する明確な経路が必要です。50台以上の車両を運用する現場では、その経路に拠点ごとの境界、リアルタイムの空き枠照会、そしてディスパッチ(配車・調整担当)が手動で引き継げる仕組みが不可欠です。こうした判定ロジックを中心に会話フローを設計してください。メッセージング層にはTwilioを、音声対応が必要な場合は音声層を、そして会話データとCrisphiveを接続するアダプターを使用します。

以下に紹介する設計案では、予約処理をステートフルなワークフローとして扱います。これにより、選択された枠が途中で埋まってしまった場合や確定通知が届かない場合などの挙動を、開発者とオペレーション責任者が共通の認識を持ってテストできるようになります。

スタック構成と各コンポーネントの役割

各コンポーネントには明確な役割を持たせます。メッセージング層はテキストのやり取りを担い、音声層は電話対応時の音声受付を扱います。独自アプリケーションがワークフローの状態を管理し、予約アダプターを呼び出します。そしてCrisphiveがスケジューリングの連携先となります。会話上は予約が完了したように見えても、確定通知は必ず予約処理が成功したことを確認してから送信してください。

ボイスエージェントによる予約処理が途中で停止した際、この構成分離によって開発者は原因を迅速に特定できます。発信者が修理内容をどれほど明確に説明していても、指定された拠点に適切な空き枠がない場合があります。そのため、良好な会話が行われたことだけを理由に案件が存在すると判断せず、リクエスト内容を保持したまま次の手順を案内するロジックが必要です。予約結果を最終判定基準とし、予約が完了していない場合は未解決の試行としてディスパッチに提示することをお勧めします。

音声プロバイダーは実装要件に合わせて選択してください。検討の起点として、Vapiドキュメント、Retellドキュメント、Blandドキュメントを参照できます。これらを参考に構築予定の接続を評価してください。本設計は、特定のプロバイダーが持つドキュメント化されていない機能に依存するものではありません。

音声AIを活用したフィールドオペレーション業務では、会話スクリプトを確定する前に、地域のディスパッチとの引き継ぎ手順を確認してください。拠点マネージャーが未解決リクエストの担当者を一目で特定できるようにする必要があります。他の拠点へ問題が予期せず引き継がれるのを防ぐため、ワークフローのレコードに担当者を記録してください。

事前準備と認証情報の取り扱い

まずはテスト用の環境、該当環境にスコープを限定した認証情報、そして運用部門と合意した拠点レベルの予約ポリシーを用意します。APIキーなどの認証情報は必ずサーバー側で保持してください。発信者にキーが送信されることがあってはならず、AI電話受付APIの接続デバッグ時にトランスクリプト(会話ログ)へ出力させることも避けてください。

  • 初期運用で予約受付を許可する拠点およびサービスエリアを選定します。
  • 空き枠の照会を要求する前に、自社アプリケーションが収集すべき受付項目を定義します。
  • どの予約結果であれば確定通知を送信し、どの結果であればディスパッチへの引き継ぎが必要かを明記します。
  • 作成された案件(ジョブ)を確認できるテスト用発信者とディスパッチャーを用意します。

メッセージングの実装についてはTwilioメッセージングドキュメントを、フィールドオペレーションAPIの接続についてはCrisphiveの予約作成ガイドを参照してください。アダプターを実装する前に、これらのドキュメントで実際のリクエスト項目と認証要件を確認してください。後述するサンプル関数名を推測のエンドポイントURLとして使用しないでください。

環境ごとにデプロイ設定を分離してください。エンジニアがリトライ処理のテストを行う際は、会話プロンプトを変更する場合であっても、本番運用中の拠点データにアクセスできないようにします。別の拠点へ展開する前に、その拠点の受付ルールとディスパッチ担当者を用いてテストを再現してください。パイロット拠点での成功が、他の拠点でも同様に適用できることを保証するわけではありません。

音声層とCrisphiveの連携

アダプターを会話処理とスケジューリング処理の境界として機能させます。会話フローでリクエストを受け付けた後、選択された拠点と検証済みの受付内容をもとに、アダプターへ候補枠を問い合わせます。発信者が候補を選択したら、予約処理を実行する前にもう一度検証を行ってください。ディスパッチがその拠点で作業を割り当てている可能性があるため、会話の序盤で取得した空き枠情報が現在も有効であるとは限りません。

デスクに座った2人の男性が、マイク付きの黒いヘッドセットをオフィスのビジネスホンに接続している様子。
会話と予約処理の連携テスト

以下はアプリケーションレベルの疑似コードであり、公開 API の仕様ではなくローカル関数の名前を示したものです:receiveMissedCall(event) → recordIntake(event) → requestCurrentOptions(intake) → sendOptions(options) → recordSelection(reply) → attemptBooking(selection) → confirmFromResult(result)。ドキュメント化されているインターフェースに基づいてこれらの機能を実装してください。また、途中の処理記録は自社アプリケーション内に保存してください。保存がない場合、停滞したやり取りを調査するエンジニアがメッセージ履歴から手動で状況を復元しなければならなくなります。

メッセージ識別子と予約識別子は分けて管理します。受信イベント、選択された拠点、顧客の選択内容、および予約結果を紐付けて記録してください。アダプターが不確定な結果を返した場合は、その不確定な状態をそのまま保持します。結果が不明な間は、予約がまだ確定していない旨を伝えてください。

オーケストレーションは、アプリケーションが再開できるシーケンスとして記述します。アプリケーションレベルの疑似コード例:if seen(event_key): return recorded_state; intake = validate(request); options = adapter.find_options(intake); save_options(event_key, options); send_options(options)。選択が行われたら、保存された状態を読み込み、アダプター経由で予約を試みます。これらは実装すべきローカル関数であり、CrisphiveのエンドポイントやSDKのサンプルコードではありません。

空き状況の照会処理と予約の書き込み処理は分離してください。マッチングスロットのリファレンスで、仕様として定義された空き照会の契約を確認できます。その返却結果と発信者の選択項目は、自社のワークフローレコードを介して紐付けてください。空き状況のレスポンスだけで予約が確保されたと判断しないようにしてください。

エッジケースの処理(重複スロット、仮押さえ、リトライ)

ディスパッチが同じ拠点で作業を割り当てている最中に、顧客が空き枠を選択したケースを考えてみます。処理を確定する前にもう一度選択項目をチェックしてください。すでに枠が埋まっている場合は、その日時が選択できなくなったことを説明して最新の候補枠を取得し、顧客に再選択の機会を提供します。勝手に別の時間に変更したり、選択していない拠点へリクエストを転送したりしてはいけません。

仮押さえ(ホールド)は、システムが明示的にサポートしている場合にのみ独立した状態として扱います。有効期限、期限切れ時の通知方法、および仮押さえ中にディスパッチ画面でどう表示されるかを定義してください。仮押さえ機能を実装していない場合は、提示した候補枠を「確保済み」と説明しないでください。システムが履行できない約束を発信者に与えることになります。

リトライ処理には、永続化されたログが必要です。タイムアウトが発生すると、予約が成功したかどうかアプリケーション側で判断できなくなることがあります。そのため、書き込みを再実行する前に、実際に保持している関連情報を用いて既存の処理結果を検索し、状態が判明するまでその試行を「未解決」として保持してください。結果を確認できない場合は、ディスパッチへ引き継ぎます。拠点ボード間で重複して案件が登録されるリスクを避けるためにも、手動への切り替えを受け入れるべきです。

  • 重複した受信イベント:新たなリクエストを作成せず、記録されているワークフローを再開します。
  • 選択枠が利用不可:新たな候補を取得し、顧客に再選択を促します。
  • 予約結果が不確定:再書き込みを行う前に既存の試行状態を調査します。
  • 会話の中断:リクエスト内容を保持し、指定された担当者へルーティングします。

応答メッセージの調整を行う前に、未解決状態のレコードを調査してください。これらを地域のチームが確認できるように可視化します。ディスパッチには、顧客に最初から説明し直してもらうことなく会話を継続できるだけの十分なコンテキストが必要です。

テスト通話:対話シナリオのシミュレーション

以下のやり取りをリハーサルし、次に意図的に選択枠が埋まっている状態で再現してみてください。なお、以下のセリフはテスト用シナリオであり、実際の顧客とのトランスクリプトや導入実績を示すものではありません。シナリオ上で確定が許可されたタイミングで、ディスパッチに案件レコードを確認させてください。

ガレージの出入口で電話で話す若手男性と、近くのコルクボードに貼られた書類を確認する年配男性。
営業所でディスパッチへの引き継ぎ手順をリハーサルする様子

発信者:先ほどお電話をいただいたようなのですが、現場の修理対応をお願いできますか?

アシスタント:空き状況をお調べいたします。どちらの現場への訪問をご希望で、どのような作業が必要でしょうか?

発信者:こちらの現場を担当している拠点でお願いします。早い方の時間帯でお願いします。

アシスタント(予約成功時):指定の時間帯で訪問のご予約が完了いたしました。詳細をお送りいたします。

アシスタント(結果が不確定な場合):予約の確定処理を完了できませんでした。担当のディスパッチへ引き継ぎ、確認のうえご連絡いたします。

次に、別のテスターが同じ枠を選択するパターンをテストします。着信イベントを再現し、予約レスポンスを中断させ、確定メッセージが送信される前に切断します。リハーサルごとに、自動処理が停止した際の人間の担当者への連携ルートを含め、検証可能な記録を残してください。結果を確認する前に、テスターに「ディスパッチ画面でどう表示されると予想するか」を口頭で発表させます。

受入テストでは、会話の一連の流れがディスパッチ画面にどう反映されるかまで追跡する必要があります。スマホに届くテキストだけで完了としないでください。日時だけでなく拠点や依頼作業が正しく反映されているか、重複イベントによって二重の案件が作られていないかを確認します。

返信が遅れたケースもリハーサルに含めます。ディスパッチがスケジュールを変更した後に発信者から返信が来る場合があるため、過去のメッセージからの選択を処理する前に、アプリケーションは最新のワークフロー状態を読み込む必要があります。以前の候補枠が古くなっていた場合の応答メッセージを決定し、その挙動をテスト担当者が確認できるようにしておきます。

本番運用への導入:チェックリスト

まずは、ディスパッチ責任者が状況を監視し、必要に応じて停止処理を行える拠点から運用を開始します。あいまいな結果を誰が確認するか、自動ルート停止中に発信者がどのように担当者へ接続できるかをあらかじめ合意しておきます。パイロット拠点での動作が予測可能になるまで、他の拠点への展開は見送ってください。

  • 本番環境の認証情報がテスト環境から隔離され、ログに出力されていないことを確認する。
  • 拠点、サービスエリア、受付ルールをディスパッチと照合・確認する。
  • 空き枠不可テストおよび応答中断テストを対象環境で実施する。
  • 顧客への確定通知内容と、実際の予約レコードの内容を照合する。
  • 未解決会話の担当者を割り当て、明確な停止手順を準備する。

開発受託会社(エージェンシー)の場合は、構築契約とサブスクリプションおよび継続サポート契約を明確に分けてください。自社で請求を行うのはスケジューリングおよび音声連携の構築作業であり、レベニューシェア等の仕組みについてはCrisphiveパートナープログラムに記載されています。クライアントに見積もりを提示する前に、該当するトラックと条件をそちらで確認してください。予約失敗時の対応担当者や運用停止権限を持つ担当者を明記した引き継ぎ書をクライアントに渡してください。

発信者が会話を離脱したポイントや、ディスパッチの手動介入が発生した箇所のログを保持してください。これらの記録を活用して、次に改善すべきロジックを特定します。文言の修正と予約失敗の改善は異なるアプローチが必要となるため、分けて検証を行ってください。

このワークフローのコストを見積もる際は、メッセージング、音声処理、実装作業、および継続的な運用サポート費用を個別に計上してください。選定したコンポーネントの最新見積もりを取得します。根拠のないコスト削減の約束をもとに予算を組まないでください。ディスパッチが確定案件と未解決リクエストをまだ明確に区別できない場合は、運用の開始を見送ってください。

#BuildInPublic#DevTools#AIAgents#API#MCP#FieldService#FieldOps#SmallBusiness#dispatch#scheduling#AI#automation#SaaS#B2B#Productivity

この記事を共有

この記事は役に立ちましたか?

5 点中 4.7 点 · 64 件の評価

コメント

0/2000

あわせて読む

Developersのノートをもっと見る →