"The simplicity of the Traffic Light Feedback system is perfect. Nobody has time to fill in a complicated questionnaire these days...
...The short, snappy nature of Traffic Light Feedback means that it literally takes seconds for customers to respond - and the feedback is invaluable." ~ Chris Coney, Upright Solutions
"...At the end of the day, there is nothing like proactive aftercare to drive a company forwards. It is like I said above: one thing is going somewhere, and another thing is going far. Services like this one make no distance insurmountable." ~ RogerH, KillerStartups.com
The SOAP API is not available for demo accounts and is meant only for software/web developers. It is provided as an integration method and is only for advanced usage.
The SOAP (Simple Object Access Protocol) API (Application Programming Interface) allows you to connect to Traffic Light Feedback and use its functionality from other applications. A good example of this is to automatically add customers to the customer lists within TLF. These customers could come from your accounts software, existing CRM, ecommerce website or anything else you can think of.
Below is a list of methods accessible by SOAP XML after logging in using your api key and username (automatically given to you upon registration). Example usage via a PHP SOAP client is shown below. The connection WSDL URL is given on the customer lists screen once logged into TLF.
Authenticates the user and creates a TLF Soap session.
// Create a session using the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
@param string $web_service_user
@param string $web_service_key
@return string
Ends an existing Traffic Light Feedback web service session.
// Create a session passing the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
// Log out of the current web service session
if ($client->logout($session_id))
{
echo "Logged out successfully!";
}
@param string $session_id
@return boolean
Adds or updates a Customer object within TLF. Pass the web service session id along with the attributes required to add or update a customer. Customers are updated based on the email address. Returns the customer ID on success and SoapFault on fail.
// Create a session passing the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
// Create the new/existing customer attributes
$attributes = array('customer_list_id' => 2,
'reference' => 'CUST007',
'company_name' => 'Joe Bloggs Widgets Ltd.',
'title' => 'Mr',
'first_name' => 'Joe',
'last_name' => 'Bloggs',
'email' => 'joe.bloggs@example.com',
'telephone' => '0845 555 555',
'is_active' => 1);
// Create/update the customer
$customer_id = $client->addCustomer($session_id, $attributes);
// Logout of the current web service session
$client->logout($session_id);
@param string $session_id
@param array $attributes
@return integer
Returns a list of customers within a Traffic Light Feedback customer list
// Create a session passing the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
// Get the list of customers passing the web service session id and customer_list_id
$customers = $client->listCustomers($session_id, 2);
// Logout of the current web service session
$client->logout($session_id);
@param string $session_id
@param integer $customer_list_id
@return array
Sets the active state (is_active) of a Customer. returns the customer_id on success and SoapFault on fail
// Create a session passing the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
// Sets the is_active state of Customer id of 7 to true
$customer_id = $client->setCustomerState($session_id, 7, true);
// Logout of the current web service session
$client->logout($session_id);
@param string $session_id
@param integer $customer_id
@param boolean $is_active
@return integer
Returns a single customer based on their customer id. Returns a customer array on success and a SoapFault on fail.
// Create a session passing the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
// Returns the information for customer id 7
$customer = $client->getCustomer($session_id, 7);
// Logout of the current web service session
$client->logout($session_id);
@param string $session_id
@param integer $customer_id
@return array
Returns a list of customer lists for your company
// Create a session passing the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
// Returns customer lists for your company
$customer_lists = $client->listCustomerLists($session_id);
// Logout of the current web service session
$client->logout($session_id);
@param string $session_id
@return array
Deletes a customer based on their id. Returns TRUE on success and FALSE on fail.
// Create a session passing the web service user and key
$session_id = $client->login('web_service_user', 'web_service_key');
// Deletes a customer with id 7
if ($client->deleteCustomer($session_id, 7))
{
echo "Customer has been deleted!";
}
// Logout of the current web service session
$client->logout($session_id);
@param string $session_id
@param integer $customer_id
@return boolean