Documentation

Giveaways

This is a built-in tool that allows chat administrators and moderators to run giveaways in one or multiple chats. With this tool, your users will be motivated to return and complete tasks to earn the necessary achievements in order to participate in the giveaway. This will have a positive impact on your Retention, Engagement, and LTV metrics.


Creating a Giveaway

You can create and configure a giveaway either through the admin panel or directly from the chat interface.

Admin panel

To configure via the admin interface, select the corresponding section in the side menu and click the “Create” button.


Chat room

To configure via the chat room interface, the user must have admin rights. In the chat room, open the settings (gear icon) and select the corresponding section in the menu.



Giveaway Settings

General

In the main window of the admin panel, you will find the primary giveaway settings. Here you can specify your endpoint and bearer token to automate the prize distribution process.

There you can specify your endpoint URL and bearer token to automate the prize distribution process. When a client wins, Watchers will send you a special event with the prize information.


Banner

You can upload an image up to 10 MB with a 16:9 aspect ratio.

Number of Participants

You can set any number of participants. The main rule is that the number of winners must always be less. If the number of participants in the giveaway is smaller than the number of active users in the chat rooms, not all users will be able to take part.

Participation Requirements

Chat account age– this parameter prevents users who created new accounts just to increase their chance of winning from participating.

From a certain number of messages – this parameter excludes users who only observe without actively participating in conversations.

Only among users with a badge – only users who have earned a specific achievement can join the giveaway. This motivates others to collect achievements.

Translation – enables automatic translation of the widget into all supported languages.

Date and time of publication – select a specific date and time to publish the giveaway, or publish it immediately after setup.

Duration – set the duration in hours or specify an exact end date.

Room List – add the names of the rooms where the giveaway will take place or upload a ready-made list.


Participating in a Giveaway

User flow

Once the giveaway is published in the chat room, all chat participants will receive a notification. After that, they can join by finding the giveaway in the feed and clicking the button in the giveaway widget.


All participants can see the number in brackets on the giveaway button, which indicates the total number of participants.

A chat administrator can pin the giveaway message so that all chat participants can easily and quickly join.

Admin flow

When the giveaway is running, you can change the widget description and its duration in the admin panel.


❗️

After the giveaway has started, you cannot change the rooms where it is active.


You can edit the participant list and exclude a user from the giveaway.


Announcing the Winners

User flow

When the giveaway ends and the algorithm selects the winners, chat participants will be able to view the winners list.



The winning participant will receive a special notification and the opportunity to claim their prize..



Admin flow

After the winners are determined, the admin panel provides the option to download the list of participants and winners. Based on this list, the administrator can confirm winners and assign prizes.

The giveaway winner is determined using an uploaded CSV document. In this document, the winner has a special flag.

giveawayIdexternalUserIdexternalRoomIdisWinnerisClaimedcreatedAtupdatedAt
NumberStringTextBooleanBooleanDateDate