ServiceTitan AI receptionist that books the job on the call

{
  "type": "webhook",
  "name": "look_up_customer",
  "description": "Finds the customer and their open jobs by phone number. Use it at the start of every call. Saves customer.id from the response as customer_id.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.your-company.com/servicetitan/customers",
    "method": "GET",
    "query_params_schema": {
      "properties": {
        "phone": {
          "type": "string",
          "description": "The caller's phone number in E.164 format."
        }
      }
    },
    "request_headers": {
      "X-Tenant": "acme-hvac"
    },
    "authentication": {
      "mode": "bearer",
      "token": {
        "type": "secret",
        "secret_value": "YOUR_SERVICE_TOKEN"
      }
    }
  },
  "assignments": [
    {
      "dynamic_variable": "customer_id",
      "value_path": "customer.id"
    }
  ]
}

{
  "type": "webhook",
  "name": "check_openings",
  "description": "Lists open arrival windows for a job type on a date.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.your-company.com/servicetitan/openings",
    "method": "GET",
    "query_params_schema": {
      "properties": {
        "job_type": {
          "type": "string",
          "description": "Job type, such as AC repair or drain clearing."
        },
        "date": {
          "type": "string",
          "description": "The requested date, YYYY-MM-DD."
        }
      },
      "required": [
        "job_type",
        "date"
      ]
    },
    "authentication": {
      "mode": "bearer",
      "token": {
        "type": "secret",
        "secret_value": "YOUR_SERVICE_TOKEN"
      }
    }
  }
}

{
  "type": "webhook",
  "name": "book_job",
  "description": "Books a job in the arrival window the caller chose.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.your-company.com/servicetitan/jobs",
    "method": "POST",
    "request_body_schema": {
      "type": "object",
      "properties": {
        "customer_id": {
          "type": "string",
          "dynamic_variable": "customer_id"
        },
        "job_type": {
          "type": "string",
          "description": "Job type."
        },
        "window_start": {
          "type": "string",
          "description": "Start of the chosen window, ISO 8601."
        },
        "summary": {
          "type": "string",
          "description": "What the caller described, in one or two sentences."
        }
      },
      "required": [
        "job_type",
        "window_start",
        "summary"
      ]
    },
    "authentication": {
      "mode": "bearer",
      "token": {
        "type": "secret",
        "secret_value": "YOUR_SERVICE_TOKEN"
      }
    }
  }
}

{
  "config": {
    "system_tools": {
      "transfer_to_number": {
        "description": null,
        "pre_tool_speech": "auto",
        "transfers": [
          {
            "destination": {
              "type": "phone",
              "phone_number": "+14155550100"
            },
            "condition": "The caller reports an emergency such as flooding, a gas smell or no heat in freezing weather."
          }
        ]
      }
    }
  }
}