Advanced ticket submission with Email API
Email API is a perfect solution for automated generation of tickets and their population with values generated by 3rd party systems using common email service.
The Email-to-Ticket utility converts incoming email messages into ScopeDesk tickets by parsing Email Subject, Body, Sender, Sender Email and Priority into the corresponding ticket fields: Subject, Message, Customer name, Customer Email (the registered Customers are automatically detected) and the ticket Priority, if enabled. Each email attachment is also added as a ticket attachment.
On the other side, Email API allows you to parse incoming email and to set various Ticket fields other than predefined by design. Whenever email body contains the corresponding field’s placeholders, the Email API will recognize them and add to the ticket record, based on the containing content. The set of placeholders with their proper values are obtained specifically for each custom ticket submission form as defined in the account settings.
For example, if the following custom submission fields are defined for Topic “Support”:
- Select list field: Software Module
- Text field: Module name
- Select list field: Operating system
- Checkbox field: Phone contact needed
- Date field: Error appeared
then the corresponding Email API Placeholders could look like:
#FORM#30981# #FIELD_1#Reporting# #FIELD_6#2210# #FIELD_7#4803# #FIELD_10#2210# #FIELD_15#1# #FIELD_16#22-NOV-2016#
Note that placeholder’s values are specific and unique for each ScopeDesk account. The values above are for the reference only.
Eventually, the Ticket custom fields will be filled as:
- Topic Support
- Software Module Accounts Payable
- Module name Reporting
- Operating system Windows
- Phone contact needed
- Error appeared 22-Nov-2016
The only necessary step from the customer side is that the email sender generate email containing the placeholders in the given format and send email to ScopeDesk account’s email address. The Email API along with the Email-to-Ticket utility will do the rest of the job and create a valid ticket. For specific ticket commands and email notification settings, the Workflow section provides a set commands to fulfill specific needs.