Locating your API key

This document contains a list of methods that can be called by invoking a web service using either the REST or SOAP method.
Before you begin you will need to retrieve your API key. This can be found inside the settings area of your Customer Thermometer account:

All API calls into Customer Thermometer must be made using this key. You shouldn’t disclose it to anyone. If you are concerned your key has been exposed, please contact us and we will supply a new one.

In addition to your unique API key, you’ll also find the API request URL, used to make calls via our RESTful API.

NB: The WSDL file for SOAP calls is at: https://app.customerthermometer.com/ctapi.wsdl

How to trigger Email Thermometers (Write Method)

sendEmail

This method is designed to send a single Email Thermometer to a single user. You could use this to trigger Email Thermometers as part of workflows within applications.

If the Thermometer blast ID is not passed then a new one will be created. Once the email has been sent, the Thermometer blast ID will be returned.

If the user is unable to send any more emails for any reason then the return value will be 0.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredsendEmail
thermometerIDIntegerRequiredThe ID of the prebuilt Thermometer you would like to send
blastIDIntegerOptionalThe Blast ID to log sends and responses against. If not supplied a new Blast, hence Blast ID will be created – this would mean creating Blasts of just one person.
listIDIntegerRequiredThe recipient List ID to add new email addresses to. This would need to be set up in advance.
emailAddressStringRequiredThe email address of the recipient
firstNameStringOptionalThe first name of the recipient
lastNameStringOptionalThe surname of the recipient
companyNameStringOptionalThe name of the company
custom1StringOptionalcustom1 data field associated with the recipient
custom2StringOptionalcustom2 data field associated with the recipient
custom3StringOptionalcustom3 data field associated with the recipient

Example syntax (note API key and variables are fictitious):

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=sendEmail&emailAddress=danny@customerthermometer.com&firstName=Danny&lastName=Smith&companyName=Danny Co&custom1=Friday&custom2=Strawberry&custom3=New York&thermometerID=16694&listID=41374&blastID=71763

When executed, this string will trigger an Email Thermometer remotely from the Customer Thermometer application.

It will use a prebuilt Thermometer template as indicated by the ID number. You will find the ID in the URL bar of your browser when inside the specific Manage Thermometer screen.

It will take the contact data supplied and add that to the List ID you supply. Again this could already be set up with contacts within it – and this remote call will append additional contacts to that list. You will find the List ID in the URL bar of your browser when inside the specific Manage List screen.

Finally, it will send the relevant Thermometer containing the contact data and add it as pending to the Blast ID which is supplied.

Results will then be appended to that Blast ‘envelope’ on an indefinite basis.

Return Type: Integer (indicating success or failure).

Read Methods

getThermometers

This method will return an XML document containing a list of all of the Thermometer names and ID’s available inside the account linked to the API Key used.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key                 
getMethodStringRequiredgetThermometers

Example syntax (note API key is fictitious):

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getThermometers

Return Type: XML

getSendQuota

This method will return an integer containing the number of Thermometer credits currently existing inside the account linked to the API Key used.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key                 
getMethodStringRequiredgetSendQuota

Example syntax (note API key is fictitious):

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getSendQuota

Return Type: Integer

getHappinessValue

This method will return an integer (as a %age) showing the Happiness Factor (based on the last x values) for the account linked to the API Key used.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredgetHappinessValue (Will return value for the account, unless limited by variables shown below)
limitIntegerOptionalLimit number of results to take into account (current result first).
blastIDIntegerOptionalLimit results by Blast ID (found in URL bar on relevant Blast Breakdown page)
fromDatestringOptionalLimit results between a date range (format YYYY-MM-DD)
toDatestringOptionalLimit results between a date range (format YYYY-MM-DD)

Example syntax (note API key is fictitious):

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getHappinessValue&limit=100&blastID=12345&fromDate=2015-01-01&endDate=2015-02-01

Return Type: Integer

getNPSValue

This method will return an integer (either positive or negative) showing the NPS score for a specific Blast ID or for the account for the account linked to the API Key used.

Note, you could display an NPS score for your account for a single month for example.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredgetNPSValue (Will return value for the account, unless limited by variables shown below)
limitIntegerOptionalNumber of results to take into account (current result first). Limit must be defined in conjunction by Blast ID or Date Range currently.
blastIDIntegerOptionalLimit results by Blast ID (found in URL bar on relevant Blast Breakdown page)
fromDatestringOptionalLimit results between a date range (format YYYY-MM-DD)
toDatestringOptionalLimit results between a date range (format YYYY-MM-DD)

Example syntax (note API key is fictitious):

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getNPSValue

To return NPS score for a specific Blast – add the blastID element:

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getNPSValue&blastID=121212

To return NPS score for a specific time period – add the date element:

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getNPSValue&fromDate=2015-01-01&toDate=2015-02-01

Return Type: Integer

getTempRatingValue

This method will return an integer showing the Temperature Rating (as a percentage) for a specific Blast ID for the account linked to the API Key used.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredgetTempRatingValue (Will return value for the account, unless limited by variables shown below)
limitIntegerOptionalLimit number of results to take into account (current result first).
blastIDIntegerOptionalLimit results by Blast ID (found in URL bar on relevant Blast Breakdown page)
fromDatestringOptionalLimit results between a date range (format YYYY-MM-DD)
toDatestringOptionalLimit results between a date range (format YYYY-MM-DD)

Example syntax (note API key is fictitious):

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getTempRatingValue&blastID=12345

Return Type: Integer

getResponseRateValue

This method will return an integer (expressed as a percentage) showing the Response Rate for a specific Blast ID or for the account for the account linked to the API Key used. This will only take into account Email Thermometer Blasts and remove Embedded Blasts from the equation at account level.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredgetResponseRate (Will return value for the account, unless limited by variables shown below)
limitIntegerOptionalLimit number of results to take into account (current result first).
blastIDIntegerOptionalLimit results by Blast ID (found in URL bar on relevant Blast Breakdown page)
fromDatestringOptionalLimit results between a date range (format YYYY-MM-DD)
toDatestringOptionalLimit results between a date range (format YYYY-MM-DD)

Example syntax (note API key is fictitious):

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getResponseRateValue&fromDate=2015-01-01&toDate=2015-02-01

Return Type: Integer

getNumResponsesValue

This method will return an integer showing the number of Responses received for a specific Blast ID or for the account linked to the API Key used. Would like to define TIME banded variables here – so you could display the number of responses for an account for March.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredgetNumResponses
temperatureIDIntegerOptional1 (gold), 2 (green), 3 (yellow), 4 (red)
limitIntegerOptionalLimit number of results to take into account (current result first).
blastIDIntegerOptionalLimit results by Blast ID (found in URL bar on relevant Blast Breakdown page)
fromDatestringOptionalLimit results between a date range (format YYYY-MM-DD)
toDatestringOptionalLimit results between a date range (format YYYY-MM-DD)

Example syntax (note API key is fictitious):

Get total number of responses received

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getNumResponsesValue

Get total number of Gold responses received

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getNumResponsesValue&temperatureID=1

Get total number of Red responses received in July

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getNumResponsesValue&temperatureID=4&fromDate=2015-01-01&toDate=2015-02-01

Return Type: Integer

getBlastResults

This method will return an XML document showing the Responses received for a specific Blast ID or for the account linked to the API Key used.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredgetBlastResults  (Will return the last 200 results for the account, unless limited by variables shown below)
temperatureIDIntegerOptional1 (gold), 2 (green), 3 (yellow), 4 (red)
limitIntegerOptionalLimit number of results to take into account (current result first).
blastIDIntegerOptionalLimit results by Blast ID (found in URL bar on relevant Blast Breakdown page)
fromDatestringOptionalLimit results between a date range (format YYYY-MM-DD)
toDatestringOptionalLimit results between a date range (format YYYY-MM-DD)

Example syntax (note API key is fictitious):

Return XML document of last 200 results (all data attached)

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getBlastResults

Return XML document of last 200 Gold responses

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getBlastResults&limit=200&temperatureID=1

Return Type: XML

getComments

This method will return an XML document showing the comments received for a specific Blast ID or for the account linked to the API Key used.

Input Variables

Variable NameVariable TypeRequired / OptionalDescription
apiKeyStringRequiredYour API Key
getMethodStringRequiredgetComments  (Will return the last 200 results for the account, unless limited by variables shown below) 2992}
temperatureIDIntegerOptional1 (gold), 2 (green), 3 (yellow), 4 (red)
limitIntegerOptionalLimit number of results to take into account (current result first).
blastIDIntegerOptionalLimit results by Blast ID (found in URL bar on relevant Blast Breakdown page)
fromDatestringOptionalLimit results between a date range (format YYYY-MM-DD)
toDatestringOptionalLimit results between a date range (format YYYY-MM-DD)

Example syntax (note API key is fictitious):

Return XML document of last 200 results

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getComments

Return XML document of Comments left against a Gold response from the last 200 results

https://app.customerthermometer.com/api.php?apiKey=c2cb8788abfc1a0ff609ed3b1&getMethod=getComments&limit=200&temperatureID=1

Return Type: XML

Need more help? Get in touch...