Work Order Dispatch Trigger

Smart Dispatch automates the assignment of work orders by creating a time-bound request window for providers within a specific service territory. The system automatically assigns the best match based on predefined Project rules and provider tiers.

Integration Capability: A dedicated mappable field allows external systems to programmatically trigger this automation once the Work Order is ready. These configurations are bidirectional.

Prerequisites

To successfully trigger Smart Dispatch via integration, the work order must have:

1. A Valid Break-fix Project: The associated Project must have Smart Dispatch settings configured (e.g., runtime window, backout logic).
2. A Mapped Service Territory: The work order must be tied to a service territory containing eligible providers.

The mappable field in the Integration UI is available in the Dispatch section as:

Schema Configuration

Acceptable data types can be both string or boolean to initiate the dispatch logic.

Accepted "True" Values

Sending any of the following values will start the Smart Dispatch process:

• 1 or '1'
• true or 'true'
• yes or 'yes'

Any other value is treated as false and will not trigger the action.

Mapped Values

{
  "user_controlled_service_flag": {
    "smart_dispatch": "true"
  }
}

Validation & Error Handling

Success

Failure Scenarios

Unlike service territory mapping (which is non-blocking), Smart Dispatch triggering returns specific failure messages if the operation cannot proceed.