This is v1.0 of our standard CustomerGauge XML comments and Net Promoter® Score API (Application Programming Interface). We have made it as simple to use as possible for widest possible use. See also our other feed documentation on our support page.
Using the XML API
You could use this to:
- display comments on intranet or external sites
- update internal systems and dashboards
- update CRM systems with score and comment using customer number as lookup
Available Fields
We provide in the feed as standard:
- Net Promoter Score (0 - 10)
- Customer Comment
- Translated Comment
- Customer Reference Number
- Various segments (country, store, channel)
- Date of comment/Score
- Product SKU (if available)
- Useful plain-english description of feed source if re-used in other places
- Date of feed
- Link to comment detail page in CustomerGauge
Security
It is available in secure mode (default) or open (no security). We are able to simply configure it depending on frequency of update and security needs.
Standard feed is secured with User Name and Password, using CURL in PHP or similar.
URL example: http://www.c1-gauge.com/sites/RSS/xxxFeedSecure.xml
Username: myfeed
password: mypass
Using the API - PHP example
Example using PHP:
<? PHP
$ch = curl_init();
$user = 'Acme';
$password = 'Acme1FeedExample';
curl_setopt($ch, CURLOPT_URL, "http://www.c1-gauge.com/sites/RSS/AcmeFeedSecure2.xml");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, "$user:$password");
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
$output = curl_exec($ch);
$info = curl_getinfo($ch);curl_close($ch);
echo $output;
?>
Once configured, you can test it using a testing page:
Testing page: https://www.cg-express.com/test/CurlPassword.php
API Format:
<?xml version="1.0" encoding="UTF-8" ?>
<channel>
<title>CustomerGauge Comment API</title>
<description>CustomerGauge API</description>
<link>https://www.c1-gauge.com</link><item>
<title>10</title>
<link>https://www.c1-gauge.com/sites/categorising.php?RAND=145XXXXXXX/link>
<description>The whole experience buying was easy & stress free. My headphones arrived swiftly & are comfortable to use. I am a great fan of Acme as I am still using the iron I was given as a wedding present in 1971. It has been in use daily & despite needing a couple of new flexes over the years has never once let me down. Well done Acme!</description>
<translatedComment></translatedComment>
<country>UK</country>
<channel>Public</channel>
<store>Acme Online Shop</store>
<commentDate>2010-08-06 </commentDate>
<pubDate>2010-07-20 17:27:13</pubDate>
<category>AcmeSHS390/10;</category>
<source>Testimony for customer ID 145XXXXXXX from Acme Online Shop, powered by CustomerGauge</source>
<guid>https://www.c1-gauge.com/sites/categorising.php?RAND=145XXXXXXX</guid></item>
...etc
Please contact us for details on help with setting it up and configuring.
