Competitions

Competitions are a tool used to increase audience engagement with your bot. They allow you to easily create a competition, manage entries, and select winners. You can define a competition in the Competitions panel in the main menu.

Adding a competition

To add a competition, click the blue “Add competition” button in the Competitions panel. A pop-up will appear containing the competition configuration elements.

competition name

The competition name should be simple and understandable for other platform users. Your end user will not see this name.

The maximum length for the competition name is 80 characters.

Activating the competition

A competition can be activated in two ways:

• manually on the platform,
• within a specified time frame.

Types of competitions

You can create any type of competition, depending on how you want to engage your audience. Possible types of entries include:

• text,
• photo,
• audio,
• video.

Entry limits

You can specify how many times a user can submit a competition entry. Available options are:

• unlimited number of times: the user can add as many entries as they want,
• once during the competition: the user can add only one entry during the competition period,
• once per day: the user can add one entry per day during the competition period.

Saving data in columns

You can save any set of participant data for each submitted entry. To do this, you must define the column name and the type of information that will be stored in it. Available data types include:

• text,
• winner designation,
• video file,
• audio file,
• photo,
• postal code,
• email,
• phone number.

The column name cannot exceed 30 characters.

To ensure competition entries are saved in columns, remember to set the “Save user data” action in the competition block. More information about actions can be found here.

Using competitions in the bot structure

Once you have defined a competition in the competitions panel, you need to use several blocks in the bot structure to present information about the competition, obtain consent for data processing, or allow competition entries.

If the competition-related blocks should only be displayed when submissions are accepted, use the “Condition” element and set a condition based on the active competition. Make sure to use branching at the beginning of each competition-related block.

To allow the user to submit a competition entry, use the “Questions” block element. More information about this element can be found here. Make sure to set the answer validation type according to the competition requirements (photo, text, video, etc.).

You can also add a wrong answer message, useful when the user submits an incorrect response (e.g., text instead of a photo). An additional setting is to interrupt the competition path if the user gives a wrong answer more than the specified number of times.

To activate both settings, click the switch next to the appropriate option on the left side of the Questions panel.

In the wrong answer message, do not repeat the previously asked question. Explain to the user what they need to do and ensure they can withdraw from the competition at any time.

Managing competition entries

Displaying competition entries

To view competition entries, go to the competitions panel and click the settings icon for the selected competition. From the menu, select “Show entries.” In this view, you will see a list of all entries added to the competition along with user data defined during competition creation.

You can search entries by participant’s name.

Marking winners

You can designate more than one competition winner. First, use the checkbox to select the entries you want to mark as winners, then click the “Bulk actions” button. From the drop-down list, select “Add tag: Winners.” Another option is to click the star in the row with the selected entry.

Sending messages to participants

If you want to contact competition participants, use the option to send a message. You can send a message to participants who:

• added an entry,
• received any reward,
• did not win any reward,
• received a reward and are tagged as “Winners”.

The message can include:

• message with buttons,
• carousel,
• image,
• RSS feed.

Exporting competition entries

You can export competition entries to an .xls file – it will contain participant data, a link to the competition entry, tags, and other previously defined columns.

Deleting competition entries

You can delete an entry from the competition by clicking the “Delete” button in the corresponding row. This option can be useful if tests were conducted and you want to clear the entry database before the competition is published.

Best practices

1. When creating a competition in the bot structure, remember to create blocks containing:
   1. Detailed competition rules
   2. Reference to the competition regulations and its acceptance
   3. Consent for personal data processing
2. Additionally, include blocks with answers to frequently asked questions about the competition.
3. Use push notifications to encourage competitors to complete their submissions within 24 hours of the last message if they haven’t done so.