Resolve issues found by the Dispatch Pro troubleshooter tool

Problem

After running the Dispatch Pro troubleshooter tool, you need to understand and resolve the alerts it identifies to ensure Dispatch Pro accuracy and return on investment (ROI).

Solution

Take action on troubleshooter alerts

At the top of the troubleshooter, you'll find key job details to help you understand any identified issues:

Priority: The importance level assigned to the job.
Start Date and Time: When the job is scheduled to begin.
Arrival Window: The timeframe for the technician's expected arrival.
Zone: The geographic area assigned to the job.
Business Units: The specific business units associated with the job.
Auto Lock: The lead time before a job starts during which Dispatch Pro no longer automatically moves or reschedules the appointment.
Max Drive Time: The maximum travel time allowed for the assigned technician.
Skills required for the job: The expertise needed for the work.

Job details for HVAC service including priority, time, and location information.

For every issue detected, the troubleshooter displays an alert along with an explanation of the issue. Some alerts are simply reminders, while others describe an issue you should resolve. If an alert is for an issue you can resolve, click the corresponding button or follow the instructions to take action.

Note: If the troubleshooter finds multiple issues, review each one and take action as needed.

Job troubleshooting interface showing skill requirements and technician details for two individuals.

Types of troubleshooter alerts

Below are the specific alerts you might see after running the troubleshooter.

Technician-specific alerts

Alert	Action	Required permissions
No issue found: Dispatch Pro optimizes the whole board at once. In this case, there are no specific issues found but we thought assigning this job differently or leaving it unassigned would bring more value to your company.	No action needed.	No permissions required
No skills required for this job: The technician doesn't have the required skill [skill name] to complete this job.	Click Add Required Skills to add the skills required for the job to the technician's profile.	Edit employee/technician
No support for required zone: The technician does not support the zone [zone name] required for this job.	Click Add Required Zone to add the job's zone to the technician's profile.	Edit employee/technician
Different business unit: The technician does not support the business unit [BU name] required for this job.	Click Open Technician Settings and add the job's business unit to the technician's profile.	Edit employee/technician Access Settings
No available shift for this job: The technician does not have an available shift that overlaps with the arrival window for this job appointment.	Click Open Technician Shifts Page to add a Regular shift for the technician within the job's arrival window. Note: Make sure to use a Regular shift. Dispatch Pro doesn't look at On Call shifts.	Edit technician shifts
Address missing: The technician doesn't have a verified home or business unit address.	Click Verify Address to validate the technician's home or business unit address.	Edit employee/technician
Dispatch Pro disabled for technician: The technician is not Dispatch Pro-enabled. Please enable Dispatch Pro to start optimizing [technician name]'s schedule.	Click Open Technician Settings to enable Dispatch Pro for the technician.	Edit employee/technician Pause/resume Dispatch Pro for individual technicians
Non-managed technician: Dispatch Pro only works with managed technicians. [technician name] is not a managed technician.	Click Open Technician Settings to change the technician to Managed in their profile.	Edit employee/technician Access Settings
Technician-specific job: This job is technician-specific. It can only be assigned to [technician name].	Click Turn Off Technician-Specific Flag to turn off the Technician-Specific toggle for the job.	Pause/resume Dispatch Pro for individual job

Job-level alerts

Alert	Action	Required permissions
Late arrival: Dispatch Pro couldn't find a spot that wouldn't make technicians late for this job. If possible, please extend the arrival window or reschedule.	Click Open Job Page to extend the arrival window for the job or reschedule it.	View job Edit job
No availability: All skilled technicians in the right zone/business unit are busy during this arrival window. If possible, please either extend the arrival window or reschedule the job.	If possible, extend the arrival window for the job or reschedule it.	View job Edit job
More profitable job: Technicians are scheduled for more profitable jobs during that time.	If possible, reschedule the job.	View job Edit job
Maximum drive time reached: Dispatch Pro is unable to find a spot without exceeding maximum allowed drive time.	If possible, adjust the maximum drive time in Settings > Dispatch Pro > Settings > Routing or consider canceling the job if it's truly out of range.	Edit Dispatch Pro settings Access Settings
Dispatch Pro disabled: Dispatch Pro was turned off for this job.	Click Turn On Dispatch Pro to enable it for the job.	Pause/resume Dispatch Pro for individual job
Auto-locked job: This job is currently auto-locked, technician is on the way or working on the job.	No action needed. This is determined by what is set in your Dispatch Pro locking jobs settings.	No permissions are required, however, the following permissions are needed if you want to update your settings: Access settings Edit Dispatch Pro settings
Dispatch Pro disabled for job type: Dispatch Pro is currently turned off for this job and its job type [job type name].	Click Turn On Dispatch Pro for Job Type to enable it for the job type.	Access Settings Edit Job Type
Missing arrival window: This job doesn't have an arrival window.	Click Add Arrival Window to add an arrival window to the job.	View job Edit job
Job outside of Dispatch Pro days: The job is outside of the Dispatch Pro planning window [0:MM/DD/YYYY HH:MM TT] to [1:MM/DD/YYYY HH:MM TT].	If possible, reschedule the job.	View job Edit job
Location not verified: The customer location for this job has not been verified.	Click Verify Location Address to validate the service location address.	View location Edit location
Multi-technician job: Dispatch Pro is currently unable to handle jobs with multiple technician assignments.	No action needed.	No permissions required
Multi-appointment job: Dispatch Pro is currently unable to handle jobs with multiple appointments.	No action needed.	No permissions required
Start date and arrival window mismatch: Start time of this appointment and expected arrival window are on different dates. Dispatch Pro is not able to assign this job properly. Please correct the start time or the arrival window on the job page.	Click Open Job Page to fix the start time or arrival window on the job.	View job Edit job

General alerts

Alert	Action	Required permissions
Unexpected problem with troubleshooter: Apologies! The troubleshooter encountered an unexpected issue. Our team is working to resolve the problem. If you have any additional information or observations, please contact ServiceTitan support. We apologize for any inconvenience this may have caused and thank you for your patience as we work to find a solution.	No action needed.	No permissions required
No recent Dispatch Pro runs: Depending on the situation, one of the following messages will appear: We were unable to find any recent Dispatch Pro runs from [0:HH:MM] to [1:HH:MM]. We were unable to find any recent Dispatch Pro runs from [0:HH:MM] to [1:HH:MM]. Please ensure it is set up correctly and you have available technicians and jobs to dispatch. If you continue to experience issues, please contact ServiceTitan support for further assistance.	No action needed.	No permissions required

Alert

Action

Required permissions

Unexpected problem with troubleshooter: Apologies! The troubleshooter encountered an unexpected issue. Our team is working to resolve the problem. If you have any additional information or observations, please contact ServiceTitan support. We apologize for any inconvenience this may have caused and thank you for your patience as we work to find a solution.

No action needed.

No permissions required

No recent Dispatch Pro runs: Depending on the situation, one of the following messages will appear:

We were unable to find any recent Dispatch Pro runs from [0:HH:MM] to [1:HH:MM].
We were unable to find any recent Dispatch Pro runs from [0:HH:MM] to [1:HH:MM]. Please ensure it is set up correctly and you have available technicians and jobs to dispatch. If you continue to experience issues, please contact ServiceTitan support for further assistance.