Surveys¶
Requires the "Surveys" permission.
A survey is a questionnaire that the operator asks the contact during the call (or right after): multiple-choice questions, text, numbers, dates, rating scales, even with different paths depending on the answers. The answers stay tied to the contact and the campaign, and you can analyse them in the Survey report.
A survey is created once in the Surveys page (CONFIGURATION → Surveys menu) and assigned to the campaigns you want, from the Survey module of the campaign form (see Configuring a campaign). The same survey can serve several campaigns.
Who has the permission
The Surveys permission is assigned from the Users page, in the Administrator box. To choose a survey in the campaign form the Campaigns or Surveys permissions are enough; to correct the answers of a contact from its record you need the Campaigns permission, the same as for editing the outcome (see Contact search and details).
The list of surveys¶
The page shows one row per survey, with the name (and below it the description, if any) and these columns:
| Column | What it shows |
|---|---|
| Name | The name of the survey |
| Fields schema | The dynamic-field schema of the survey, or None |
| Questions | How many questions it contains, of every level (information blocks count as questions) |
| Campaigns | How many campaigns use it |
| Responses | How many responses have been recorded (started or completed) |
Click a column header to sort. Click a row to edit the survey; + New survey at the top right creates one. If there are none, you see "No surveys yet. Create the first one with "New survey".".
At the end of each row there are two icons:
- Simulate the survey (the icon with the play symbol): opens the survey test, see Testing a survey;
- the trash can, to delete it, see Deleting a survey.
There is no function to duplicate a survey: to start from a similar one you have to create a new one.
Creating and editing a survey¶
Press + New survey (or click an existing survey): the New survey / Edit survey page opens, with three blocks: General details, Questions and Score bands. At the top right Cancel returns to the list without saving, Save saves and returns to the list with the notice "Survey saved.".
General details¶
| Field | What to write |
|---|---|
| Name | Required, at most 150 characters, different from all the other surveys (upper and lower case do not count) |
| Description | Optional, at most 500 characters |
| Dynamic fields schema | Optional. See Surveys and dynamic fields |
If the survey is already used by campaigns, "Associated campaigns:" appears below with their names. If it already has responses, a notice appears: "The survey has N recorded responses: questions and options that have answers cannot be deleted or have their type changed, they can only be deactivated. If you change the scores, the totals are recalculated." (see What can be changed when there are answers).
The questions¶
The Questions block contains the list of questions, with a counter "N / 100 questions". Press + Add question to add one (it starts as Single choice with two empty options). Each question is a card that opens and closes with a click on its row; Expand all and Collapse all open or close them all.
In the header of each question you see the number (1, 2, 3… and, in the branches, 1A, 1A1…), the text, the type (not visible on narrow screens) and, where applicable, the padlock indicating that it already has answers. On the right there are the Active switch (on narrow screens only the switch is shown, without the label), the Move up and Move down arrows (they change the position in the same list) and the trash can to delete it.
The Active switch is in the question header: a deactivated question is no longer asked to operators but stays in the reports marked "(deactivated)".
The Edit and Path preview buttons above the list switch between editing and the preview.
Inside the card you find:
| Field | What it does |
|---|---|
| Question text (for the information block: Text for the operator to read) | The text, at most 2000 characters. The Insert placeholder… menu adds a placeholder, see Surveys and dynamic fields |
| Answer type | How the operator answers (the question type), see the table below. It comes after the text |
| Type settings | Ends of the scale, limits of the number, date with time (see below) |
| Options | For choice types: the possible answers |
The question types¶
| Type | What the operator answers | Settings |
|---|---|---|
| Single choice | Only one of the listed options | At least two options; can have branches and the Other option |
| Yes/No | Yes or No | Exactly two options, already filled in with "Yes" and "No" (you can rename them); can have branches, but not the Other option |
| Multiple choice | One or more options | At least two options; can have the Other option |
| Short text | A line of text | None |
| Long text | A multi-line text | None |
| Number | A number | Minimum (optional) and Maximum (optional); if you give both, the minimum cannot exceed the maximum |
| Date | A date | With time switch: with the switch on the time is asked too |
| Scale | A whole value between two ends (for example from 1 to 5, or from 0 to 10) | Minimum value (0 or more), Maximum value (up to 100, greater than the minimum), Label for the minimum and Label for the maximum (optional, at most 100 characters each), The value counts towards the score switch. A new scale question starts from 1 to 5 |
| Information block | Nothing: it is a text the operator reads to the contact and confirms with Next | Only the text |
When you change the type of a question that already has options written or branches, Thelgo warns you with "Change the answer type?" ("Switching to “…” will discard some of the options you wrote or the branches linked to them. Do you want to continue?"): confirm with Confirm or Cancel.
The options¶
For choice questions, each option has:
| Element | What it does |
|---|---|
| Option text | The text of the answer, at most 500 characters (it can contain placeholders) |
| Points | The score of the answer, even negative or decimal (up to 4 decimals). See Scores and bands |
| Active | A deactivated option is no longer offered to operators; in the reports it stays with "(deactivated)" |
| End the survey | Only for Single choice and Yes/No: if the operator chooses this option, the survey ends immediately, even if there are more questions after it |
| Add questions to this answer | Only for Single choice and Yes/No: opens a branch, see below |
With + Add option you add more (not in Yes/No, which always has two). The Move up and Move down arrows reorder them; the trash can deletes the option (not in Yes/No).
With the Allow an "Other" answer with free text switch (in Single choice and Multiple choice questions) Thelgo adds the Other option at the end: if the operator chooses it, they must write a text. The Other option is only one per question, is always the last and cannot be moved; its text (default "Other") can be changed.
Branches: different paths depending on the answer¶
Single choice and Yes/No questions can open branches. With Add questions to this answer, the block "Questions if the answer is “…”" appears under the option: here you add (with Add question) the questions the operator must ask only if the contact chooses that answer. A branch can contain any type of question, including other questions with their own branches.
The operator follows this path:
- asks the first question;
- if the answer opens a branch, asks the questions of that branch first;
- then moves to the next question of the same level and, when the branch is finished, to the one of the upper level;
- if the chosen answer has End the survey, the survey closes immediately.
A question left "without an answer" does not open branches. The limits are 10 levels of depth and 100 questions in total (branches included): once the limit is reached, Add questions to this answer switches off with the explanation "Limit reached: at most 10 levels and 100 questions.".
Path preview¶
The Path preview button (next to Edit, above the list of questions) shows the whole survey as the operator would see it, with all the branches visible and no possibility to answer. Deactivated questions do not appear. To really test the path by answering, use the simulation instead.
Scores and bands¶
Each answer can give points, and the sum forms the contact's total score:
- each chosen option adds its Points (for multiple choice, the sum of all the chosen options);
- a Scale question adds the chosen value, if the The value counts towards the score switch is on (it is by default);
- only the questions of the path followed count: questions not asked, those left without an answer and information blocks are worth zero.
Score bands give a label and a colour to intervals of the total score (for example "Cold", "Warm", "Hot"). In the Score bands block press + Add band and fill in From and To (inclusive ends), Label (at most 100 characters) and Colour (one of the suggested shades or a colour of your choice). Click a band to edit it; the trash can deletes it. Bands must not overlap: if they do, the notice "The score bands "…" and "…" overlap." appears and saving is rejected. Bands are optional; scores that fall in no band are counted as No band in the report.
The score and the band are seen only by the administrator: the operator never sees scores or bands.
Surveys and dynamic fields¶
In the texts of questions and options you can use placeholders, which Thelgo replaces with the data of the contact and of the operator when the question is asked (for example "Good morning {{Nome}}, may I ask you a few questions?"). The Insert placeholder… menu above the question text adds the placeholder at the end of the text. The allowed ones are:
| Placeholder | Value |
|---|---|
{{Nominativo}} |
The name of the contact |
{{Nome}}, {{Cognome}}, {{RagioneSociale}}, {{Indirizzo}}, {{NumeroCivico}}, {{Cap}}, {{Comune}}, {{Provincia}}, {{Telefono1}}…{{Telefono9}}, {{Email}}, {{Url}}, {{IDRif1}}, {{IDRif2}} |
The standard fields of the contact |
{{Operatore.Nome}}, {{Operatore.Cognome}}, {{Operatore.Username}}, {{Operatore.Email}} |
The data of the operator asking the question |
| The dynamic fields of the database | Only if the survey has a dynamic fields schema (see below), with the name of the field ({{Field name}}) |
The appointment and agent placeholders ({{Appuntamento.…}}, {{Agente.…}}) cannot be used in a survey: Thelgo answers "The placeholder {{…}} cannot be used in a survey.".
The Dynamic fields schema field in General details serves two purposes:
- with a schema, questions can use its fields as placeholders and the survey can be chosen only by campaigns whose database has that schema (see Dynamic database fields);
- without a schema (None), the survey uses only the standard fields and can be chosen by all campaigns.
The schema can no longer be changed after the survey has been assigned to a campaign: the drop-down stays off with the explanation "The schema cannot be changed because the survey is associated with one or more campaigns.". If you rename a dynamic field in the Dynamic database fields page, the placeholders that mention it in the questions and options of the surveys of that schema are updated; a field mentioned in a survey cannot be deleted (the window lists "N questions or options of surveys"). For the same reason the schema of a database cannot be changed if one of its campaigns uses a survey tied to the current schema: "The dynamic fields schema cannot be changed because these campaigns use a survey tied to the current schema: …".
What can be changed when there are answers¶
As long as no contact has answered, you can edit the survey freely. When there are recorded answers (the rows with the padlock), some changes are forbidden so as not to distort the data already collected:
| Change | When there are answers |
|---|---|
| Editing texts, Points, labels, bands, limits | Allowed |
| Reordering questions and options in the same list | Allowed |
| Deactivating a question or an option | Allowed: it is the way to remove it from the questionnaire without losing data |
| Deleting a question or an option that already has answers | No: the trash can is off and the save window answers ""…" cannot be deleted because it already has answers: deactivate it instead." |
| Changing the type of a question with answers | No: the Answer type drop-down is off ("The type cannot be changed because the question has answers.") and the server answers "The type of the question "…" cannot be changed because it already has answers: deactivate it and add a new one." |
| Moving a question with answers (or with answers in its branches) to another branch or from the first level to a branch | No: "The question "…" cannot be moved to another branch because it already has answers." |
| Removing the Other option already chosen in some answer | No: it can only be deactivated |
| Changing the dynamic fields schema | No if the survey is used by a campaign |
If you change the Points of an option (or the The value counts towards the score switch of a scale) in a survey that already has responses, the totals already recorded must be recalculated. When you press Save, Thelgo shows the window "Recalculate the scores?" ("This change alters the points: the total of N contacts will be recalculated."): with Save and recalculate you confirm, with Cancel nothing changes. The operation is recorded in the Audit log with the points before and after. Deactivating or reactivating questions and options does not change any total.
Testing a survey¶
The Simulate the survey icon on the survey row opens the fill-in window as the operator sees it, with a sample contact, and unlike the operator it also shows you the Total score and the Band in the final summary. At the top you see "Simulation: answers are not saved and the contact is a sample one.": nothing is saved and nothing ends up in any report. Use it to check branches, scores and bands before assigning the survey to a campaign. How to fill in the window is described in Filling in a survey.
Assigning a survey to a campaign¶
In the campaign form, at the Modules and operators step, the Survey module box enables the survey for the campaign:
- turn on the Survey module switch (it is not available for VoiceAI campaigns);
- choose the Survey from the "Choose a survey" drop-down. The surveys offered are those without a schema and those tied to the dynamic-field schema of the campaign's database; if there are none, "No survey is available for this campaign's database." appears with the Go to the Surveys page link (if you have the Surveys permission). With the module on, a survey must be chosen, otherwise saving is rejected;
- if you want, turn on Survey required for positive outcome: the operator cannot save a Positive outcome until the survey is completed (see Outcomes and callbacks);
- save the campaign.
The survey of a campaign cannot be changed after the first answer has been recorded: "The survey cannot be changed once the first answer has been recorded.". If you turn off the Survey module operators no longer see the survey, but the answers already recorded stay and the survey remains assigned to the campaign (it keeps counting in the Campaigns column). If you save the campaign with the module off, Survey required for positive outcome is switched off too: when you turn the module back on, switch it on again.
Deleting a survey¶
The trash can on the row opens the Delete survey window ("You are about to permanently delete the survey …"): type the word delete and confirm. A survey cannot be deleted if:
- it is used by a campaign: the trash can is off with the explanation "It cannot be deleted: the survey is associated with one or more campaigns." and the server answers "The survey cannot be deleted because it is used by these campaigns: …". To delete it you must first assign those campaigns another survey (possible only while they have no answers) or delete the campaigns;
- it has recorded responses: "The survey cannot be deleted because it has N recorded surveys.".
Error messages¶
If saving a survey is rejected, the message appears in red at the top of the page. The main ones:
| Message | What to do |
|---|---|
| "The survey name is required." | Write the Name |
| "The survey name cannot be longer than 150 characters." / "The survey description cannot be longer than 500 characters." | Shorten the text |
| "A survey named "…" already exists." | Choose another name |
| "Every question needs a text." / "A question text cannot be longer than 2000 characters." | Fill in or shorten the question text |
| "The question "…" needs at least two options." | Add options to choice questions |
| "The yes/no question "…" must have exactly two options." | Yes/No always has two options |
| "Every option of the question "…" needs a text." / "An option text cannot be longer than 500 characters." | Fill in or shorten the option text |
| "The question "…" cannot have options: only single choice, yes/no and multiple choice questions can." | Remove the options or change the type |
| "Only single choice and yes/no questions can open branches: remove the branch of the question "…"." | Branches open only from Single choice and Yes/No |
| "Only single choice and yes/no questions can end the survey: remove it from the question "…"." | End the survey applies only to Single choice and Yes/No |
| "The yes/no question "…" cannot have an "Other" option with free text." / "The "Other" option with free text of the question "…" must be only one and the last of the options." | Other is not allowed in Yes/No, is one per question and goes at the end |
| "The scale question "…" needs a minimum and a maximum value." / "The scale of the question "…" is not valid: the minimum must be at least 0, the maximum at most 100 and greater than the minimum." | Correct the ends of the scale |
| "The minimum of the number question "…" cannot be greater than the maximum." | Correct the limits of the number |
| "The labels of a scale cannot be longer than 100 characters." | Shorten the labels |
| "The survey cannot have more than 10 levels of questions." / "The survey cannot have more than 100 questions." | Reduce the structure |
| "The placeholder {{…}} cannot be used in a survey." | Use only the allowed placeholders (see Surveys and dynamic fields) |
| "Every score band needs a label." / "A score band label cannot be longer than 100 characters." / "The score band "…" needs a color (at most 20 characters)." | Fill in the band |
| "The score band "…" is not valid: the start cannot be greater than the end." | Correct From and To |
| "The score bands "…" and "…" overlap." | Correct the intervals |
| "The selected dynamic fields schema does not exist." | Choose another schema |
| "The dynamic fields schema cannot be changed because the survey is used by at least one campaign." | The schema stays as it is |
| "The change alters the scores: the totals of N recorded surveys must be recalculated. Confirm the recalculation to continue." | Confirm with Save and recalculate |
| ""…" cannot be deleted because it already has answers: deactivate it instead." / "The type of the question "…" cannot be changed…" / "The question "…" cannot be moved to another branch…" | See What can be changed when there are answers |
The campaign-form errors related to the survey are described in Configuring a campaign.
Where you see the answers¶
- For each contact, in its detail record (status, score, band, answers);
- for the whole campaign, in the Survey report (the Survey section of the Campaign report), with charts and statistics;
- in the export files of the campaign's contacts, with the survey columns (see the Survey report).
The changes made to the survey and to its answers are recorded in the Audit log: Survey created, Survey edited, Survey deleted, Survey scores recalculated and Survey answers changed after completion.