HomeAPI ManualEmail Parser APIEmail Parser: Using Email as a Service

5.1. Email Parser: Using Email as a Service

HelpSpots email parser allows you to use the built in email integration as a basic web service. If you need to create requests in remote systems you can add a few basic tags to an email you generate for accurate importing into HelpSpot. Every email that creates a new request is automatically sent through the email parser so your remote system can email requests with tags to the same accounts you already use for support. Request updates cannot use email parser tags to avoid unintended changes to existing requests.

The following tags are available for use within email bodies. Replace XXXXXX with your data. All tags are automatically stripped after being parsed so only the email body will remain as the request.

Tag Description
##hs_customer_id:XXXXXX## The customers ID.
##hs_customer_firstname:XXXXXX## The customers first name.
##hs_customer_lastname:XXXXXX## The customers last name.
##hs_customer_phone:XXXXXX## The customers phone number.
##hs_customer_email:XXXXXX## The customers email address.

Example:

Here's an example of an email generated with customer tags. This type of email could be generated from a remote service, desktop application, or intranet.

Hello,

I'm having trouble logging into the time reporting system. Yesterday I was 
able to enter the system via the link on the intranet, but today when I click 
that link all I see is the login screen. 

Tim

//Note: You would programatically append the tags below//

##hs_customer_id:589GK42##
##hs_customer_firstname:Timothy##
##hs_customer_lastname:Ryan##
##hs_customer_phone:(845) 765-4321##
##hs_customer_email:t.ryan@mycompany.com##

There are also advanced tags available to submit category and custom field information.

Knowledge Tags

Related Pages
This page was: Helpful | Not Helpful