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 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 ...
Mail Addresses
In Mail Addresses, you can add, verify, and manage email addresses to use as the sender's email address or store group email addresses. Role Required: SDAdmin Adding and Verifying Email Addresses To add and verify custom emails, Go to Setup > Mail ...
Reply to Requests
Technicians can reply to emails from the request details page. The replies will be sent as an email to the recipients and logged in the Conversations tab. In the request details page, click Reply All or click and select Reply. Fill out the form as ...
Forward Requests
Technicians can forward requests from the request details page. The request will be forwarded as an email to the recipients and logged in the Conversations tab. In the request details page, click and select Forward. Fill out the email form as ...