Drivers can text or email Q codes to X Dispatch to update. 

How Q Codes Work

When an order is dispatched to a driver, X Dispatch will send an email-to-text to the driver's phone and the driver responds to the text message with a Q code. For example,  the driver would respond "QY" for confirmed or "QP" for picked up. When the Q code is received by X Dispatch, the information will be added, and use the timestamp that the email was sent as the time stamp on the order. 

Q Codes

^{Back to top.}

How to Set Up Q Codes

Inbound Email Settings 

An Inbound Email must be set up on an active profile in the Mail Manager. See Mail Manager.

1. Go to Action > Mail Manager.
2. Click the Edit Profile icon .

3. Click Add. 

   To edit a profile, select the mail account you would like to edit by clicking on it, it will be highlighted in blue, then click Properties

4. Enter a Profile Name and the number of minutes you would like to check for inbound or outbound email messages in the Frequency field. 

   Quick Tip

   It is recommended that the Frequency is set between 1-3 minutes.

5. Check Enable inbound email.

6. Enter the information for the Inbound Email section. 

   • Enable inbound email - If checked this will receive email through the email server set up in the Inbound Email settings.
   • Inbound mail type - How the incoming email will be accessed. 
     • POP3 - This is recommended when email will only be accessed in X Dispatch. The server listens on well-known port 110. Encrypted communication for POP3 is either requested after protocol initiation, using the STLS command, if supported, or by POP3S, which connects to the server using Transport Layer Security (TLS) or Secure Sockets Layer (SSL) on well-known TCP port 995.
     • IMAP - This is recommended when you are accessing an email from multiple devices. The server typically listens on port number 143. IMAP over SSL (IMAPS) is assigned the port number 993.
   • Host - POP3 or IMAP email server. This information would be provided by your email service provider. 
   • Username - Usually your email address.
   • Password - Password used with the username above for your email.
   • Port - Port provided by your email service provider.
   • Secure Connection - This should be checked if your email provider requires SSL/Secure Connection
7. Click Save.

^{Back to top.}

Setting Up the Message Format

A message format must be set up to send messages. 

1. Add or edit a message format. See Message Formats (Classic Operations App).
2. On the General tab set the Message Type to "Driver".
3. Set the Return Email Name to "[OrderID]" with no quotes.
4. Set the Return Email Address to the email address that you set up in the Mail Manager above.
5. Set the Message Subsystem to "Two-way Text Messaging".

6. Set the TCP Protocol to "0-SMTP". 

   

   
   

7. Go to the Format tab to set up the message format. 

   When setting up messages for email-to-text note that some carriers auto-truncate text messages.

   Example

   You can customize your message format and use Available Fields on the left to generate order information.

    

8. Click OK. 

^{Back to top.}

Setting Up the Driver Record

The driver record must be set up.

1. Add or edit a driver record. See Drivers - New / Edit Driver.
2. Set the Secondary Format to the message format you added or edited above. 

3. Set the Secondary Email to the email-to-text address the driver's cell carrier uses.

   Quick Tip

   Major Mobile Carrier Email Domains:

   • Verizon - cellnumber@vtext.com
   • AT&T - cellnumber@txt.att.net
   • Sprint - cellnumber@messaging.sprintpcs.com
   • T-Mobile - cellnumber@tmomail.net

^{Back to top.}