> For the complete documentation index, see [llms.txt](https://docs.fullwhere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md).
# Satisfaction surveys
Satisfaction surveys allow you to collect feedback from your customers after an experience, measure satisfaction across different criteria (NPS, CSAT, etc.), and automate sends according to your communication channels (email, SMS, WhatsApp, QR Code).
{% hint style="info" icon="shield-check" %}
**ACCESS RIGHTS**
To edit the Surveys in your Fullwhere workspace, you must be a supervisor member with Administrator rights.
{% endhint %}
## Access your surveys
In the navigation menu, go to the section [Surveys](https://app.fullwhere.com/forms/survey).\
There you will find the list of all existing surveys, their status (Active / Inactive), their creator, and their creation date.
You can:
* Create a new survey via the button `+ Create a survey` ;
* Search for a survey using the search bar;
* Activate / deactivate a survey with the button *Activate / Deactivate* ;
* Access a survey's settings by clicking its name.
***
## Create a new survey
Click on + Create a survey, then fill in the basic information in the right-hand side panel:
* Survey name: internal name, not publicly visible to your customers.
* Description (optional): useful for specifying the survey's purpose or usage period.
* Sending channels: select the channels through which the survey will be distributed (Email, SMS, WhatsApp).
* Survey language: indicate the language in which the survey will be written.\
→ You will be able to enable automatic translation to adapt the survey to the customer's language. For optimal translation, it is important that the survey language is set to the language in which you wrote it.
* Public accessibility: makes the survey link accessible without authentication (useful for sends via direct link or QR codes).
* Survey targets: define the brands and/or locations concerned by the survey, for which you will want to send or obtain a specific survey link.
These elements can be modified at any time.
***
## Navigating the different menus
The navigation menu at the bottom right lets you configure the different sections of your satisfaction survey.
The landing pages section:
This section lets you configure the general settings of your survey as well as the different landing pages of your satisfaction survey:
* the [survey page](/documentation/documentation-en/capture/satisfaction-surveys.md#h_fd6c17647b)
* the [thank-you page](https://help.fullwhere.com/fr/articles/12703199-les-enquetes-de-satisfaction#h_e7a846fde6)
* the [redirect page](https://help.fullwhere.com/fr/articles/12703199-les-enquetes-de-satisfaction#h_d2a178d4d6)
The sending modes section:
This section lets you configure the different sending modes enabled on your survey:
* [email](#h_40f57ea6e5)
* [SMS](/documentation/documentation-en/capture/satisfaction-surveys.md#h_d6a5ae0584)
* [WhatsApp](#h_eb4ddaa177)
The target entities section
This section lets you configure the [target entities](https://help.fullwhere.com/fr/articles/12703199-les-enquetes-de-satisfaction#h_916cfaa276) of your survey.
***
## Main page of your survey
The main page of your survey contains the different fields that your customers will need to complete.
The editor is made up of three main sections:
* Left section → adding and designing elements;
* Center section → editing and real-time preview;
* Right section → general survey settings.
### Customize the survey header
The header helps strengthen the visual identity of your survey and is shared across the different landing pages of your survey.\
It includes:
* A logo (brand or location logo);
* A cover photo, adjustable in height for optimal framing.
***
### Add a footer
You can enrich your form by adding a footer (or *footer*) to strengthen your brand image and make navigation to your external channels easier.\
The footer can contain:
* an image (for example a secondary logo or an illustration);
* two texts, one before and one after the image, (legal notices, additional information, etc.);
* and external links to your social pages or your website
The footer is shared across the different landing pages of your survey.
***
### Add and configure fields
The available fields are accessible from the Elements tab in the left section.\
They can be added by drag-and-drop into the center area and organized into one or two columns.
**Available field types**
* Customer identity
* Title → customer's salutation (Mr., Mrs., etc.).
* Last name → customer's last name
* First name → customer's first name
* Email address → customer's email
* Phone number → customer's phone number
{% hint style="warning" %}
It is not necessary to include these fields for automated satisfaction survey sends. Indeed, the customer's identity will already be known and their satisfaction survey will be linked to their profile.
{% endhint %}
* **Information**
* Files to send → allows uploading one or more files (attachment, proof of purchase, etc.).
* Calendar → adds a date selection field (useful for an appointment or an order).
* Order reference → text field intended to enter an existing order number. It is not necessary to collect this information in the case of an automated send already linked to a purchase.
* **Options**
* Multiple choice (checkbox) → allows selecting several options from a defined list.
* Single choice (radio) → offers a list where only one option can be selected.
* Dropdown list (dropdown) → similar to single choice but in dropdown menu form.
* **Ratings**
* NPS → allows you to retrieve a customer's NPS (Net Promoter Score). The classic wording of the NPS question should be "Would you recommend our company to a friend or colleague?"\
You can only add one NPS question to your survey. To collect multiple ratings on different topics, prefer CSAT Stars or CSAT Smileys questions.
* CSAT - Stars → allows you to rate specific topics in the form of a star between 1 and 5 (Example: What rating would you give the welcome?).
* CSAT - 5 smileys → allows you to rate specific topics using smileys ranging from Dissatisfied to Very satisfied (Example: How was your experience with our after-sales service?).
* **Texts**
* Short text → free-text field on a single line (ideal for a heading, a remark, etc.)
* Long text → main text field of the satisfaction survey allowing you to collect the customer's comment. A survey can contain only one Long text field.
* Group → structural element allowing you to group several fields under the same block to which you can assign a title.
Fields can be:
* Reorganized by drag-and-drop (up to 2 per line);
* Deleted via the corresponding icon;
* Configured individually (via the cogwheel).
These options appear when hovering over a form field.
#### Advanced field settings
Each field can be configured via the cogwheel visible on hover:
**Conditional display**
You can define trigger conditions to display a field only if certain conditions are met (e.g. display a clarification question only if the score is below 6).\
The conditions can be combined with AND / OR operators.
To add conditional logic to a field, click the ⚙️ to the right of the field, then click Trigger conditions.\
You can then define the conditions under which the selected field should be displayed.
**"Other" field for choice questions**
For choice-type fields, you can enable the option *"Other" field*, allowing the customer to enter a free response if no option matches.
**Set selection limits for multiple choice**
For Multiple choice (checkbox) fields, you can define a minimum and/or maximum number of options that the user must select.\
These settings help control response validity and avoid omissions or excessive selections.
* Minimum choice → requires the user to check at least a certain number of options before being able to submit the form.
* Maximum choice → limits the number of options the user can select in order to restrict the response to a specific amount.
**Duplicate a field**
You can use the Duplicate option to instantly create a copy of the selected field.\
This feature saves time when creating forms with similar fields (for example several single choice or short text questions).
The duplicated field automatically retains:
* the type of the original field (text, choice, list, etc.);
* the formatting and option settings (values, required field,...)
Note that display conditions are not duplicated.
***
### Customize the design
The Design tab in the left section lets you define the colors, typography, and visual styles of your survey.
You can modify the typography of your form using Google Font typography.
#### Primary colors
* title: color of the form title
* subtitle: color of the form subtitle
* section: color of the field group name
* separator: color of the separators between field groups
* visual accent: color of radios, checkboxes, and focused fields
* background: the form background color
#### Field colors and customization
* title: the color of the field name
* text: the color in which the customer writes in text fields
* placeholder title: the color of the field placeholder titles
* background: the field background color
* option: the color of options for single choice (radio) and multiple choice (checkbox) fields
* rounded corners: the field's corner radius among 3 possible options
* border: the color of the field border.
#### Button colors and customization
* text: the color of the button text
* background: the button background color
* rounded corners: the button's corner radius among 3 possible options
* border: the color of the button border
#### Footer colors
* background: the footer background color
* text: the color of footer text
* icons: the color of the footer social media icons
***
### General settings
You can find the survey's general settings in the right-hand section:
* Survey name and description;
* Enabled sending channels (Email, SMS, WhatsApp);
* Language and automatic translation;
* Survey link (to copy for sharing);
* Automatic redirection (before or after the survey, with configurable threshold);
* Sending limit: minimum number of days between two requests for the same customer (with option to apply by target entity);
* Restriction to recent data: limits sending to recent interactions (for example the last 2 days).
***
## Thank-you page
The Thank-you tab lets you customize the message displayed after the survey is submitted.\
You can add a title, text, and an image.
The general design of the thank-you page is inherited from the design of your survey's main page.
***
## Automatic redirection and Redirect page
Surveys allow automatic redirections to an external URL (for example Google Reviews or TripAdvisor).
You can configure two types of redirection:
* Before survey → allows routing customers based on an initial score they assign during the survey;
* After survey → according to the average of the scores given to rating-type questions and the defined redirection threshold.
#### The pre-survey redirection.
Pre-survey redirection can be done directly via the Choice block in the email template if you use this sending mode. See [Email](/documentation/documentation-en/capture/satisfaction-surveys.md#h_40f57ea6e5).
For other distribution modes, pre-survey redirection requires setting up the Redirect page, including:
* your survey logo
* your survey's cover photo
* a question (e.g. *How would you rate your experience?*)
* a *call to action* (*e.g. Give us your feedback by clicking on one of the following options)*
* a redirection block, which can be of the following type:
* NPS
* CSAT - Stars
* CSAT - 5 Smileys
* CSAT - 2 Smileys (binary)
The redirection block will determine whether the customer is redirected to the external URL or to your survey based on the redirection threshold you configure and the choice made by the customer.
Redirections require the prior configuration of redirection URLs on the survey's target entities ([see specific section](#h_8ad7c88c33)).\
***
## Define target entities
From the Target entities tab, you can define the brands and/or locations concerned by the survey. Defining a target entity makes it possible to enable sends or obtain a specific link for a location or a brand.
\
In the target entities tab, for each target you will find:
* The associated area (location or brand);
* The redirection URL (to Google, TripAdvisor, etc.) if defined. Must be defined for the [redirection](#h_d2a178d4d6) before or after the survey to be available for this target entity.
* The survey link specific to this entity (location or brand);
* The status (enabled or disabled).
***
## Configure sending channels
Surveys can be distributed automatically by Email, SMS, or WhatsApp.\
Each channel has its own settings in the corresponding section.
### Email
* Sending email address: by default, satisfaction survey emails are sent from a @fullwhere-mail.com address. If you want to send your satisfaction surveys with your own email address, you must [connect it to Fullwhere](/documentation/documentation-en/getting-started/brands.md#h_97ac72314e). We recommend this option, which improves the deliverability of your emails.
* Sender: sender of the email visible in your customers' inbox
* Email subject: subject of the email received by your customers
* Send schedule: delay before sending (e.g. 1 day after the visit), sending days, time.
* Automatic follow-up: possibility to follow up with non-respondents (number of follow-ups and delay between follow-ups).
* Advanced sending conditions: to filter according to specific criteria (for example visit type, purchase channel, customer email...).
#### Configure the email template
The email template determines the appearance and content of the email received by your customers when they are invited to answer the survey.\
The editor lets you customize both the layout, the text, and the visual elements to ensure an experience consistent with your brand.
You can add different content blocks by clicking the buttons available in the center area:
* Title → main sentence of your email (*e.g. Hello, thank you for your purchase*)
* Subtitle → to introduce the request (e.g. *We would love to hear your feedback*).
* Paragraph → to ask the main question (e.g. *On a scale of 1 to 5, how would you rate your experience?*).
* Choice block → the choice block determines the *call to action* present in the email.\
It can be of different types:
* NPS
* CSAT - Stars
* CSAT - 5 Smileys
* CSAT - 2 Smileys (binary)
* Button
{% hint style="info" %}
💡 If pre-survey redirection is enabled, the choice block will act as a redirection block and redirect your customers to the external URL or to the survey depending on the Redirection Threshold selected in the email template.\
If pre-survey redirection is enabled and you select a Button-type Choice block, customers will be redirected to the [Redirect page](/documentation/documentation-en/capture/satisfaction-surveys.md#h_d2a178d4d6).
If pre-survey redirection is not enabled, customers will be redirected directly to the survey regardless of the Choice block offered and the click made by the customer.
{% endhint %}
* Thank-you block → message displayed at the end of the email (e.g. *Thank you for your participation!*).
* Link → adds a link (to your legal notices, privacy policy, website, etc.).
The email header can include a logo and a cover image.
{% hint style="info" %}
✍️ All email text can be built using variables to personalize it according to each customer.\
[See variables](#h_bd8c318c41).
{% endhint %}
### SMS
* SMS sender → Name displayed when the SMS is received (11 characters maximum).
* SMS text → text that makes up the SMS. The SMS text must include the {{url}} variable, which will display the link to your survey.\
An SMS is a message containing between 1 and 160 characters and 2 SMS between 161 and 306 characters. The number of SMS determines the number of SMS credits consumed for each send.
* Send schedule: delay before sending (e.g. 1 day after the visit), sending days, time.
* Automatic follow-up: possibility to follow up with non-respondents (number of follow-ups and delay between follow-ups).
* Advanced sending conditions: to filter according to specific criteria (for example visit type, purchase channel, customer email...).
{% hint style="info" %}
💡 If pre-survey redirection is enabled, customers will be redirected to the [Redirect page](#h_d2a178d4d6).\
If pre-survey redirection is not enabled, customers will be redirected directly to the survey.
{% endhint %}
{% hint style="info" %}
✍️ The SMS text can be built using variables to personalize it according to each customer.\
Note: using variables can increase the length of the SMS, and therefore the number of credits consumed depending on the replacement values.
\
[See variables](#h_bd8c318c41).
{% endhint %}
### WhatsApp
* The WhatsApp Template\
Sending satisfaction surveys via WhatsApp must go through the use of a WhatsApp template.\
This template must be linked to a WhatsApp Business account [connected to Fullwhere](/documentation/documentation-en/integrations/connect-instagram-facebook-and-whatsapp.md).
{% hint style="warning" %}
📣 Your WhatsApp template must meet certain standards to be used correctly with Fullwhere surveys.\
[Discover our complete guide here.](/documentation/documentation-en/capture/use-a-whatsapp-template-for-your-satisfaction-survey.md)
{% endhint %}
* SMS fallback option: if WhatsApp sending fails because the person doesn't have WhatsApp, allows sending a "backup" SMS. For the configuration of this SMS, see the section [SMS](/documentation/documentation-en/capture/satisfaction-surveys.md#h_d6a5ae0584).
* Send schedule: delay before sending (e.g. 1 day after the visit), sending days, time.
* Automatic follow-up: possibility to follow up with non-respondents (number of follow-ups and delay between follow-ups).
* Advanced sending conditions: to filter according to specific criteria (for example visit type, purchase channel, customer email...).
***
## Go live
Once your survey is configured:
* Save your changes at any time;
* Preview the survey via the button *Preview* (top right);
* Activate the survey with the button *Activate* to make it available through the selected channels.
Surveys can be modified at any time, then reactivated without loss of history.
***
## Use variables to personalize your surveys
Variables make it possible to automatically personalize your survey content according to the customer, the brand, or the associated order.\
They are dynamically replaced at the time of sending, which makes each communication unique and more engaging.\
For example: writing in an email *"Hello {{customer\_first\_name}}"* will display to the customer *"Hello Jérôme"*.
Using variables strengthens closeness with your customers, improves response rates, and ensures a consistent and personalized experience across all channels.
### Variables usable in emails and SMS
The following variables can be inserted directly into your email text or into the SMS text
| Variable | Description |
| ------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `{{store}}` | [Public name](/documentation/documentation-en/getting-started/locations.md#h_bc9834e24a) of the location |
| `{{store_signature}}` | Location signature |
| `{{brand}}` | Brand name |
| `{{brand_signature}}` | Brand signature |
| `{{signature}}` | Location signature if it exists, otherwise the brand signature |
| `{{customer_first_name}}` | Customer's first name |
| `{{customer_last_name}}` | Customer's last name |
| `{{customer_full_name}}` | Customer's full name |
| `{{customer_civility}}` | Customer salutation |
| `{{customer_feedback_count}}` | Total number of feedbacks given by the customer |
| `{{customer_purchase_count}}` | Total number of orders placed |
| `{{customer_purchase_count_1}}` | Total number of orders placed + 1 (useful for a loyalty message) |
| `{{customer_purchase_amount}}` | Total cumulative amount of the customer's purchases |
| `{{purchase_amount}}` | Amount of the order concerned |
| `{{purchase_external_id}}` | External order ID |
| `{{purchase_date}}` | Order date |
| `{{url}}` | Direct link to the survey. This variable is mandatory in the text of your SMS. |
{% hint style="info" %}
Usage example\
\&#xNAN;*Hello {{customer\_first\_name}}, thank you for your purchase on {{purchase\_date}} at {{brand}}! We would like to know your opinion 👉 {{url}}.*
{% endhint %}
### Variables usable on the redirect page
Some variables can also be inserted on the survey redirect page (for example to thank the customer or display a personalized message):
| Variable | Description |
| ----------- | -------------------------------------------------------------------------------------------------------- |
| `{{store}}` | [Public name](/documentation/documentation-en/getting-started/locations.md#h_bc9834e24a) of the location |
| `{{brand}}` | Brand name |
### Missing data and variable display
If the data associated with a variable is not available (for example, if the customer's first name is unknown), the variable concerned will not be replaced when sent.\
In this case, it will remain blank but will not display any extra space, so as not to alter the source text.
{% hint style="info" %}
Example: If the message contains " *Hello {{customer\_first\_name}}, thank you for your visit* " and no first name is known, the customer will receive " *Hello, thank you for your visit* ".
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.