Exercise #1 - Dispatch job to smartphone app


Today’s Exercise: Setup the Dispatch 5 beta on your server, create your first job, and assign it to a worker.

Server Setup

1. Update all of your plugins

Log in to your server and go to SiteAdmin > Plugins. Update all plugins. They will show in green when they are updated.

2. Download/Update the dispatch plugin


3. Enable Dispatch in your application(s)

    1. On your applications list in Applications > Search and Manage, choose the application(s) on your server in which you’d like to complete this exercise.
    2. Go to Privileges and Features > Plugins > Dispatch and enable all the Dispatch privileges. You can do this to multiple applications using Batch Edit.
    3. After doing this, click on Save at the bottom of the screen.
    4. Dispatch_-_enable_application.png

Application Setup

Configuring the workspace – adding the Dispatch window

Log in to your application as an admin user. This should ensure you have the privileges to do the steps below.

  1. Go to Windows > Dispatch and after the Dispatch panel shows up, drag-drop it on the screen according to your own preferences. The Dispatch window can also be used as a floating screen.
  2. Save your workspace modifications by going to Workspace > Save as and enter a name of your choosing.
  3. If you want to reuse this workspace with other users, you can select the Shared option. To learn more about workspaces, click here.

Creating a dispatch user

The admin user needs to create dispatch users (workers). It is recommended to create these workers with user type Dispatch Unit OR make sure that the worker has the _Dispatch Worker role.

To add a new dispatch user:

  1. Go to the Vehicles Panel and click + New User.
  2. Select the user type Dispatch unit and fill in the necessary user information.
  3. Click Save at the end of the user creation process.

Dispatch mobile app setup

Download the Dispatch 5 app on your iOS or Android device by searching for Dispatch GpsGate in the AppStore / Play Store.


Open the Dispatch mobile app and fill in the following information:

  1. Server URL
  2. Username
  3. Password


For the Server field, you can manually type in the server URL or scan a QR code to autofill it. Your server address may look like “awesometracking.example/ggs” or “” for example.

To generate a QR code, the admin will use the dropdown in the Dispatch window and select Generate QR Code

*Note: please contact support if you receive the error message “Generating a QR code lets you use the quick connect functionality from your workers’ Dispatch apps. Please contact your administrator to enable this feature.” They will supply you with an API key that will allow you to generate QR codes.

Scan this code with your phone’s camera in the Dispatch app after selecting I have a QR code on the login screen.

Sign in using the Dispatch Unit username and password you just created. 
After signing in, do NOT quit the Dispatch App.

If a pop-up window requests that you allow Notifications, click Allow (iOS). Notifications must be turned on/allowed to receive notifications for job updates or assignments.

Creating & Dispatching a Job

  1. In the Vehicle Tracker application, create a new job in the Dispatch panel by clicking the + Job button
  2. Fill in the required fields of NameLocation, and Worker. Other fields are optional.
  3. To dispatch the job immediately to the worker, select ‘Assigned’ as the job state.
  4. To continue without dispatching the job, leave the job in the default Planned job state.

Job fields descriptions:

Name:    The name of the job you are creating.
Notes:    Description of the job (optional).
Location:    You can write the address of the job or right-click on the map and select Pick Job Location instead. The address availability and format depends on your application’s geocoder.
Scheduled:    If you input a scheduled date/time for the job, you’ll be able to tell if your dispatcher is early or late for the given task.
Worker:    The worker to which the job is assigned.
Job state:    The current state of the job. When the job is being created it is always planned by default. Select Assigned if you want to send the job to the worker immediately.
Save/Cancel:   Save will save the job with the modifications/details added. Cancel will cancel the job you are creating and not save your work.

Right after the job is saved in the application with the state Assigned, the worker using the mobile app will receive a push notification about the new job. If no notification is received, check the notification settings on your phone and allow Notifications for the Dispatch app.


Congrats! You just completed Exercise 1! The next exercise will walk you through a day’s worth of work: importing jobs, assigning jobs, creating routes, and dispatching jobs to workers.