Email Command allows the technician to delimit fields in the email, according to which the email can be parsed and corresponding fields can be set.
Role Required: SDAdmin
To configure Email Command,
- Go to Setup > Mail Settings > Email Command.
- Select the Email Command check box to activate email parsing. If this option is disabled, incoming emails will be processed according to existing business rules, even if the subject of the incoming emails contains the parsing string.
- Enter the subject line string in the Email Subject Contains text box to specify which emails should be parsed.
- Specify the subject line identifier in the Email Subject Contains text box. Only emails containing this text in the subject line will be parsed for various fields. For instance, if the email subject identifier is given as @SDP@, then emails with subject containing @SDP@ alone will be considered for parsing.
- Provide any special character (@@, ##, $$, %%, &&, etc.) as the Command Delimiter. The values between these special characters are assigned to the corresponding fields when creating requests. For example, if the Command Delimiter is @@ and the email description needs to set the category field to Printer, the email description should contain @@Category=Printer@@.

Note:
- A technician can create, update, close, pick up, or assign a request through emails using operational strings such as "OPERATION = ADD_REQUEST", "OPERATION = EDIT_REQUEST", "OPERATION = CLOSE_REQUEST", "OPERATION = PICKUP_REQUEST", and "OPERATION = ASSIGN_REQUEST".
- To update, pick up, assign, or close a request through emails using operational strings such as "EDIT_REQUEST", "PICKUP_REQUEST", "ASSIGN_REQUEST", "CLOSE_REQUEST". Please note that the email must contain the "WORKORDERID" field. If it is not included, the email will be processed as a new request.
- When an email updates a request, the changes will not be recorded in the request conversations. Hence, attachments or images included in the email will not be updated in the request. However, the update details will be recorded in the request history.
- If the field name given in the email is not available in the application, then parsing will be excluded for that field.
- If there is more than one value present for a particular field in an email, then the latest value will be taken and others will be discarded.
- Request threads with subject containing "RequestId" and no operational string will be updated as a normal conversation and a new request will not be created.
- Self-service login must be enabled for the email sender for the email parsing to happen. This is because various operations that can be handled by a user to parse an email are defined by the user's role. Request authorization (close a request, pick up a request, update a request, accept closure of a request, and so on) is set using roles in the application.
- The email sender will be considered the requester's if the requester name is not specified in the email.
Permissions and Parameters Supported
- If the email sender is a requester with requester permissions, they will only be able to parse fields that are visible to them in the request form when creating a request.
- If the email sender is a technician with technician permissions, they can only parse fields that are visible to them in the request form when creating a
- Fields that can be parsed are LEVEL, MODE, PRIORITY, URGENCY, IMPACT, IMPACTDETAILS, CATEGORY, SUBCATEGORY, ITEM, GROUP, TECHNICIAN, TECHNICIANEMAIL, REQUESTER, REQUESTEREMAIL, WORKORDERID, REQUESTTEMPLATE, REQUESTTYPE, STATUS, SITE, ASSET, RESOLUTION and additional field label (the field label given in the email must match the field label set in the product).
- To change the fields that a requester or a technician can parse, go to Admin > Templates & Forms > Request Templates, select Default Template, and add/remove the fields.
- The WORKORDERID mentioned in the email description will take precedence over the "RequestId" present in the email subject.
Examples
Sample Email Content for ADD_OPERATION:
@@OPERATION=ADD_REQUEST@@
@@SUBCATEGORY=Tray1@@
@@ITEM=Paper Jam@@
@@LEVEL=Tier 1@@
@@MODE=Web Form@@
@@PRIORITY=High@@
@@URGENCY=High@@
@@IMPACT=Affects Group@@
@@GROUP=Printer Problems@@
@@REQUESTER=Guest@@
@@REQUESTTYPE=Incident@@
@@ASSET=Printer1@@
@@TECHNICIAN=administrator@@
@@REQUESTTEMPLATE=Printer Problem@@
@@SUBJECT=Add Request via Email Command@@
Sample Email Content for EDIT_OPERATION :
@@OPERATION=EDIT_REQUEST@@
@@WORKORDERID=4@@
@@LEVEL=Tier 3@@
Supported Request Fields in Email Command are:
SUBJECT
DESCRIPTION
PRIORITY
LEVEL
STATUS
MODE
URGENCY
IMPACT
IMPACTDETAILS
SITE
GROUP
CATEGORY
SUBCATEGORY
ITEM
REQUESTER / REQUESTEREMAIL / REQUESTERID
TECHNICIAN / TECHNICIANEMAIL / TECHNICIANID
WORKORDERID
DUEBYTIME
CREATEDTIME
ONHOLDCOMMENTS
SCHEDULEDTIME
SCHEDULEDSTATUS
CLOSECOMMENT
CLOSEACCEPTED
UDF FIELDS
Date format for specifying CREATEDTIME/DUEBYTIME field as a formatted date string:
DATE_TIME_FORMAT = "dd MMM yyyy, HH:mm:ss"
Related Articles
Email Reports
Role Required: SDAdmin, SDReport, Technicians with View access to reports, Account Manager and Point of Contact of customers with View Reports access To email a report, Go to the Reports module and open a report. Click Mail this Report displayed at ...
Email Contract Owner/Vendor
Send email notifications to the contract owner or vendor. The owner and vendor fields are customer-specific. Role Required: SDAdmin, Users with View Contract permissions On the header, select the customer for whom you want to associate ...
Email the Vendor
Notify or enquire about the purchase order to the vendor. Role Required: SDAdmin; Technicians with Edit permission for Purchase In the purchase order details page, click Actions > Email the Vendor. A Send email form is opened in a separate window ...
Email the Purchase Order Owner
Notify the owner of the purchase order regarding the purchase via email. Role Required: SDAdmin; Technicians with Edit permission for Purchase Go to the Purchases module and open your preferred purchase order. Ensure you select the respective ...
Email or SMS the Technician
ServiceDesk Plus MSP Cloud enables you to notify a technician through email or SMS. Role Required: Technicians Email the Technician Go to Requests and select the respective customer from the drop-down in the header. Click the subject link of the ...