> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/interactive-games-add-on-module/interactive-games-or-lucky-wheel.md).

# Interactive Games | Lucky Wheel

Spin and Win! Displaying all prizes on a wheel, Lucky wheel is the easiest and most simple way to draw prizes. You can give out discounts, promote new products or clear stock through the wheel!

### Step 1: Enter the "Interactive Games" and click "Add Interactive Games"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FvRJk9ZqSQNZcNd01rDSH%2F%E6%88%AA%E5%9C%96%202023-03-20%20%E4%B8%8B%E5%8D%883.25.18.png?alt=media&amp;token=2c51a1b9-c448-4afe-a9f7-965889616653" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FrDrptnfqAMDEy9yULYMc%2F%E6%88%AA%E5%9C%96%202023-05-18%20%E4%B8%8B%E5%8D%886.01.50.png?alt=media&amp;token=20a48979-4cb9-4b15-9d5e-07ed726e4e36" alt=""><figcaption></figcaption></figure>

Then, click **"Lucky Wheel".**

### Step 2: Set the Game content

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FclGrddsgH3XC8VvE8Xf3%2F%E6%88%AA%E5%9C%96%202023-11-09%20%E4%B8%AD%E5%8D%8812.08.44.png?alt=media&amp;token=9441d97f-5ac0-4a33-8a38-4f6a9b29f56e" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
After selecting the distribution channel, you can only change it when the game is in the <mark style="color:blue;">**"Draft"**</mark> stage. It cannot be changed after published.
{% endhint %}

#### Game Setting Section

1. Set the Game title: It will display to the customers.
2. Choose the Duration: Here is where you can select the play time of your game.
3. Edit the Rules description: you can establish the game rules here, it will show to users.
4. Select the Platform\
   \&#xNAN;*<mark style="color:blue;">**Remarks: If you select LINE, please choose the LINE official account which is integrated with LIFF.**</mark>*
5. Choose the Platform's Channel.
6. Put tags on customers who opened game URL link
7. Put tags on players: Create the custom tags or existing Tags, and the number of Tags is not limited.
8. Put tags on new friends: These tags will be attached to new friends.
9. Enabling the "**Enable to share with friends**" feature means the customer can share the Game link with others. If the others who have never played the game before, click the link and finish the game, the customer can get one more chance to play.
10. Sharing Message: You can customise the content of the sharing message, **{{shareUrl}}** will be replaced by the actual game link when sharing, <mark style="color:red;">**please do not delete it.**</mark>

{% hint style="info" %}
When the following conditions are met, the sharer will get extra chances to play

1. The one who receives the invitation <mark style="color:red;">**hasn't played the game before**</mark>
2. The one who receives the invitation plays the game via the invitation link
   {% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FoJZw5h0Yw0v3kSE273HC%2F%E6%88%AA%E5%9C%96%202023-05-18%20%E4%B8%8B%E5%8D%886.22.40.png?alt=media&amp;token=00182e2f-8529-404f-a659-8b60188cc3c4" alt=""><figcaption></figcaption></figure>

### Step 3: Prize Setting

#### **1. Set the number of chances for each consumer's playing**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F4sRzahLiGf346xcFdbAW%2F%E6%88%AA%E5%9C%96%202023-05-18%20%E4%B8%8B%E5%8D%886.24.14.png?alt=media&amp;token=dde96c9c-aa94-4025-ad32-9f9e9f5e094d" alt=""><figcaption></figcaption></figure>

You can set to reset the number of chances for consumer. Consumers will get new chance to play again.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F9GYIS2lXQIwHOB01XM4E%2F%E6%88%AA%E5%9C%96%202023-05-18%20%E4%B8%8B%E5%8D%886.25.15.png?alt=media&amp;token=8ef27e29-ca66-45d1-a550-6bbd3cb5af2f" alt=""><figcaption></figcaption></figure>

#### **2. Prize settings**

The sum of the winning and losing probabilities should be *<mark style="color:blue;">**100% (Including the winning and non-winning prizes).**</mark>*

<table><thead><tr><th width="179.66666666666666">Prize Type</th><th>Winning or not</th><th>Winning Percentage</th></tr></thead><tbody><tr><td>Non-winning</td><td>Lost</td><td>25%</td></tr><tr><td>Prize 1</td><td>Winning</td><td>25%</td></tr><tr><td>Prize 2</td><td>Winning</td><td>25%</td></tr><tr><td>Prize 3</td><td>Winning</td><td>25%</td></tr></tbody></table>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FNCUna1SChqTQN78FTE51%2F%EF%BC%91.png?alt=media&amp;token=54c924e7-3189-4cc0-af6e-26bb2c9a3fa0" alt=""><figcaption></figcaption></figure>

1. You can delete prize setting.
2. You can set the prize name.
3. Prize image: The file can be png, jpeg, or jpg with 120 x 120 pixel.
4. You can set the prize quantities.
5. Prize probability: The probability of winning that prize. When we set the Prize probability to be 25%, means each participant has a 25% chance to draw the Prize 1 every time. (No matter how many prizes are left).

For example, there is a lottery box with 2 x A prize balls, 2 x B prize balls, 2 x C prize balls, and 2 x D prize balls inside. After drawing, each participant will throw back the ball to the lottery box for the next participant.

6. Winner's prize message: Can set to be Text or Bot. Will send to customers who have won the Prize 1 (*<mark style="color:blue;">**Remarks: LINE requires a message fee**</mark>*) It can be disabled if you do not want to send the win message. You can use customer name in message.

{% hint style="info" %}
For LINE channel, there is a pop-up window reminding the winner to check the message in the LINE chat room.
{% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FSwcgj2S3y0CykLNZkIVF%2F%E6%88%AA%E5%9C%96%202023-05-18%20%E4%B8%8B%E5%8D%886.36.22.png?alt=media&amp;token=2c6fc3e2-9380-4194-9ef0-3bd3d9b2ce10" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FN23n6iWYvotLq8PytbMc%2Flose.png?alt=media&amp;token=b6d7f7a2-dc19-4b33-b203-666bce13576c" alt=""><figcaption></figcaption></figure>

1. You can set lose message title.
2. Lose probability: The sum of the winning and losing probabilities should be **100%.**
3. Lose image: The file can be png, jpeg, or jpg with 120 x 120 pixel.
4. Lose message: Can set to be Text or Bot. It can be disabled if you do not want to send the Lose message. You can use customer name in message.

{% hint style="info" %}

1. The "Non-winning" setting is preset so as to avoid having empty prizes when all the prizes are drawn.
2. When a prize is drawn out (The number of prizes becomes 0), the next winner will be regarded as a Lost.
3. Ensure the sum of the winning and losing probabilities to be 100%.
   {% endhint %}

#### **3. Winning Message Settings**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FVHNZpS4ZbZekfvD7iKWN%2F%E4%B8%AD%E7%8D%8E%E6%96%87%E6%A1%88.png?alt=media&amp;token=1fe35c38-c5ba-4100-9c83-29f775504926" alt=""><figcaption></figcaption></figure>

1. You can set the winning message.
2. You can set the prize name.
3. You can set the button name.

#### **4. Non-Winning Message Settings**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FEx6UB6Xb6jK3eOLvmcIG%2F%E6%9C%AA%E4%B8%AD%E7%8D%8E%E6%96%87%E6%A1%88.png?alt=media&amp;token=900fa91e-5895-4801-94eb-1dde260d292a" alt=""><figcaption></figcaption></figure>

1. You can set the non-winning message.
2. You can set the non-winning prize.<br>

{% hint style="info" %}
If you want to set up a "everyone wins" scenario, you can follow these steps:

1. In "Non-winning setting", set the message for the "Participation Prize"
2. In "Non-Winning Message Settings", set the non-winning message and non-winning description text
   {% endhint %}

### Step 4: Design the layout

{% hint style="info" %}
Image format: png, jpg, jpeg, no limit on file size, but it is recommended not to exceed 10 MB.
{% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FGMXi3EhulCPtGslhXMCi%2F%E6%88%AA%E5%9C%96%202023-05-18%20%E4%B8%8B%E5%8D%886.40.52.png?alt=media&amp;token=8620308a-7746-43c4-8306-e8277919e80e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FW20lt20741TayQZkEgiB%2F%E6%88%AA%E5%9C%96%202023-03-21%20%E4%B8%8A%E5%8D%8810.00.21.png?alt=media&amp;token=18608d61-a174-41d3-8e31-fb482d3f5ee9" alt=""><figcaption></figcaption></figure>

1. Color Setting: Can change the colour of the machine.
   * Background color
   * Wheel color
   * Rule text colour
2. Background Image: width in 1024 pixel and height may vary depending on the length of the game rules. We recommend placing all key visual elements toward the upper area of the image and testing the actual display effect.

   **Additional notes:**

   * After the “Game Rules” section is displayed, there will be approximately **60px of blank space** reserved at the bottom. Any content beyond this area will be cropped by the system.
   * The actual cropping position may vary depending on the user’s device size.
   * Since the amount of text in the game rules differs for each brand, please pay special attention when designing the background image height. Avoid placing important information or visuals near the bottom edge, as they may be cut off and not fully displayed.
3. Start button image: recommended size 360 x 105 pixel.
4. Prize description image (Optional): Can upload the list of the prizes to enhance the game's attractiveness. Image dimensions: width in 750 pixels, no limit on the length.

### Step 5: Save the Interactive Games

Save the Interactive Games to the **"Draft".**

{% hint style="warning" %}

1. You can test the game in the "Draft" status, but the test record will be cleared after published. So, when you are ready to launch the game, please click "Publish Interactive Games".
2. "Delete" can only execute in the "Draft" status, the game cannot be deleted in the "In Progress" and the "Stopped" status.
   {% endhint %}

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FKXx8fuO3XmMDqjT0JCuu%2F%E6%88%AA%E5%9C%96%202023-03-26%20%E4%B8%8B%E5%8D%8811.16.57.png?alt=media\&token=9db8294c-18d0-4fb7-855d-cbae1b172aeb)

#### Choose Facebook as the platform, when customers click the game link or scan the QR code, they will receive the Game block in **Messenger, then click and start the game**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FIJvpki7MajtH37cTbCfO%2F%E6%88%AA%E5%9C%96%202023-05-19%20%E4%B8%8A%E5%8D%8810.59.51.png?alt=media&amp;token=b1244a86-de31-4f37-be5e-ddbacbed0c4c" alt=""><figcaption></figcaption></figure>

#### Choose WhatsApp as the platform, when customers click the game link or scan the QR code, they will receive the Game block on WhatsAp&#x70;**, then click and start the game**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FAnS0XsF7G80LqJ1VDlsN%2F%E6%88%AA%E5%9C%96%202023-05-19%20%E4%B8%8A%E5%8D%8811.02.01.png?alt=media&amp;token=9a4ca69f-d8f7-4cc0-b8a2-3b5874b5494d" alt=""><figcaption></figcaption></figure>
