HTTPS Posting Services



Overview

Tea Leaves Health Strategic Growth platform gives customers the unique ability to post form data to a websevice that will allow Tea Leaves Health to bring touchpoint data into the growth platform.



Steps

  1. Obtain a posting key from Tea Leaves Health (hash_code)
  2. Create post to URL https://touchpoint.tealeaveshealth.com/consume
  3. Accept response as receipt of data transmission.


Ways To Post

Ajax Style Post

Field Name Value(s)
status 2 possible values 'accepted' or 'error'.

If the result is 'accepted' then everything went through correctly and your touchpoint data was saved.

If the result is 'error' then you will receive detail in the 'errors' field of the JSON explaining why. We will still save what you have posted in an error state and will have one of our staff look at the error in posting and see if we can associate the data to a valid touchpoint.
errors This is a JSON array with children of the errors. The key of the child field will be the name of the incorrect parameter and the value will be a description of the error.

Example:
Error JSON

{
   "errors": {
       "address_1": "Required Field, cannot be blank"
   },
   "status": "error"
}

Valid JSON

{
   "errors": {},
   "status": "accepted"
}


URL Redirect Style Post

A URL Redirect Style Post is one where you post a form to our consume url and then after we collect the data we push the end user along to the next page. To do this post you just need to post to the same URL, but also have a valid url posted in the 'redirect_url' field. This must also be url encoded. The easiest way to url encode is built into JavaScript and is as simple as this...

var newUrl = "http://www.tealeaveshealth.com";
var encodedUrl = encodeURIComponent(newUrl);

**Please note that the url must be fully qualified starting with 'https', if not you will be directed to a page on our site that will most likely be a 404 error.

Post Format

Field Name Req Format Description
hash_code R ############### This is the unique code that will tie your post to a touchpoint in our system
post_date - yyyyMMdd This is the date that you would like to have associated with the post. If left blank the post date will be set as the current day.
first_name R Open Text Touch point first name.
last_name R Open Text Touch point last name.
address_1 R Open Text Touch point address line 1.
address_2 - Open Text Touch point address line 2.
city R Open Text Touch point city.
st R Open Text Touch point state. Max size varchar(2). Standard US State abbreviations only.
zip R Open Text Touch point state. Max size varchar(9). US 5 digit Zip or 9 Digit Zipcode, no dashes accepted.
email - Open Text Touch point email address.
phone - Open Text Touch point phone number.
mobile - Open Text Touch point mobile phone number.
dob - yyyyMMdd Touch point date of birth.
gender - Open Text Touch point gender, represented as "M" or "F" other values will be ignored.
order_id - ########## Order Id from Tea Leaves Health associated with the touchpoint.
ip_address - ###.###.###.### Touch point originating IP address.
redirect_url - Encoded URL Url you would like the form to redirect on post. If left blank you will receive JSON showing if there were errors and if the post was accepted. Please encode this URL as well, a simple way is using the encodeURIComponent() in JavaScript.
sub_type_list - Open Text Additional Description that you can use for selection in the app. Please ask TLH rep for more information.
meta_field - name=value To be able to post a cookie and a value for a customer you can populate this field thus allowing us to track them. You can post multiple with the same element name of "meta_field" and we will attribute them all to the correct touchpoint recipient.


Example Form