Buildium AI voice agents that log maintenance requests by phone

{
  "type": "webhook",
  "name": "find_tenant",
  "description": "Finds the caller's tenant record and lease. Use it before filing a request, and pass the tenant ID and lease ID it returns to create_maintenance_request.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.buildium.com/v1/leases/tenants",
    "method": "GET",
    "query_params_schema": {
      "properties": {
        "name": {
          "type": "string",
          "description": "The tenant's name, or part of it."
        },
        "unitnumber": {
          "type": "string",
          "description": "The unit number the caller gave, such as 4B."
        }
      },
      "required": [
        "name"
      ]
    },
    "request_headers": {
      "x-buildium-client-id": "YOUR_CLIENT_ID",
      "x-buildium-client-secret": {
        "type": "secret",
        "secret_value": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

{
  "type": "webhook",
  "name": "create_maintenance_request",
  "description": "Files a maintenance request for the tenant found by find_tenant.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.buildium.com/v1/tasks/residentrequests",
    "method": "POST",
    "request_body_schema": {
      "type": "object",
      "properties": {
        "Title": {
          "type": "string",
          "description": "Short title, such as Kitchen sink leaking. Under 127 characters."
        },
        "Description": {
          "type": "string",
          "description": "What the tenant described, in a few sentences."
        },
        "UnitAgreementId": {
          "type": "integer",
          "description": "The lease ID from find_tenant."
        },
        "RequestedByEntityId": {
          "type": "integer",
          "description": "The tenant ID from find_tenant."
        },
        "TaskStatus": {
          "type": "string",
          "constant_value": "New"
        },
        "Priority": {
          "type": "string",
          "description": "High if the problem gets worse while it waits, otherwise Normal.",
          "enum": [
            "Low",
            "Normal",
            "High"
          ]
        },
        "IsEntryPermittedByResident": {
          "type": "boolean",
          "description": "Whether the tenant allows staff to enter when they are not home."
        },
        "DoesResidentHavePets": {
          "type": "boolean",
          "description": "Whether the tenant has pets."
        }
      },
      "required": [
        "Title",
        "Description",
        "UnitAgreementId",
        "RequestedByEntityId",
        "Priority"
      ]
    },
    "request_headers": {
      "x-buildium-client-id": "YOUR_CLIENT_ID",
      "x-buildium-client-secret": {
        "type": "secret",
        "secret_value": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

{
  "config": {
    "system_tools": {
      "transfer_to_number": {
        "description": null,
        "pre_tool_speech": "auto",
        "transfers": [
          {
            "destination": {
              "type": "phone",
              "phone_number": "+14155550137"
            },
            "condition": "The caller reports a gas smell, flooding or active leak through a ceiling, no heat, no water, or a lockout."
          }
        ]
      }
    }
  }
}