ja
予約見積もり済みジョブにマッチする時間枠

見積もり済みジョブにマッチする時間枠

見積もり済みジョブの予約可能な到着ウィンドウ枠を、スマートアサインメントのマッチングエンジンが計算して返します: 各枠には、その時刻に実際に開始できるテクニシャン(スキル、週次の稼働可能時間、既存のスケジュール、休暇、移動をすべてチェック済み)と、テクニシャンごとのマッチスコアが含まれます。エージェントやインテグレーションがその後確定できる予約時間の検索・提示に使用してください(枠の business_time.datetime を POST /job-requests/{id}/confirm に渡して確定します)。エンドカスタマーの枠選択 UI に表示されるものと同じグリッドです。枠の幅はデフォルトでビジネスの到着ウィンドウとなり、?step_minutes(5〜240)で上書きできます。ジョブは先に見積もり済みである必要があります(見積もりによって、マッチャーがスケジュールする訪問所要時間が設定されます)。

引数

idstringpath必須
ジョブリクエスト ID(UUID または short_code)
step_minutesintegerquery任意
枠の刻み幅(分)(デフォルト: ビジネスの到着ウィンドウ、5〜240)
GET/v1/job-requests/{id}/time-segments
curl -X GET "https://api.crisphive.com/v1/job-requests/9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01/time-segments" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"

レスポンス