A report listing individual survey responses can be accessed using the URL described below. Depending on the parameters used, the report is either emailed to the CIOPulse administrator, a Support Lead, or the email address specified in the sendto parameter.
On the 1st of each month, Contacts are also automatically sent this report, containing the survey responses for all the Support Groups they are associated with as a Support Lead or Also Alert.
The report is available as a PDF or a CSV file.
The Survey Responses report provides:
- The selection criteria specified via the parameters in the URL. And the timezone used for the Date column.
- The date the feedback was received.
- The ID of the customer who completed the survey and the ticket number that the survey is in relation to (if set up in the Portal, this ticket number will be hyperlinked to the ticket in your customer support tool).
- The two Segments that the customer belongs to. 'No segment' is shown where a survey response hasn't been associated with a segment.
- The ID of the agent that resolved the ticket and the Support Group they belong to.
- The experience factors selected in Q2 as influencing the given Q1 rating. For Detractors and Passives (row shown in red or orange), the selected experience factors are shown as crosses. For Promoters (row shown in green), the selected factors are shown as ticks. Unselected factors are shown as hyphens.
- The overall satisfaction rating given in Q1.
- When
srn=yis specified in the URL, a pencil icon hyperlink is shown to access the Service Recovery Notes dialog box for that survey. - Verbatim feedback given in response to Q3. When
srn=y,the report will also include any Service Recovery Notes after the verbatim feedback.
The report is able to display feedback given in common single-byte languages (e.g. English, French, Italian, German, Spanish, Arabic or Hebrew), as well as common double-byte languages (e.g. Chinese, Japanese, Korean). However, due to technical limitations of PDF production, it cannot display emoji characters. Emoji characters appear as empty squares.
CSV Format
When the report is requested as a CSV, the CSV file contains the same information as shown on the PDF report.
The main difference is the experience factors (as selected in Q2 of the survey):
- The column headings in the CSV are the full names of each factor, e.g. Responsiveness instead of Re.
- For Detractors and Passives, the selected factors are given as -1s. For Promoters, the selected factors are shown as 1s. Unselected factors are shown as 0s.
Forming the URL
To request a Survey Responses report, use this URL
https://app.cio-pulse.com/survey-responses-nps?cpc={your Client Portal Code}
You can use any of the following parameters, prefixing each parameter name with a &.
These parameters define the entity you want to view the surveys for:
-
rgidOptional. Include surveys for the Team or Department with this Support Group Code. When omitted, the gauge will include surveys for all Support Groups. -
sgid1Optional. Include surveys for this Customer Segment 1. -
sgid2Optional. Include surveys for this Customer Segment 2. -
combineOptional. Wheny, includes surveys for the Department specified inrgidand the Teams that belong to that Department. Whenn, includes only surveys received for the Department and not for its Teams. This parameter is ignored when the Support Group Code specifies a Team rather than a Department. Defaults ton. You can learn more about how thecombineparameter works, in this article. -
cidOptional. Specify a customer id to include the survey responses from this Customer. -
agidOptional. Specify an agent id to include the survey responses for this Agent.
These parameters control the appearance of the report and who it is sent to:
-
sortOptional. Specify a sort sequence from five predefined options,1-5. (refer below for more information). -
formatOptional. The format of the report,csvorpdf. -
srnOptional. Wheny, shows Service Recovery Notes against each survey response where notes have been recorded. Also, wheny, a hyperlinked pencil icon is shown at the far right of each row. Clicking on the icon displays the Service Recovery Notes dialog box for this survey. Defaults ton. In addtion toyandn, thesrnparameter has other values. These other values filter the surveys shown on the report, and so these values are described under the 'Additional filter parameters' section below. -
extraOptional. This parameter requires no value. Adds Support Group Code, Support Lead Name and Support Lead Email to each row of the CSV. Whensrn=y, the URL for the Service Recovery Notes dialog box is also added to each row of the CSV. -
sendtoOptional. Specify who to email the report to -admin,lead,selector an authorised email address, e.g.[email protected]. See Understanding the &sendto parameter below for more information.
These parameters define the period of time you want to the report to cover:
-
limitOptional. Specify a number,n, to limit the number of survey responses to the most recentnsurveys that meet the selection criteria.nmust be10000or less. -
lastnpsOptional. This parameter requires no value. Include only the surveys that were used to calculate the latest Net Promoter Score (as shown on the NPS Gauge) for the selected entity. The most recently calculated score will usually be the current 30-Day NPS. However, if no surveys were received in the last 30 days, the most recently calculated score will be the Calendar NPS for the last month in which surveys were received. -
30dOptional. This parameter requires no value. Include just the surveys that were used to calculate the current 30-Day NPS for the selected entity. -
eomOptional. This parameter requires no value. Include just the surveys received in the previous calendar month. -
currentOptional. This parameter requires no value. Include just the surveys received in the current calendar month. -
fromOptional. Include responses received on or after this date,yyyy-mm-dd. -
toOptional. Include responses received on or before this date,yyyy-mm-dd. -
periodOptional. Include just the surveys for the specified month, e.g.period=2019-11. -
fromperiodandtoperiodOptional. Include just the surveys for the specified period range, e.g.fromperiod=2019-01&toperiod=2019-06.
Additional filter parameters:
-
minOptional. Includes survey responses where overall satisfaction rating > = this value (1-10). -
maxOptional. Includes survey responses where overall satisfaction rating < = this value (1-10). -
srnOptional.srn=r, include only surveys that need recovery (i.e. where the rating falls below your Service Recovery threshold).srn=x, include surveys that need recovery but have no Service Recovery (SR) Notes.srn=w, include only surveys with SR Notes.srn=v, include only surveys with SR Notes, but where the customer has never been spoken to.srn=s, include only surveys with SR Notes and where the customer has been spoken to.srn=y, display SR Notes (where they exist), but do not filter the surveys in the report. All these settings will show SR Notes against each survey response, where notes have been recorded. Also, a hyperlinked pencil icon is shown at the far right of each row. Clicking on the icon displays the SR Notes dialog box for this survey. Defaults tosrn=n(don't display SR Notes and don't filter by service recovery information).
lastnps does exactly the same as gauge=y on previous versions of the report. gauge=y is still supported.
All dates and periods are in your local timezone. Your local timezone is set in your Organisation Preferences
The CSV extract and PDF report are both limited to a maximum of 10000 survey responses.
Understanding the &sendto parameter
The sendto parameter is used to specify who to email the Survey Responses report to: admin, lead, select or an authorised email address, e.g. [email protected].
When lead specified, the report will be emailed to the support lead of the Support Group with the specified Support Group Code.
When sendto=admin is specified, the report will be emailed to the 'Send-to Administrator' specified in your Instance Preferences. If the the 'Send-to Administrator' field is blank in your Preferences, CIOPulse will send the report to the Master Administrator for your organisation.
When sendto=select, a dialog box will appear, enabling you to choose from a list of authorised recipients. The recipient list will consist of:
- The Support Lead (when
&rgid=is used in the URL). - Also Alerts (when
&rgid=is used in the URL and 'Also Alerts for SR Only' = 'No' in your Instance Preferences) - The Additional Send-to Recipients and Monthly Report Recipients as maintained in your Instance Preferences.
- The Master Administrator and any Supporting Administrators for the instance.
Omitting the sendto parameter is the same as specifying sendto=lead when rgid is specified, otherwise defaults to sendto=admin.
If you need to specify an email address in the sendto parameter that includes a plus sign, replace the plus sign with the characters %2B. For example, instead of [email protected], use sendto=donald%[email protected]. This is necessary because plus signs are valid characters in an email address but have a special meaning in URLs.
Sort sequences
The sort parameter is used to sort the survey responses in the PDF report.
The sort parameter accepts any of these values:
-
1Survey response date, ascending (default sort sequence when asortoption is not specified). -
2Survey response date, descending. -
3Overall satisfaction score, ascending. -
4Overall satisfaction score, descending. -
5Support Group name, ascending.


