# Surveys

# How to create a poll

Surveys can be created, edited, and configured on the corresponding page. To do it, go to the Settings tab, then tap on Polls.

/docs/client-android/media/goto_survey/en.png

On the opened Polls page, tap Create survey or tap on /docs/client-android/media/add_survey_icon/en.png.

/docs/client-android/media/survey_main/en.png

On the Survey management page, you will see three tabs: Questions, Campaigns, and Responses.

/docs/client-android/media/survey_questions/en.png
/docs/client-android/media/survey_companies/en.png
/docs/client-android/media/survey_answers/en.png

# How to add questions

On the Questions tab, add the title, description of the survey, and the list of questions (there can be more than one). For each question, specify its type, add answer options.

/docs/client-android/media/add_question/en.png

Tap the Add question button to create questions. Four types of questions are available:

  1. Short answer —a short answer (up to 255 characters).

  2. Paragraph — a longer free-form response (up to 4096 characters).

  3. Single answer — only one of the available options can be selected in the response.

  4. Multiple answers — multiple options can be selected at the same time.

To hold a survey, you will need to create at least one campaign as shown here. You can create a campaign either before or after adding questions.

When you select the type of the question, it will be added to the list, and you will be able to:

/docs/client-android/media/configure_question/en.png
  1. Reorder questions by holding /docs/client-android/media/six_dots_icon/en.png.

  2. Edit the question text in the Question field.

  3. Add response options by tapping the Add option button.

  4. Edit response options.

  5. Delete response options by tapping on /docs/client-android/media/x_icon/en.png.

  6. Reorder the response options vertically by holding /docs/client-android/media/six_dots_icon/en.png.

  7. Add a custom response option by tapping on the Add the 'Other' option button (available for question types Single answer and Multiple answers).

  8. Mark a question as optional with the help of the Required toggle.

  9. Create a full copy of a question by tapping on /docs/client-android/media/copy_icon/en.png.

  10. Delete a question by tapping on /docs/client-android/media/delete_icon/en.png.

# How to create and manage survey campaigns

In the Campaigns tab, you can create survey campaigns, which are needed for collecting and structuring data across different groups of respondents. Tap the Create campaign button and configure its settings:

  1. Use the drop-down list Who can take the survey to select the users who will be allowed to take the survey:

    • All users (public survey), a public survey, all users, who have a link to this survey, can take part in it.

    • Users from my server, only server users can participate in the survey.

  • The Anonymous survey checkbox is used to hide or display the list of respondents.

  • The checkbox Allow participants to view their responses.

  • The checkbox Allow participants to retake the survey.

  • The Campaign ID field is optional. If this field is left blank when the campaign is created, the value will be generated automatically. This field represents the identifier included in the survey link. You can edit the Campaign ID to make survey links more readable and convenient. This feature may also come in handy when logs have to be sent.

The campaign ID has to be unique within your server.

/docs/client-android/media/create_company/en.png

After configuring the campaign settings, tap the Create button, and the campaign will be displayed in the general list for this survey.

/docs/client-android/media/company_list/en.png

Tap on a survey to open its web page. Here, you can:

  1. View survey details:

    • last modification date.

    • number of questions.

    • The link to the page where users can respond to the survey.

  • Open the Questions tab by tapping on Edit survey

  • Open the Campaigns tab by tapping on Campaign management

  • Create a full copy of the current survey campaign by tapping Create copy.

  • You can end only an active survey campaign; to do it, tap the End button.

    /docs/client-android/media/company_edit/en.png

If a campaign is inactive, you can either delete or launch it by tapping the corresponding button. To launch the campaign, tap on Other campaigns; in the pop-up window, tap on /docs/client-android/media/company_start_icon/en.png next to the selected campaign.

/docs/client-android/media/company_stopped/en.png
/docs/client-android/media/company_start/en.png

# Viewing survey results

The person who created the survey can view its results. To do it, tap View responses on the main page. The Responses tab will open. In the Campaigns drop-down list, you can select the survey campaign for which you need to check the results. On the Summary tab, you can view detailed information about the distribution of responses for each question:

/docs/client-android/media/surveys_result_check1/en.png

In the Individual responses tab, you can view the responses given by each participant who completed the survey:

/docs/client-android/media/surveys_result_check2/en.png

# Publishing a survey in a group chat

To create a survey in a group chat, tap on /docs/client-android/media/gui/paperclip/en.png, select the attachment type Polls. Next, tap the Send a poll button.

/docs/client-android/media/add_survey_in_group_chat/en.png

Choose a survey in the pop-up window. If the list is empty, you can create a survey as shown earlier. When a survey has been selected, the survey campaign setup window will open. Choose required options and tap the Create and send button.

/docs/client-android/media/add_survey_in_group_chat2/en.png

When a survey is created for a group chat, the parameter in the Who can take the survey field is set to Chat users and cannot be changed.

# Survey completion

To respond to a survey which was shared in a chat, just tap on Go to survey in the corresponding message to open the survey window. In other cases, to respond to the survey, a user has to follow the link which is specified in the settings of the survey campaign. If the campaign is not anonymous, you will need to sign in before responding to questions. To take part in a public survey, you only need to enter your name.

/docs/client-android/media/surveys_test/en.png

After answering all the questions, tap the Send button to save your results. Depending on the campaign settings, on the opened page, you may be allowed to retake the survey and review your answers.

/docs/client-android/media/surveys_complete/en.png