--- title: "Resolve issues found by the Dispatch Pro troubleshooter tool" slug: "resolve-issues-found-by-the-dispatch-pro-troubleshooter-tool" updated: 2026-04-25T01:41:45Z published: 2026-04-25T01:41:45Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt > Use this file to discover all available pages before exploring further. # 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.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/resolve-issues-found-by-the-dispatch-pro-troubleshooter-tool-image-7yx0k10s.png) 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] > **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.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/resolve-issues-found-by-the-dispatch-pro-troubleshooter-tool-image-sobglhef.png) ### 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] > **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](/v1/docs/adjust-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](http://go.servicetitan.com/ask). 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](http://go.servicetitan.com/ask) for further assistance. | No action needed. | - No permissions required | ## Want to learn more? - See [Run the Dispatch Pro troubleshooter tool](/v1/docs/run-the-dispatch-pro-troubleshooter-tool) - See [Dispatch Pro Settings overview](/v1/docs/dispatch-pro-settings-overview) - See [Best practices playbook: Maximize Dispatch Pro](/v1/docs/best-practices-playbook-maximize-dispatch-pro)