# Bumerang Guide

Campaigns, surveys, ads, events, Treasure Hunt, autopilot, guest analytics and reports

# Campaigns

## What is it for?

The **Campaigns** (Bumerang) screen is where you manage the automatic messages that bring your guests back by themselves. You set them up once; the message goes out when a guest visits for the first time, has not come for a while, or has come a set number of times. The screen also shows how many guests came back after a campaign and roughly how much revenue that brought.

If you are setting up your first campaign, go straight to [Creating your first campaign](/books/bumerang-guide/page/creating-your-first-campaign). This page covers following, editing, pausing and deleting campaigns you already have.

## When do you use it?

- When you want to see how many messages your campaigns sent and how many guests they brought back.
- When you want to change a campaign's message, coupon or sending hours.
- When you want to pause a campaign for a while (for example during renovation) or remove it completely.

## Before you start

- You need the Bumerang marketing package. Without it, this menu opens an introduction screen instead of the campaign list.
- Campaigns only go to guests who gave **commercial message consent** at Wi-Fi login. See how many you have on [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests).

## Step by step: read your campaign results

1. In the left menu, under **Bumerang**, open the **CAMPAIGN** heading and click **Campaigns**. The dark blue summary card at the top shows **Guests brought back by Bumerang** (last 14 days) and the **Estimated extra revenue**. The four boxes below: **Messages sent**, **Returning guests**, **Return rate**, **Active campaigns**. ![Campaigns screen and summary card](https://help.useroam.com/uploads/images/gallery/2026-09/km-menu-en.png)
2. In the **Return per campaign** list on the right, each campaign is a row: its name, how many **messages** went out, how many **returns** there were, a status badge (*Active*, *Paused*, *Draft*, *Archive*) and the **extra revenue** on the right. Click a row for details. ![A campaign row in the Return per campaign list](https://help.useroam.com/uploads/images/gallery/2026-09/km-kart-en.png)
3. The campaign details screen opens. At the top: **Returning guests** (14 day window), **Return rate** (of deliveries), **Avg. return time** and **Estimated gain**; below: **Deliveries**, **Delivered**, **Clicks**, **Returned**, **Failed** and the list of the last 200 deliveries. To make changes press **Edit** at the top right; to go back press **Back to list**. ![Campaign details screen and the Edit button](https://help.useroam.com/uploads/images/gallery/2026-09/km-detay-en.png)

## Step by step: edit, pause or delete a campaign

1. On the **Edit Campaign** screen you can change the **Campaign name**, the **When?** value and the **Message to send**. To pause the campaign, choose **Paused** in **Status**; to start it again choose **Active (running)**. **Draft** and **Archived** send nothing either. ![Status box](https://help.useroam.com/uploads/images/gallery/2026-09/km-durum-en.png)
2. Under **Advanced settings**, enter the **Average check amount (₺, for the gain estimate)** (example: `350`); the gain is calculated with this value. If you gave a coupon, use **Link the coupon to the menu (applied to prices, opt.)** to tie the discount to the menu: **No discount**, **% percent** or **₺ amount**; scope **Whole menu**, **Selected categories** or **Selected products**; **Expiry (empty = unlimited)**. To limit sending to certain hours and days, use **Start time**, **End time** and **Days (leave empty = every day)** (Mon, Tue, Wed, Thu, Fri, Sat, Sun). ![Advanced settings: average check, coupon discount, hours and days](https://help.useroam.com/uploads/images/gallery/2026-09/km-gelismis-en.png)
3. Press **Save**; "Saved." appears at the top of the screen. **Details** opens the campaign details, **Cancel** leaves without saving. To remove the campaign completely, press the red **Delete** and confirm "Delete this campaign and all of its delivery records? This cannot be undone." To keep past reports, choose the **Archived** status instead of deleting. ![Save, Details, Cancel and Delete buttons](https://help.useroam.com/uploads/images/gallery/2026-09/km-kaydet-en.png)

## Campaign types

<table id="bkmrk-typewhen-does-it-go-"><thead><tr><th>Type</th><th>When does it go out?</th><th>Default</th></tr></thead><tbody><tr><td>**Welcome** (*Hoş Geldin*)</td><td>A set number of **minutes** after a guest connects **for the first time**. Goes to each guest once. When you switch it on, only guests who came for the first time in the last 24 hours count; older guests do not get a mass message.</td><td>30 minutes</td></tr><tr><td>**We Missed You** (*Seni Özledik*)</td><td>When a guest has not visited for a set number of **days**. It does not go to guests who have been away for more than 180 days.</td><td>30 days</td></tr><tr><td>**Loyalty** (*Sadakat*)</td><td>When a guest visits for the set **th time**. Goes to each guest once.</td><td>5th visit</td></tr></tbody></table>

## Fields on the screen

<table id="bkmrk-fieldmeaning-title-a"><thead><tr><th>Field</th><th>Meaning</th></tr></thead><tbody><tr><td>Title and path</td><td>Under the title: "Send it, bring them back: automatic win-back campaigns". The path at the top (Home, Marketing, Bumerang) takes you back to earlier screens.</td></tr><tr><td>**Guests brought back by Bumerang**</td><td>"returned after receiving a campaign message (last 14 days)". Next to it the number of **messages sent** and **active campaigns**.</td></tr><tr><td>**Estimated extra revenue**</td><td>The formula under the card: "returns × campaign average check − coupon cost".</td></tr><tr><td>Chart subtitle</td><td>"Last 6 weeks: how many messages went out, how many brought guests back."</td></tr><tr><td>Page tour</td><td>Two steps on first opening: **Create a campaign** ("Create a new trigger campaign here: write your message, add the coupon and menu link.") and **Campaign card** ("Each card is a campaign: status, sends, clicks and returns. Click a card for details.").</td></tr><tr><td>Hints on the edit screen</td><td>The preview on the right and the tour texts are described on [Creating your first campaign](/books/bumerang-guide/page/creating-your-first-campaign). Grey examples in the boxes: "e.g. SWEET20" for the coupon, "e.g. 350" for the average check.</td></tr><tr><td>Details: subtitle</td><td>"Campaign details and delivery records (last 200)". Under the gain card: "The gain is an estimate: number of guests who returned within the return window × the average check you entered, minus the coupon discount cost."</td></tr><tr><td>**Sends &amp; returns** chart</td><td>Last 6 weeks: weekly **Sent** and **Returned**. With no sends it says "No messages sent yet".</td></tr><tr><td>**Return per campaign**</td><td>"Which scenario earned how much?" Each row shows messages, returns, status and extra revenue.</td></tr><tr><td>"No campaigns yet"</td><td>Shown when there are no campaigns: "Set it up once and let guests return on their own. Pick a ready recipe, fill it in, and go live." Press **Set up →** on one of the recipe cards below it.</td></tr><tr><td>Details: **Estimated gain**</td><td>Calculated as "returns × average check"; the discount is deducted for coupon returns. If the average check is empty it says "For a gain estimate enter the average check amount".</td></tr><tr><td>Details table</td><td>Columns: **Date**, **Phone** (masked), **Source** (Wi-Fi or Hotel), **Channel**, **Status**, **Delivery**, **Clicks**, **Returned**. With no sends it says "No deliveries yet."</td></tr><tr><td>Status badges</td><td>*Pending* (queued), *Sent*, *Failed*, *Clicked* (the guest pressed the button), *Returned* (the guest came back within 14 days).</td></tr><tr><td>Delivery column</td><td>On WhatsApp *Read*, *Delivered* or *Not delivered*; on SMS *Delivered* or *Not delivered*. If the operator has not reported yet, the raw Turkish status (for example "gonderildi") is shown.</td></tr><tr><td>Custom URL warning</td><td>"With a custom URL the coupon cannot be linked to a menu: that menu is not your Useroam menu, so discount settings are not saved." If the button link is your own website, the discount settings are not used.</td></tr><tr><td>Scope selection</td><td>If the scope is **Selected categories** or **Selected products**, pick from the list ("Select if the scope is category/product (Cmd for multiple)"; Ctrl on Windows). Categories are marked "(category)". "Guests arriving from the campaign link see discounted prices on the menu (original struck through)."</td></tr></tbody></table>

## Warnings when saving

<table id="bkmrk-warningwhat-to-do-%22t"><thead><tr><th>Warning</th><th>What to do</th></tr></thead><tbody><tr><td>"The campaign name cannot be empty."</td><td>Give the campaign a name.</td></tr><tr><td>"The business name is required in the message. Please add the |company| placeholder."</td><td>Press the **Business name** tag under the message; the sender must be clearly visible in a commercial message.</td></tr><tr><td>"The message uses |link|; fill in the Link field or remove |link| from the message."</td><td>Choose a menu in **Button link**, or delete the link tag from the message.</td></tr><tr><td>"You used |kupon| in the message but the coupon code is empty. Enter a coupon code or remove the |kupon| tag from the message."</td><td>Fill in **Coupon code**, or delete the tag.</td></tr><tr><td>"Error: …"</td><td>The save failed; read the message, refresh the page and try again.</td></tr></tbody></table>

## Frequently asked questions

**My campaign is active but no message went out.**  
There may be no consented guests (see Opted-in Guests), or you are outside the hour and day limits. **Welcome** only goes to new guests; it does not go to guests from before you switched it on.

**Does the message go by SMS or WhatsApp?**  
Over the channel the guest logged in to Wi-Fi with: WhatsApp for WhatsApp logins, SMS for SMS logins. No separate channel choice or template approval is needed. On WhatsApp the message goes into a fixed template and the link becomes a button.

**Why is the estimated extra revenue zero?**  
The campaign has no average check amount. Open **Advanced settings** with **Edit** and enter it.

**Does the same guest get the message again and again?**  
**Welcome** and **Loyalty** go to a guest once. **We Missed You** can go again if the guest stays away for a long time again.

**I deleted a campaign and its reports are gone.**  
**Delete** also removes all delivery records and cannot be undone. Use **Paused** to stop and **Archived** to keep.

## Related pages

- [Creating your first campaign](/books/bumerang-guide/page/creating-your-first-campaign)
- [Bulk Sending](/books/bumerang-guide/page/bulk-sending) (one-off announcement)
- [Sending Calendar](/books/bumerang-guide/page/sending-calendar)
- [Bumerang Reports](/books/bumerang-guide/page/bumerang-reports)

# Creating your first campaign

## What is it for?

This page walks you through setting up your first Bumerang campaign from start to finish. As an example we set up a **Welcome** campaign (*Hoş Geldin* on screen): 30 minutes after a guest connects to Wi-Fi for the first time, they get a thank-you message and a menu link. **We Missed You** (*Seni Özledik*) and **Loyalty** (*Sadakat*) campaigns are set up with the same steps; only the **When?** line changes.

## When do you use it?

- When you use Bumerang for the first time.
- When you want to add a new scenario (for example a coupon for guests who have not come for a while).

## Before you start

- The Bumerang marketing package must be active.
- Messages only go to guests who gave **commercial message consent** at Wi-Fi login. Check how many you have on the [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests) screen.
- A **QR Menu** helps, so that the button in the message takes the guest to your menu. You can also give your own web address instead.

## Step by step

1. In the left menu, under **Bumerang**, open **Campaigns** and press **New Campaign** at the top right. ![New Campaign button](https://help.useroam.com/uploads/images/gallery/2026-09/ik-yeni-btn-en.png)
2. Pick one of the ready recipes. In the English interface the recipe cards still show their Turkish names: **Hoş Geldin** (Welcome: a warm welcome and a first discount for a guest connecting for the first time), **Seni Özledik** (We Missed You: calls back a guest who has not visited for a while, with a coupon; the scenario that earns most) or **Sadakat** (Loyalty: a reward at a set number of visits). In this example click **Hoş Geldin**. ![Ready campaign recipes](https://help.useroam.com/uploads/images/gallery/2026-09/ik-tarif-en.png)
3. Type the **Campaign name** (example: `Welcome Coffee`). On the **When?** line, set how long after the visit the message goes out: "Send this message **30 minutes** after a guest connects **for the first time**." Just change the number in the box. ![Campaign name and When line](https://help.useroam.com/uploads/images/gallery/2026-09/ik-ad-zaman-en.png)
4. Edit the ready text in **Message to send** in your own words, or press **Write with AI** to let the AI write it (the first time can take 20-40 seconds; when you see "Ready, you can edit it." check the text). Press the tags under the box to add to the message: **Business name \*** (required), **+ name (if any)**, **+ coupon**, **+ link**. The tags are filled with real information at send time. ![Message box, tags and Write with AI button](https://help.useroam.com/uploads/images/gallery/2026-09/ik-mesaj-en.png)
5. If you like, type a code in **Coupon code (opt.)** (example: `HOSGELDIN10`). In **Button link** choose where the guest goes: **Pick from my menus** (then choose your menu), **Pick from my events**, **Hotel guest portal**, **Choose from my reward hunts** or **I will enter a custom URL**. ![Coupon code and Button link fields](https://help.useroam.com/uploads/images/gallery/2026-09/ik-kupon-link-en.png)
6. With **Start time** and **End time**, set the hours in which the message may go out (default 10:00 to 21:00). Messages are only sent within these hours, so guests do not get messages at night. ![Start time and End time fields](https://help.useroam.com/uploads/images/gallery/2026-09/ik-saat-en.png)
7. Check the **How does the guest see it?** preview on the right. The message is shown separately for a guest who **Joined via SMS** and one who **Joined via WhatsApp**. Use the **Guest without a name** switch to see how it reads for a guest who gave no name. On WhatsApp the message goes into a fixed template and the link becomes a **View Campaign** button. ![How does the guest see it preview](https://help.useroam.com/uploads/images/gallery/2026-09/ik-onizleme-en.png)
8. Press **Publish** to start right away. If you want to finish later, press **Save Draft**; a draft campaign sends nothing. ![Publish and Save Draft buttons](https://help.useroam.com/uploads/images/gallery/2026-09/ik-yayinla-en.png)
9. One more step to measure the campaign's gain: click the campaign in the **Campaigns** list, press **Edit** and, under **Advanced settings**, enter the **Average check amount** (example: `350`). If you gave a coupon, use **Link the coupon to the menu** to apply the discount to menu prices. Press **Save**. ![Advanced settings: average check and coupon discount](https://help.useroam.com/uploads/images/gallery/2026-09/km-gelismis-en.png)

## The When? line (by campaign type)

<table id="bkmrk-recipesentence-on-sc"><thead><tr><th>Recipe</th><th>Sentence on screen</th><th>Default</th></tr></thead><tbody><tr><td>**Hoş Geldin** (Welcome)</td><td>"Send this message … minutes after a guest connects **for the first time**."</td><td>30 minutes</td></tr><tr><td>**Seni Özledik** (We Missed You)</td><td>"Send this message if a guest has not visited for … days."</td><td>30 days</td></tr><tr><td>**Sadakat** (Loyalty)</td><td>"Send this message when a guest visits for the … th time."</td><td>5th time</td></tr></tbody></table>

## Message tags

<table id="bkmrk-tag-%28button%29added-to"><thead><tr><th>Tag (button)</th><th>Added to the message</th><th>What happens at send time?</th></tr></thead><tbody><tr><td>**Business name \***</td><td>`|company|`</td><td>Your business name is written. Required: "The business name is required: the sender identity must be clearly visible in a commercial message."</td></tr><tr><td>**+ name (if any)**</td><td>`|ad|`</td><td>The guest's name is written. "Not collecting names is fine: |ad| is hidden automatically for guests without a name, so the message still reads well."</td></tr><tr><td>**+ coupon**</td><td>`|kupon|`</td><td>The coupon code is written. Saving is not allowed if the coupon code is empty.</td></tr><tr><td>**+ link**</td><td>`|link|`</td><td>On SMS the button link is written; on WhatsApp the link becomes a button under the message.</td></tr></tbody></table>

In the preview the sample name is "Jane"; the WhatsApp template adds "Hello" at the start and "Have a great day!" at the end.

## Other fields and information

<table id="bkmrk-itemdescription-chan"><thead><tr><th>Item</th><th>Description</th></tr></thead><tbody><tr><td>Channel note</td><td>"The message goes out automatically over the channel the guest logged in with (WhatsApp for WhatsApp logins, SMS for SMS logins). It only reaches guests who gave commercial message consent." The preview shows the **SMS · on** and **WhatsApp · on** badges and "Every guest receives it over the channel they registered with."</td></tr><tr><td>Button link boxes</td><td>A second box opens for the type you choose: **Select a menu**, **Select an event**, **Choose hotel portal**, **Choose reward hunt**. With **I will enter a custom URL** an address box opens (example: `https://…`).</td></tr><tr><td>AI status</td><td>When you press **Write with AI** you see "Useroam AI is writing... (the model warms up on first use, ~20-40 s)"; when done, "Ready, you can edit it.".</td></tr><tr><td>Box examples</td><td>The grey example in **Coupon code (opt.)** is "e.g. SWEET20". The path under the title (Home, Marketing, Bumerang, New) takes you back.</td></tr><tr><td>Preview note</td><td>"On WhatsApp the message goes into a fixed template and the link becomes a button. It is sent automatically to guests who registered via WhatsApp."</td></tr><tr><td>**Back**</td><td>Returns to the recipe choice (or to the campaign list); what you typed is not saved.</td></tr><tr><td>Page tour</td><td>On first opening, a short tour explains **Message to send**, **Menu link**, **Coupon code** and **Average check**. Tour texts: "The text your guest will receive. The |isim|, |kupon| and |link| tags are filled in automatically at send time."; "Pick one of your menus or give a custom URL; the button takes the guest there."; "If you offer a coupon, you can also link it to your menu prices as an automatic discount."; "Your average spend per guest. The gain from returns is calculated with this value." The average check field is not on this screen; it is on the **Edit** screen after saving (step 9).</td></tr></tbody></table>

## Warnings when saving

<table id="bkmrk-warningwhat-to-do-%22t"><thead><tr><th>Warning</th><th>What to do</th></tr></thead><tbody><tr><td>"The business name is required in the message. Please add the |company| placeholder."</td><td>Press the **Business name \*** tag.</td></tr><tr><td>"The message uses |link|; fill in the Link field or remove |link| from the message."</td><td>Make a choice in **Button link**.</td></tr><tr><td>"You used |kupon| in the message but the coupon code is empty. Enter a coupon code or remove the |kupon| tag from the message."</td><td>Fill in **Coupon code**.</td></tr><tr><td>"Invalid campaign type." / "The campaign could not be saved." / "Error: …"</td><td>Open the page again from **New Campaign** and try again.</td></tr><tr><td>"The AI did not respond, please try again." / "Connection error, please try again."</td><td>Press **Write with AI** again, or write the message yourself.</td></tr></tbody></table>

## Frequently asked questions

**I published it. Did my old guests get a message too?**  
The Welcome campaign only goes to new guests; when switched on it does not send a mass message to guests older than the last 24 hours.

**Can I test the message myself?**  
If you register on the Wi-Fi for the first time with your own phone and tick the commercial message consent, the message reaches you too once the time has passed. You must be within the send hours.

**Do I write separate messages for SMS and WhatsApp?**  
No. The same text is adapted to both channels; you see both in the preview.

**Can I change the campaign later?**  
Yes. See the editing steps on the [Campaigns](/books/bumerang-guide/page/campaigns) page.

## Related pages

- [Campaigns](/books/bumerang-guide/page/campaigns)
- [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests)
- [Bumerang Reports](/books/bumerang-guide/page/bumerang-reports)

# Bulk Sending

## What is it for?

**Bulk Delivery** (**Bulk Send** in the menu) lets you send a **one-off** announcement to your guests by SMS or WhatsApp (for example a power outage, pool maintenance, a new menu). The difference from campaigns: a campaign runs by itself off a condition; a bulk send goes once, at the moment you choose, to the audience you choose. The delivery report after sending is in the same menu.

## When do you use it?

- When you must tell the guests at your venue about something urgent (outage, maintenance, evacuation drill).
- When you want to announce an event or opening to all your registered guests.
- When you check how many people an announcement reached.

## Before you start

- **Marketing** messages (discounts, promotions) may only go to guests who gave explicit consent (IYS and KVKK). Service announcements (outage, maintenance) can go to everyone.
- A bulk send cannot be undone. Before starting, use **Test send** to send the message to your own phone and check it.

## Step by step: send an announcement

1. In the left menu, under **Bumerang**, open the **CAMPAIGN** heading and click **Bulk Send**. The **Bulk Delivery Report** opens. If there are no sends yet it says "No bulk deliveries yet". Press **New Bulk Delivery** at the top right (or **Send the First Bulk Delivery** in the middle). ![Bulk Delivery Report and the New Bulk Delivery button](https://help.useroam.com/uploads/images/gallery/2026-09/tg-menu-en.png)
2. Type a name for the announcement in **Title (optional)** (example: `Power Outage Notice`); it only shows in the report. Type the text for guests in **Message** (up to 600 characters). ![Title and Message boxes](https://help.useroam.com/uploads/images/gallery/2026-09/tg-mesaj-en.png)
3. Check that your business name is right in **Brand (shown in the WhatsApp template)** and choose the **WhatsApp language** (Türkçe, English, Deutsch, Русский, العربية, Українська, فارسی). On SMS the text goes as is; on WhatsApp it is placed into the approved **useroam\_duyuru** template: "Dear guest, *Brand* would like to inform you: *\[your message\]* Have a nice day." ![Brand and WhatsApp language fields](https://help.useroam.com/uploads/images/gallery/2026-09/tg-marka-en.png)
4. On the right, choose the **Audience** and **Channel**. Audience: **Active guests** (shown as "Currently / live records": guests whose Wi-Fi registration is valid right now, for example hotel guests in house) or **All history** (shown as "Everyone registered on this NAS": every guest who has ever registered on this device). Channel: **Smart** (WhatsApp for WhatsApp registrations, SMS for SMS registrations), **SMS only** or **WhatsApp only**. ![Audience and Channel choice](https://help.useroam.com/uploads/images/gallery/2026-09/tg-kitle-en.png)
5. Choose the **Message Type**: **Announcement** (service and information, to everyone) or **Marketing** (consented guests only). When you pick Marketing, the warning "Marketing messages may only be sent to guests who gave explicit consent (IYS/KVKK). Service announcements (outage, maintenance) are out of that scope." appears and the recipient count drops. ![Marketing choice and the KVKK warning](https://help.useroam.com/uploads/images/gallery/2026-09/tg-pazarlama-en.png)
6. Check the **estimated recipients** and the SMS / WhatsApp split in the black box. After changing your choices, press **Calculate** for an up-to-date number. ![Estimated recipients box and the Calculate button](https://help.useroam.com/uploads/images/gallery/2026-09/tg-alici-en.png)
7. Choose the **Send time**: **Send now** or **Schedule for later**. If you schedule, pick a date and time in the box that opens; a past time cannot be chosen. ![Schedule for later and the date time box](https://help.useroam.com/uploads/images/gallery/2026-09/tg-zaman-en.png)
8. In the **Test send** card below, type your own mobile number (example: `5321234567`) and press **Send test**. The exact same message goes only to you; "Test sent to …." appears. Check the message on your phone. ![Test send card](https://help.useroam.com/uploads/images/gallery/2026-09/tg-test-en.png)
9. If everything is right, press **Start Delivery** and confirm "Start the delivery? Estimated recipients: …". The screen shows "Delivery queued: … recipients (… SMS, … WhatsApp). The engine will send it within a few minutes." or, if you scheduled, "Scheduled to be sent on …". ![Start Delivery button](https://help.useroam.com/uploads/images/gallery/2026-09/tg-baslat-en.png)

## Recent Deliveries list

Below the form, the last 15 sends are listed: **Title**, **Type**, **Recipients**, **Sent** (and the *failed* count, if any), **Status**, **Date**. Status values: *Scheduled*, *Ready*, *Sending*, *Completed*, *Cancelled*.

- To stop a scheduled send, press **Cancel** and confirm "Cancel this scheduled send?". If it has already started you see "Could not cancel: the send may have already started, or the record was not found."
- To send the same message again, press **Send again**. You are asked "This message will be sent again to the CURRENT list of … people. Continue?"; the recipient list is recalculated from the current audience.

## Bulk Delivery Report

After the first send, the report screen fills up:

<table id="bkmrk-sectionwhat-it-shows"><thead><tr><th>Section</th><th>What it shows</th></tr></thead><tbody><tr><td>Summary boxes</td><td>**Total Deliveries** (recipients), **Sent** (and failed), channel split, **Delivery Rate** (delivered).</td></tr><tr><td>Charts</td><td>**Channel Split** and **Recent Deliveries (recipients/sent)**.</td></tr><tr><td>**Deliveries** table</td><td>**Title**, **Type** (*Announcement* / *Marketing*), **Audience** (*Active* / *All history*), **Recipients**, **Status** (*Ready*, *Sending*, *Completed*, *Cancelled*), **Date** and a **Details** button. When empty it says "No deliveries yet."</td></tr><tr><td>Details screen</td><td>The **MESSAGE** text and **Brand** of the selected send; **Total Recipients**, **Sent**, **Not Delivered**, **SMS (carrier)** boxes; **Delivery Status** and **Delivery Result** charts. **All Reports** takes you back to the list.</td></tr><tr><td>**Recipients** list</td><td>The first 1000 recipients ("+ (first 1000)"): **Phone**, **Channel**, **Status**, **Delivered**, **Sent at**, **Delivery Time**. Search a number with **Search phone...**. Delivery values: *Read*, *Delivered*, *Not delivered*, *Failed*, *Pending*.</td></tr><tr><td>**Refresh SMS Delivery**</td><td>Asks the carrier again for SMS delivery information. The button shows "Querying...", then "Updated", or "Error" / "Try again" if it fails.</td></tr></tbody></table>

## Other texts on the screen

<table id="bkmrk-wheretext-subtitleth"><thead><tr><th>Where</th><th>Text</th></tr></thead><tbody><tr><td>Subtitle</td><td>The device address and "bulk SMS / WhatsApp announcement to guests". The path at the top (Home, Marketing, Bumerang) takes you back; **Back** returns to the Campaigns screen.</td></tr><tr><td>Empty report</td><td>"Send your first bulk announcement to your guests over SMS or WhatsApp. Once you do, all statistics, charts and the delivery report will appear here."</td></tr><tr><td>Grey examples</td><td>Title: "e.g. Power Outage Notice"; Message: "e.g. There will be a planned power outage tonight between 23:00 and 01:00."</td></tr><tr><td>Note under the message</td><td>"This text is sent as is over SMS. On WhatsApp it is placed into the approved useroam\_duyuru template:" and an example of the template.</td></tr><tr><td>Option descriptions</td><td>**Smart**: "By registration type (WP -&gt; WhatsApp, SMS -&gt; SMS)". **Announcement**: "Service/information, to everyone". **Marketing**: "Consented only (EmailingPermission)", that is, guests who gave commercial message consent.</td></tr><tr><td>Test card</td><td>"Before the bulk send, send the exact same message to your own number."</td></tr><tr><td>Confirmation window</td><td>If the recipients were not calculated it shows "(not calculated)"; press **Calculate** and try again. After you confirm, the button shows "Queueing…".</td></tr></tbody></table>

## Messages you may see

<table id="bkmrk-messagewhat-to-do-%22t"><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td>"The message cannot be empty." / "Please enter the message text first."</td><td>Fill in the message box.</td></tr><tr><td>"No valid mobile number was found for these criteria."</td><td>Switch the audience to **All history** or the type to **Announcement**; the chosen audience has no numbers.</td></tr><tr><td>"A pending send already exists for the same message."</td><td>The same announcement is already queued; check the pending send in the list.</td></tr><tr><td>"You cannot pick a past date. Please enter a future date and time." / "The scheduled send time is invalid."</td><td>Choose a future date and time.</td></tr><tr><td>"Invalid number. It must be 10 digits and start with 5 (example: 5321234567)."</td><td>Type the test number as 10 digits.</td></tr><tr><td>"Test send failed: …"</td><td>Read the reason; check the number and text and try again.</td></tr><tr><td>"Send #… has been queued again. Recipients: … (… SMS / … WhatsApp)."</td><td>**Send again** was confirmed.</td></tr><tr><td>"Scheduled send has been cancelled."</td><td>Cancellation is done.</td></tr><tr><td>"Save error: …"</td><td>Refresh the page and try again.</td></tr></tbody></table>

## Frequently asked questions

**What is the difference between Active guests and All history?**  
**Active guests** are guests whose Wi-Fi registration is valid right now (for example hotel guests in house, or guests whose Wi-Fi access has not expired). They do not need to be connected at that moment. **All history** is everyone who has ever registered on this device.

**Why did the estimated recipients drop when I chose Marketing?**  
Marketing messages only go to guests who gave commercial message consent. Guests without consent are removed from the list.

**I started the delivery. When do the messages go out?**  
The send is queued and goes out within a few minutes. You can follow it in the **Recent Deliveries** list and in the report.

**Why does my WhatsApp message start with "Dear guest"?**  
Bulk WhatsApp messages go through an approved template; your text is placed in the middle of it. On SMS the text goes as is.

## Related pages

- [Campaigns](/books/bumerang-guide/page/campaigns) (automatic messages)
- [Sending Calendar](/books/bumerang-guide/page/sending-calendar)
- [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests)

# Sending Calendar

## What is it for?

The **Send Schedule** (on screen: **Delivery Schedule**) shows how many people every campaign and survey in your account will reach in the next run, and through which channel. It answers "what happens if it runs now?". The screen only shows; it never starts a delivery.

## When do you use it?

- After publishing a campaign, to check that the message will really go out.
- When looking for the answer to "why is my campaign not sending?" (is the window closed, are there candidates).
- When you want to see whether the delivery engines are running.

## Before you start

- The screen shows the campaigns and surveys of **all devices** in your account (every NAS) together; the **NAS** column shows which device each belongs to.
- You cannot change campaigns and surveys here; go to [Campaigns](/books/bumerang-guide/page/campaigns) or [Surveys](/books/bumerang-guide/page/surveys).

## Step by step

1. In the left menu, under **Bumerang**, open the **CAMPAIGN** heading and click **Send Schedule**. ![Send Schedule link in the left menu](https://help.useroam.com/uploads/images/gallery/2026-09/gt-menu-en.png)
2. In the blue bar at the top (**Engines run every 5 minutes**), check when each of the four delivery engines last ran: **Campaign SMS**, **Campaign WhatsApp**, **Survey SMS**, **Survey WhatsApp**. A green dot means the engine ran in the last 6 minutes, orange means a delay of up to 20 minutes, red means the engine has stopped. Grey "no log" means no record was found. ![Engine health bar](https://help.useroam.com/uploads/images/gallery/2026-09/gt-motor-en.png)
3. In the **Campaigns** table, look at each campaign's **Next candidates (SMS)** and **Next candidates (WhatsApp)**: how many people the next run will reach on that channel. The **Trigger window** column shows the sending hours and the current state: *Open now* or *Closed now* (example: 10:00-21:00); with no hour limit it says *Always*. ![Campaigns table](https://help.useroam.com/uploads/images/gallery/2026-09/gt-kampanya-en.png)
4. In the **Surveys** table, see the next candidate count for surveys with an SMS or WhatsApp trigger. A tick in the **Portal** column means the survey is also shown on the Wi-Fi login screen; portal surveys do not use the delivery queue. ![Surveys table](https://help.useroam.com/uploads/images/gallery/2026-09/gt-anket-en.png)
5. Read the note at the bottom: candidate counts are live estimates; once the engine runs, the number may shift slightly after dedup, delivery and channel rules. "200+" means the count was capped at 200 for performance. ![Note at the bottom of the page](https://help.useroam.com/uploads/images/gallery/2026-09/gt-not-en.png)

## Table columns

<table id="bkmrk-columnmeaning-campai"><thead><tr><th>Column</th><th>Meaning</th></tr></thead><tbody><tr><td>**Campaign** / **Survey**</td><td>Its name.</td></tr><tr><td>**Status**</td><td>*Active* or *Paused*. Paused rows are faded; no candidates are counted and the window column says "Paused, no delivery".</td></tr><tr><td>**NAS**</td><td>The device the campaign or survey belongs to.</td></tr><tr><td>**Trigger**</td><td>*Welcome*, *Win-back* (We Missed You) or *Nth Visit* (Loyalty).</td></tr><tr><td>**Next candidates (SMS)** / **Next candidates (WhatsApp)**</td><td>The estimated number of people for the next run. A dash means that channel is not used.</td></tr><tr><td>**Trigger window**</td><td>The allowed sending hours and days (Mon, Tue, Wed, Thu, Fri, Sat, Sun). *Open now* / *Closed now*.</td></tr><tr><td>**Portal**</td><td>Surveys only: whether the survey is shown on the Wi-Fi login screen.</td></tr><tr><td>**Sent today** / **Last delivery**</td><td>Messages sent today and the time of the last delivery.</td></tr><tr><td>Empty table</td><td>"No campaigns yet." with a **Create a new campaign** link; "No surveys yet." with **Create a new survey**.</td></tr><tr><td>Card descriptions</td><td>Campaigns: "All active and paused campaigns in your account (every NAS). Candidate counts are calculated for active campaigns only." Surveys: "Estimated next candidate count for surveys with SMS/WhatsApp triggers enabled. Portal surveys are shown at login and do not use the delivery queue."</td></tr><tr><td>Page tour</td><td>**Engine health** ("Delivery engines run every 5 minutes. Here you see when each engine last ran.") and **Upcoming deliveries** ("Shows how many people each active campaign/survey will reach in the next run and through which channel.").</td></tr></tbody></table>

## Frequently asked questions

**The candidate count is always 0.**  
There are three possibilities: no guest meets the condition (for example no new guest in the last 24 hours), the consented audience is empty, or the trigger window is closed right now. Look at the *Closed now* badge on the row and at the [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests) count.

**An engine dot is red.**  
The engine has not run for more than 20 minutes. Wait a few minutes and refresh; if it stays red, contact support.

**Does opening this screen send messages?**  
No. The page is read only; it never starts a delivery.

## Related pages

- [Campaigns](/books/bumerang-guide/page/campaigns)
- [Surveys](/books/bumerang-guide/page/surveys)
- [Bulk Sending](/books/bumerang-guide/page/bulk-sending)

# Surveys

## What is it for?

The **Surveys** screen lists the satisfaction and feedback surveys you show to guests and shows their results. A survey can open on the Wi-Fi login screen, or go to the guest as a link by SMS / WhatsApp. It can send satisfied guests on to review sites such as Google. Product rating questions also appear as star badges on your digital menu.

If you are setting up a new survey, go to [Creating a survey](/books/bumerang-guide/page/creating-a-survey). This page covers reading the list and a survey's results, and exporting them.

## When do you use it?

- When you want to follow guest satisfaction (NPS, star rating).
- When you want to read the comments guests wrote.
- When you need survey results as Excel, CSV or PDF.

## Before you start

- Surveys are part of the Bumerang marketing package. Without it the screen says "Marketing Module Inactive": "A Marketing Pro license upgrade is required to use surveys, Google Review redirection and guest satisfaction measurement tools. Please contact your reseller."

## Step by step: read survey results

1. In the left menu, under **Bumerang**, open the **ENGAGEMENT** heading and click **Surveys**. The list opens: **Survey**, **Status**, **Questions**, **Responses**, **Completion**, **Created**, **Actions**. ![Surveys list](https://help.useroam.com/uploads/images/gallery/2026-09/an-menu-en.png)
2. Press the eye icon (**Details**) on a survey's row. The pencil icon (**Edit**) edits the survey. The **Review redirection** badge under the survey name shows that redirection to a review site is on for that survey. ![Details and Edit buttons on a list row](https://help.useroam.com/uploads/images/gallery/2026-09/an-liste-en.png)
3. The details screen opens on the **Summary** tab. At the top, four boxes: **Impressions** (total views), **Started** (start rate), **Completed** (completion rate), **Review Redirection** (redirection rate). Below: **Trigger Settings**, **Highest Scoring Question**, **Lowest Scoring Question**, **NPS Score** and **Latest Comments**. ![Survey details Summary tab](https://help.useroam.com/uploads/images/gallery/2026-09/an-ozet-en.png)
4. The **Questions** tab has a chart for each question: **Average** and distribution for score questions, **Option** / **Count** for choice questions, the latest answers for text questions. ![Questions tab](https://help.useroam.com/uploads/images/gallery/2026-09/an-sorular-en.png)
5. The **Review Platforms** tab shows how many times satisfied guests clicked each review site (**Platform Click Statistics**). Press **Add / Edit Platform** to add one. ![Review Platforms tab](https://help.useroam.com/uploads/images/gallery/2026-09/an-platform-en.png)
6. The **Raw Data** tab shows each survey session on one row: **Date**, **Channel**, **Guest** (masked), **Status**, the answer to each question and **Redir.** (whether the guest was sent to a review site). Use the search box to filter. ![Raw Data tab](https://help.useroam.com/uploads/images/gallery/2026-09/an-ham-en.png)
7. To get the results as a file, press **Export** at the top right: **Excel**, **CSV** or **Full Report (PDF)**. The PDF report opens as a PDF file in a new tab; you can download or print it there. ![Export menu](https://help.useroam.com/uploads/images/gallery/2026-09/an-disa-en.png)

## Items on the list screen

<table id="bkmrk-itemmeaning-status-b"><thead><tr><th>Item</th><th>Meaning</th></tr></thead><tbody><tr><td>Status badges</td><td>*Draft* (not shown to guests), *Active* (published), *Paused*, *Completed*, *Archive*.</td></tr><tr><td>Title</td><td>"Surveys and feedback forms for your guests". Without the package the top says "This module is not active yet".</td></tr><tr><td>SMS timing</td><td>In the SMS trigger box on the details screen the send time is written as "… minutes later", "… hours later", "… days later", "… weeks later" or "… months later".</td></tr><tr><td>**Completion**</td><td>Completed / started sessions and a percentage (example: 27 / 29, %93).</td></tr><tr><td>List tools</td><td>"… surveys shown", records per page (… records, **All**), the **Search:** box, and "… surveys / 1 - 5" at the bottom. With no results: "No surveys found" or "No surveys".</td></tr><tr><td>Empty list</td><td>"No Surveys Yet": "Create your first survey to measure guest satisfaction, increase your Google Review count or improve your service." and "You can start in 1 click with ready templates: NPS, Star, Star+Comment...". Press **Create My First Survey**.</td></tr><tr><td>Page tour</td><td>**Create a survey** ("Measure guest satisfaction: product rating questions appear as star badges on the menu.") and **Your surveys** ("Response volume and status are here. Use the buttons in the row for details and export.").</td></tr></tbody></table>

## Items on the details screen

<table id="bkmrk-itemmeaning-title-ro"><thead><tr><th>Item</th><th>Meaning</th></tr></thead><tbody><tr><td>Title row</td><td>Survey name, status badge, **Created:** date and description. On the right: **Export**, **Back to List**, **Edit**.</td></tr><tr><td>With no answers</td><td>"No Responses Yet": "This survey has not received any responses yet." If it is a draft: "The survey is in Draft status; set the status to "Active" to publish it."; if live: "Your survey is live. It will be shown when your guests connect to the wifi or click the SMS link." and an **Edit Survey** button.</td></tr><tr><td>**Trigger Settings**</td><td>**Captive Portal**: "Active: the modal opens when the guest signs in to the wifi" or *Inactive*; **Timing:** *Before login* / *After login*. **SMS Trigger**: "Active: automatic SMS is being sent", **Sent:** and clicks; the send time (*Immediately (as soon as login finishes)*, … minutes / hours / days / weeks / months later). **Target Audience**: *All guests*, *First-time visitors* or *Returning guests*; **Min. logins:**, **Repeat interval:** … days, "Mandatory: cannot be skipped", **Display/SMS time range:**. **Edit** on the right opens the settings.</td></tr><tr><td>**NPS Score**</td><td>"Promoter (9-10) − Detractor (0-6)": the share of guests scoring 9-10 minus the share scoring 0-6. Below it: **Promoter (9-10)**, **Passive (7-8)**, **Detractor (0-6)** counts and "based on … responses".</td></tr><tr><td>**Latest Comments**</td><td>"The latest text answers written by guests", with masked phone and date.</td></tr><tr><td>Question types</td><td>*Star 1-5*, *NPS 0-10*, *Emoji*, *Single Choice*, *Multiple Choice*, *Yes/No*, *Text*. Required questions have a *Required* badge. With no answers: "This question has not been answered yet." or "Question charts cannot be shown because there are no answers yet.". Text questions show "Last … answers".</td></tr><tr><td>Platform table</td><td>**Platform**, **Status**, **Clicks**; the main target has a *Primary* badge; with no address it says "URL empty". **Total redirection clicks:**. With no platform: "No review platform has been added to this survey yet." and **Add Platform**.</td></tr><tr><td>Raw Data statuses</td><td>*Shown*, *Started*, *Completed*, *Skipped*, *Expired*; the **Redir.** column shows *Yes* / *No* or "Redirected (no platform information)". Channel: *Portal*, *SMS*. At the top: "… sessions"; the screen shows a limited number of rows ("(first … shown; download "Excel" or "CSV" for all)"). With no sessions: "No sessions yet. Once the survey is published and answers start arriving, you can see the detail of every session here." List tools: "… sessions / 1 - 25", "No records", "No sessions". Top right: **Excel**, **CSV**, **PDF Report**.</td></tr></tbody></table>

## PDF report (Survey Report)

**Full Report (PDF)** or **PDF Report** produces a PDF file: **Report Date:**, **Survey Created:**, **General Statistics** (**Impressions**, **Started**, **Completed**, **Review Redirection**), **NPS Score**, **Question Details** (for choice questions **Option**, **Count**, **Distribution**; for text questions "text answers (at most 50 shown)") and **Review Platform Redirections** (**Platform**, **Status** *Active* / *Inactive*, **Clicks**). The bottom says "All rights reserved". If you try to open another account's survey you see "Unauthorized access" or "Survey not found".

## Frequently asked questions

**My survey is never shown.**  
Its status may be *Draft*; use **Edit** to set it to **Active (published)**. Check the trigger settings as well (see Creating a survey).

**Many impressions, few completions.**  
Guests may be skipping the survey (*Skipped* in Raw Data). Try fewer questions.

**My NPS is negative.**  
More guests scored 0-6 than 9-10. Look at the complaints in **Latest Comments**.

**Why are phone numbers starred?**  
Guest phone numbers are masked under KVKK.

## Related pages

- [Creating a survey](/books/bumerang-guide/page/creating-a-survey)
- [Bumerang Reports](/books/bumerang-guide/page/bumerang-reports) (Survey Results Summary)
- [Sending Calendar](/books/bumerang-guide/page/sending-calendar)

# Creating a survey

## What is it for?

This page walks you through setting up your first survey from a ready template or an empty draft and publishing it: you add questions, choose where and to whom the survey is shown, and send satisfied guests on to review sites (for example Google).

## When do you use it?

- When you start measuring guest satisfaction for the first time.
- When you want more Google reviews (review redirection).
- When you change the questions, display settings or review sites of an existing survey.

## Before you start

- You need the Bumerang marketing package.
- If you will use review redirection, have your venue's Google (or Booking, TripAdvisor...) review page address ready.
- Survey links by SMS and WhatsApp only go to guests who gave consent.

## Step by step

1. In the left menu, under **Bumerang**, open **Surveys** and press **New Survey** at the top right. ![New Survey button](https://help.useroam.com/uploads/images/gallery/2026-09/ao-yeni-btn-en.png)
2. Choose a template. The template names and questions are in Turkish: **Otel - NPS** (hotel, one recommendation score question), **Otel - Yıldız + Yorum** (hotel, stars + comment), **Restoran - Yıldız + Yorum** (restaurant, stars + comment) or **Boş Başla** (start empty). Each card shows the number of questions and the questions; the "Review redirection active" badge means redirection to review sites comes switched on. Press **Choose This Template** for a template or **Create Empty Survey** to start from scratch. The survey is created as a *Draft* and the edit screen opens. ![Survey templates](https://help.useroam.com/uploads/images/gallery/2026-09/ao-sablon-en.png)
3. In the **General** card of the **Survey Details** tab, type the **Survey Title** (required, at most 200 characters; example: `Were you satisfied with our service?`), the **Description** and the **Thank You Message**, and choose the **Language** (Türkçe or English). To publish, set **Status** to **Active (published)**; if it is not ready, leave **Draft (not shown)**. ![General card and Status box](https://help.useroam.com/uploads/images/gallery/2026-09/ao-genel-en.png)
4. In the **Triggering** card, choose where and to whom the survey is shown. To show it on the Wi-Fi login screen, switch on **Show on the captive portal** and choose the **Trigger Type**: **Before Login (Without Signing In)** or **After Login (Useroam Connector required)**. To send the survey as a message, switch on **Send the survey link by SMS** and **Send the survey link by WhatsApp**, then choose the **SMS sending time** and **WhatsApp sending time**. With **Target visitor** choose **All guests**, **First visit only** or **Returning guests only**. At the bottom are **Min. login count**, **Repeat display interval (days)** and the **Survey is mandatory** box. ![Triggering card](https://help.useroam.com/uploads/images/gallery/2026-09/ao-tetik-en.png)
5. In the **Review Redirection** card, switch on **Review redirection active**. Choose the **Redirection threshold** (example: `9` for NPS, `4` for stars, `3` for emoji) and **Which question type should it work on?** (**NPS (0-10)**, **Star (1-5)**, **Emoji (1-3)**). A guest scoring at or above the threshold is sent to the review site; a dissatisfied guest is not sent there and stays on an internal notice page. ![Review Redirection card](https://help.useroam.com/uploads/images/gallery/2026-09/ao-yonlendirme-en.png)
6. To save the settings on this tab, press **Save Changes** (on a new survey the button is **Create Survey**). "The survey was saved successfully." appears. **Cancel** leaves without saving. ![Save Changes button](https://help.useroam.com/uploads/images/gallery/2026-09/ao-kaydet-en.png)
7. Go to the **Questions** tab. **Existing Questions** lists the questions in the order guests see them; each shows its type, the *Required* and *Redirector* badges and its options. To delete one, press its **Delete** button and confirm. In the **Multi-language translation** card at the top, press **Translate** to have the survey translated into your portal's other languages. ![Questions tab and Existing Questions](https://help.useroam.com/uploads/images/gallery/2026-09/ao-sorular-en.png)
8. In the **Add New Question** form, choose the **Question Type** (**NPS 0-10**, **Star 1-5**, **Emoji**, **Single Choice**, **Multiple Choice**, **Open Text**, **Yes/No**) and type the **Question Text** (example: `How did you find our atmosphere?`). For choice questions, write one option per line in **Options**. Set **Order**, **Required answer** and **Review platform trigger** (redirect to the review site if this question gets a high score), then press **Add Question**. ![Add New Question form](https://help.useroam.com/uploads/images/gallery/2026-09/ao-soru-ekle-en.png)
9. On the **Review Platforms** tab, in **Add New Platform**, choose the **Platform** (Google, Booking.com, TripAdvisor, Tatil.com, Etstur, Tatilbudur, Yemeksepeti, Getir Yemek, DoktorTakvimi), paste your review page address into **URL (optional)** and press **Add**. A platform with an empty address is not shown to guests. ![Add New Platform section](https://help.useroam.com/uploads/images/gallery/2026-09/ao-platform-en.png)
10. If you ever need to delete a survey completely, use **Delete Survey Permanently** on the **Danger Zone** tab. This cannot be undone; all questions, sessions and answers are deleted with the survey. To keep the results, set the status to **Archive** instead. ![Danger Zone tab](https://help.useroam.com/uploads/images/gallery/2026-09/ao-tehlike-en.png)

## Survey Details fields

<table id="bkmrk-fieldwhat-it-does-su"><thead><tr><th>Field</th><th>What it does</th></tr></thead><tbody><tr><td>**Survey Title**</td><td>"The title the guest will see (max 200 characters)". Grey example: "Example: Were you satisfied with our service?".</td></tr><tr><td>**Description**</td><td>"A short note about the purpose of the survey (optional)".</td></tr><tr><td>**Thank You Message**</td><td>"The message shown after the survey is completed". Grey example: "Thank you for sharing your feedback with us!".</td></tr><tr><td>**Status**</td><td>**Draft (not shown)**, **Active (published)**, **Paused**, **Completed**, **Archive**. Only an Active survey is shown to guests.</td></tr><tr><td>**Show on the captive portal**</td><td>"Show the survey on the portal page when the guest connects to the wifi".</td></tr><tr><td>Smart channel note</td><td>"Smart channel: leave both on so every guest receives the survey through the channel they signed in with."</td></tr><tr><td>**Send the survey link by SMS**</td><td>"When both are on, each guest receives the survey through the channel they signed in with; nobody gets two messages. If only SMS is on, WhatsApp sign-ins also get SMS."</td></tr><tr><td>**SMS sending time** / **WhatsApp sending time**</td><td>**Immediately (as soon as login finishes)**, **30 minutes later**, **2 hours later**, **1 day later**, **3 days later**, **1 week later**, **1 month later**. "How long after the guest's last login the SMS is sent. It is sent even if the guest already saw the captive portal survey."</td></tr><tr><td>**Send the survey link by WhatsApp**</td><td>"Sent only to guests who signed in with WhatsApp and gave marketing consent (an approved WhatsApp template is required). If only this is on, SMS sign-ins get no survey."</td></tr><tr><td>**Min. login count**</td><td>"The survey is not shown until the guest login count exceeds this value". `0` means no login limit.</td></tr><tr><td>**Repeat display interval (days)**</td><td>"After how many days it can be shown to the same guest again (0 = once)". Example: `30`.</td></tr><tr><td>**Survey is mandatory**</td><td>"Survey is mandatory (the skip button is removed, internet is not opened until the user answers)". Use with care; it can annoy guests.</td></tr><tr><td>**Review redirection active**</td><td>"Redirect high scorers to the selected review platform and stop dissatisfied guests on an internal notice page. Manage the platform URLs from the "Review Platforms" tab."</td></tr><tr><td>**Redirection threshold**</td><td>"Guests scoring greater than or equal to this value are redirected (NPS: 9, Star: 4, Emoji: 3)".</td></tr></tbody></table>

## Items on the Questions and Platforms tabs

<table id="bkmrk-itemdescription-exis"><thead><tr><th>Item</th><th>Description</th></tr></thead><tbody><tr><td>**Existing Questions**</td><td>"Shown to the guest in this order". With no questions: "This survey has no questions yet. Add the first one with the form below." Choice questions show an "Options:" list.</td></tr><tr><td>Question form hints</td><td>Question text example "Example: How likely are you to recommend us to a friend?"; description "Help text the guest sees below (optional)"; options "Each option must be on a separate line" (example: Very satisfied, Satisfied, Undecided, Not satisfied); trigger "Redirect to the review platform if this question gets a high score".</td></tr><tr><td>**Multi-language translation**</td><td>"The survey is translated automatically into every language enabled on the guest portal. When you change the questions or title, the translations are queued to be refreshed." A status badge per language: *ready*, *queued*, *translating*, *error*. With none: "No translations yet."; with no questions **Translate** is disabled.</td></tr><tr><td>Platform info box</td><td>"Guests giving a high score are redirected to the primary platform you choose. You can add more than one platform and manage the URLs here. Platforms with an empty URL are not shown to guests."</td></tr><tr><td>**Linked Platforms**</td><td>"Primary = main redirection target". Each row has the *PRIMARY* badge, an address box, an **Active** switch and **Remove** ("Are you sure you want to remove the … platform?"). After changing addresses press **Save URLs**. With none: "This survey has no review platform yet. Add one below."; when all are added: "All review platforms have been added to this survey. Set one to inactive to stop showing it to the guest."</td></tr><tr><td>New platform</td><td>The **Platform** box starts with "Select..."; **URL (optional)** shows "You can enter it later".</td></tr><tr><td>Template screen texts</td><td>Subtitle "Start with a ready template or design from scratch". The empty card says "Start with an empty draft and add your own questions.". The info box below: "After choosing a template you can edit all settings (title, questions, triggering, Google Review). The survey is created as a Draft by default; set the status to "Active" to publish it." **Back to List** returns to the Surveys list.</td></tr><tr><td>Card titles</td><td>The Triggering card: "Where and to whom the survey is shown"; the Review Redirection card: "Redirect satisfied guests to review platforms". When deleting a question you are asked "Are you sure you want to delete this question?". Danger Zone text: "Use the button below if you want to delete this survey completely. This action cannot be undone; all questions, sessions and answers are deleted with the survey."</td></tr><tr><td>Top buttons</td><td>**Back to List** and **Details**. The title is "Edit Survey: …" with the subtitle "Manage the survey details and questions" (on a new survey "Create a new survey for your guests"). Path: Home, Marketing, Surveys, Edit (or New).</td></tr></tbody></table>

## Messages you may see

<table id="bkmrk-messagewhat-to-do-%22t"><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td>"The survey was saved successfully." / "Question added." / "Question deleted." / "Review platforms saved." / "New platform added." / "Platform removed."</td><td>Done.</td></tr><tr><td>"Enter at least 1 option for choice type questions."</td><td>Write one option per line in **Options**.</td></tr><tr><td>"Platform selection is required."</td><td>Choose a site in **Platform**.</td></tr><tr><td>"The platform could not be added (it may already be linked)."</td><td>Check the **Linked Platforms** list.</td></tr><tr><td>"The survey could not be created." / "The survey could not be updated." / "The question could not be added." / "The question could not be deleted." / "The survey could not be deleted." / "The platform could not be removed."</td><td>Refresh the page and try again.</td></tr><tr><td>"Invalid template selection." / "Template could not be applied." / "Error: …"</td><td>Go back to **New Survey** and choose the template again.</td></tr><tr><td>"Are you sure you want to PERMANENTLY delete the survey and all its answers? This action cannot be undone."</td><td>Delete confirmation. If unsure, cancel and use **Archive**.</td></tr></tbody></table>

## Frequently asked questions

**Should I choose Before Login or After Login?**  
Before Login shows the survey on the Wi-Fi login screen before the guest signs in. After Login shows it once the guest is online; this needs Useroam Connector on your device. If unsure, ask support which one works for your device.

**How many times is the survey shown to the same guest?**  
**Repeat display interval (days)** decides. With `0` it is shown once.

**Why was the guest not sent to the review site?**  
The score may be under the threshold, or the platform address is empty. Enter the address on the **Review Platforms** tab and press **Save URLs**.

**Can I change a template's questions?**  
Yes. The template is only a starting point; the title, questions, triggering and review settings can all be edited later.

## Related pages

- [Surveys](/books/bumerang-guide/page/surveys) (results and export)
- [Sending Calendar](/books/bumerang-guide/page/sending-calendar)
- [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests)

# Advertisements

## What is it for?

**Ads** manages your own ads and announcements shown on the Wi-Fi login screen (captive portal), after login or on the hotel guest portal: "Ads shown on the captive sign-in page and after login". You use the screen guests already look at while connecting to promote your campaign.

## When do you use it?

- When you want everyone who connects to Wi-Fi to see a discount, a new product or an event.
- When you want to show a different announcement at certain hours or days.
- When you want to see how often an ad was shown and clicked.

## Before you start

- You need the Bumerang marketing module; without it the screen says "Bumerang marketing module is disabled".
- The right device must be selected in the panel; otherwise you see "No device selected. Please pick a device from the top menu."

## Step by step: create an ad

1. In the left menu, under **Bumerang**, open the **ENGAGEMENT** heading, click **Ads** and press **New Ad** at the top right. With an empty list you see "No ads yet." and a **Create your first ad** link. ![Ads list and the New Ad button](https://help.useroam.com/uploads/images/gallery/2026-09/rk-menu-en.png)
2. In the **Content** card, fill in **Title** (optional) and **Text (HTML allowed)** (example: `20% off at the spa this week`). If you add an image or video, the text is not required. ![Content card](https://help.useroam.com/uploads/images/gallery/2026-09/rk-icerik-en.png)
3. In the **1. Appearance (choose this first)** card, choose the **Ad type** (**Popup**, **Full screen**, **Banner**) and the **Placement** (**Sign-in**, **After login**, **Hotel guest portal**). The selected button turns solid blue. ![Ad type and Placement](https://help.useroam.com/uploads/images/gallery/2026-09/rk-gorunum-en.png)
4. In the **2. Media** card, upload an image or video (MP4/WEBM, max 25MB). The blue strip shows the recommended size for the chosen type: Popup 1200 x 900 px (4:3), Full screen 1080 x 1920 px (9:16, portrait), Banner 1500 x 300 px (5:1, wide). When you upload an image, pick the area in the **Crop image** window and press **Crop and use**. For **Where the click goes**, choose **Pick from my pages (Menu / Hotel)** or **Custom address (URL)**. ![Media card and click target](https://help.useroam.com/uploads/images/gallery/2026-09/rk-medya-en.png)
5. In the **Targeting** card, choose the **Audience** (**Everyone**, **New**, **Returning**) and **Show to the same guest at most (once every N hours)** (`0` = show on every connection). ![Targeting card](https://help.useroam.com/uploads/images/gallery/2026-09/rk-hedef-en.png)
6. In the **Schedule** card you can choose a **Start** and **End** date, **Time (start)**, **Time (end)** and **Days (empty = every day)**. If you leave them empty, the ad is always shown. ![Schedule card](https://help.useroam.com/uploads/images/gallery/2026-09/rk-zaman-en.png)
7. In the **Publishing** card, enter **Auto-close (sec)** (`0` = manual, the guest closes it) and **Weight (rotation)** ("how often it shows when there are several ads"), switch on **Active (live)** and press **Save**. "Ad saved." appears. **Cancel** leaves without saving. ![Publishing card and the Save button](https://help.useroam.com/uploads/images/gallery/2026-09/rk-yayin-en.png)
8. Check the **Live Preview** on the right to see how the ad looks on a phone: "The preview approximates the device captive background and the ad type you picked." With an empty title it shows "Ad title", with empty text "Content preview". ![Live Preview](https://help.useroam.com/uploads/images/gallery/2026-09/rk-onizleme-en.png)

## Step by step: pause, edit or delete an ad

1. On the ad's row in the list, edit it with the pencil (**Edit Ad**), take it off air with **Pause**, put it back with **Publish**, or delete it with the bin (confirm the question; it is shown in Turkish, "Reklam silinsin mi?"). ![Edit, Pause and Delete buttons on a list row](https://help.useroam.com/uploads/images/gallery/2026-09/rk-liste-en.png)

## List columns

<table id="bkmrk-columnmeaning-titlet"><thead><tr><th>Column</th><th>Meaning</th></tr></thead><tbody><tr><td>**Title**</td><td>The ad's title.</td></tr><tr><td>**Type**</td><td>*Popup*, *Full screen*, *Banner*. Older ads may show "banner".</td></tr><tr><td>**Placement**</td><td>*Sign-in*, *After login*, *Hotel guest portal*. Older ads may show a raw value (for example "cikis").</td></tr><tr><td>**Audience**</td><td>*Everyone*, *New*, *Returning*.</td></tr><tr><td>**Schedule**</td><td>Start and end date; empty means no end.</td></tr><tr><td>**Impressions** / **Clicks**</td><td>How often it was shown and clicked.</td></tr><tr><td>**Status** / **Action**</td><td>*Active* or *Paused*; edit, **Pause** / **Publish**, delete.</td></tr></tbody></table>

## Warnings when saving

<table id="bkmrk-warningwhat-to-do-%22i"><thead><tr><th>Warning</th><th>What to do</th></tr></thead><tbody><tr><td>"If you do not add an image or video, enter at least a title or some text."</td><td>Add a title, text or media.</td></tr><tr><td>"Video must be MP4/WEBM and at most 25MB." / "Video could not be uploaded."</td><td>Save the video as MP4 or WEBM under 25MB and upload it again.</td></tr><tr><td>Form hints</td><td>Next to the text field "(not required if you add an image or video)"; in the upload box "Click to upload an image or video (MP4/WEBM, max 25MB)"; the size strip, for example "Recommended image for Popup: 1200 x 900 px (4:3)", "Recommended image for Full screen: 1080 x 1920 px (9:16, portrait)", "Recommended image for Banner: 1500 x 300 px (5:1, wide)". The page list is split into **Menus** and **Hotel in-house** groups. The path at the top: Home, Ads, Edit.</td></tr><tr><td>"Record not found."</td><td>The ad may have been deleted; go back to the list.</td></tr><tr><td>"This device has no menu or hotel page; you can enter a custom address."</td><td>Choose **Custom address (URL)** and type your web address.</td></tr><tr><td>When editing: "There is an existing image (upload a new one to replace it)"</td><td>Leave it if you do not want to change the image.</td></tr></tbody></table>

## Frequently asked questions

**My ad is not shown.**  
Check that **Active (live)** is on, the schedule covers today and the audience is right. If **Show to the same guest at most** is high, the same guest will not see the ad for a while.

**Which image size should I use?**  
The blue strip in the Media card shows the recommended size for the chosen type.

**After login or Sign-in?**  
Sign-in is shown on the login screen before the guest gets online. After login is shown once they are connected.

## Related pages

- [Campaigns](/books/bumerang-guide/page/campaigns)
- [Surveys](/books/bumerang-guide/page/surveys)

# Opted-in Guests

## What is it for?

**Opted-in Guests** is the list of guests who allowed marketing messages on your Wi-Fi login screen (captive portal). Bumerang campaigns can only go to these people, so this pool is the largest audience your campaigns can reach. On the screen the report itself is titled **Consented Guests**.

## When do you use it?

- Before setting up a campaign, to see how many people you can reach.
- To follow whether the pool is growing (how many new consents came in the last 7 days).
- When you need the consented guest list as a file for your KVKK records or accounting.

## Before you start

- The pool only grows if the consent box is shown on the Wi-Fi login screen. The box is switched on with the consent option on the **SMS Portal Settings** and **WhatsApp Portal** screens under **Captive Portal**. If you use Retail, the consent box in the store QR registration also adds guests to the pool.
- This screen is the same as the **Consented Guests** tab of the **Reports** screen; it also has its own shortcut in the left menu.

## Step by step

1. In the left menu, under **Bumerang**, open the **AUDIENCE &amp; AI** heading and click **Opted-in Guests**. ![Opted-in Guests link in the left menu](https://help.useroam.com/uploads/images/gallery/2026-09/iz-menu-en.png)
2. Read the four counter cards at the top: **Total consented guests**, **WhatsApp consented**, **SMS consented**, **New in last 7 days**. The cards show the all time pool, whatever dates you choose. The list below only shows new guests who consented within the selected date range. ![Counter cards and consented guest list](https://help.useroam.com/uploads/images/gallery/2026-09/iz-kartlar-en.png)
3. To narrow the list, choose a date range (**Start**, **End** or **7g** / **30g** / **90g**). In **Channel** choose **All**, **WhatsApp** or **SMS** and press **Apply**. **Clear** resets the filters. ![Channel filter and Apply button](https://help.useroam.com/uploads/images/gallery/2026-09/iz-kanal-en.png)
4. To get the list as a file, press **XLSX**, **PDF** or **CSV**. If you click a row, that guest's **Guest Journey** card opens (see [Bumerang Reports](/books/bumerang-guide/page/bumerang-reports)). ![XLSX, PDF and CSV buttons](https://help.useroam.com/uploads/images/gallery/2026-09/iz-kartlar-en.png)

## Fields on the screen

<table id="bkmrk-field-%2F-columnmeanin"><thead><tr><th>Field / column</th><th>Meaning</th></tr></thead><tbody><tr><td>**Total consented guests**</td><td>All guests who gave consent (the same phone number is counted once).</td></tr><tr><td>**WhatsApp consented** / **SMS consented**</td><td>Guests who registered and consented through WhatsApp or through SMS.</td></tr><tr><td>**New in last 7 days**</td><td>Guests who joined the pool in the last 7 days: how fast the pool grows.</td></tr><tr><td>Info box</td><td>"This pool shows how many guests your Bumerang campaigns can reach. The list shows new registrations in the selected date range; the counter cards show the all time consented pool."</td></tr><tr><td>**Phone**</td><td>Masked number. If you have the **View guest data (unmask)** permission, the eye icon reveals it.</td></tr><tr><td>**Registration Type**</td><td>*WhatsApp* or *SMS*.</td></tr><tr><td>**Full Name**</td><td>The name the guest entered (masked). If no name was entered, the cell is empty (a dash).</td></tr><tr><td>**Registration Date** / **Last Login** / **Login Count**</td><td>First registration, last Wi-Fi login and total number of logins.</td></tr><tr><td>**Overseas Consent**</td><td>Shows *Yes* if the guest also allowed their personal data to be transferred abroad.</td></tr><tr><td>"No data for this period and these filters."</td><td>No new consents in the selected range. Widen the date range; the cards still show the whole pool.</td></tr></tbody></table>

<div class="alert-box" id="bkmrk-kvkk%3A-the-screen-sho">**KVKK:** The screen shows "This report may contain personal data; process and store it under KVKK/GDPR." This list is your own explicitly consented guest data; follow KVKK rules when you share it.</div>## Frequently asked questions

**The cards say 500 but the list has 20 people. Is it a bug?**  
No. The cards show all time, the list only shows guests who consented within the selected date range.

**Everything shows 0.**  
The consent box may be switched off on your Wi-Fi login screen. Check the consent option on the **SMS Portal Settings** and **WhatsApp Portal** screens. The box is never pre-ticked; the guest ticks it.

**Why are my staff not on the list?**  
Phone numbers on the **Excluded Users** list are removed from this pool.

**Should I choose WhatsApp or SMS?**  
If you have more WhatsApp consents than SMS consents, keeping the WhatsApp channel on in your campaigns lets you reach more people.

## Related pages

- [Bumerang Reports](/books/bumerang-guide/page/bumerang-reports)
- [Campaigns](/books/bumerang-guide/page/campaigns)
- [Bulk Sending](/books/bumerang-guide/page/bulk-sending)

# Useroam AI · Autopilot

## What is it for?

**Useroam AI · Autopilot** is an AI assistant that scans your guest data regularly and does marketing work on your behalf. It notices guests who have not come for a while and prepares a win-back campaign, promotes a menu item that gets many views, and warns you about missing event settings. Under the heading "This week I did … things for you." you see what it did, item by item.

## When do you use it?

- When you have no time for campaigns and want to leave the work to automation.
- When reviewing the work Autopilot prepared that is waiting for your approval.
- When you want to stop Autopilot or change how it works (fully automatic or with approval).

## Before you start

- Autopilot is off by default. When off, the screen says "Leave Bumerang to me.": "I read your guest data, spot the opportunity, and run campaigns, surveys and menus on your behalf." Press **Start Autopilot** to start it ("Off by default · you can stop it anytime").
- Campaigns prepared by Autopilot also go only to consented guests.

## Step by step

1. In the left menu, under **Bumerang**, open the **AUDIENCE &amp; AI** heading and click **Useroam AI · Autopilot**. If Autopilot is on, the top shows the "Autopilot on · watching your data" badge and this week's work count ("I completed … of them automatically, … are awaiting your approval."). ![Autopilot screen](https://help.useroam.com/uploads/images/gallery/2026-09/op-menu-en.png)
2. Choose how it works at the top right. The **Automation rate** box shows what share of the work is done without approval. The mode button shows the current mode: **Approval Mode** (asks for your approval before sending) or **Fully Automatic** (sends without asking); press the button (**change**) to switch. To turn Autopilot off, press **Stop Autopilot**. ![Automation rate, mode and stop buttons](https://help.useroam.com/uploads/images/gallery/2026-09/op-mod-en.png)
3. Read the summary in the four boxes and two charts. Boxes: **completed automatically**, **awaiting your approval**, **guests reached**, **estimated returns**. The **What I worked on** chart shows the split of work into *Campaign*, *Survey*, *Menu*, *Alert* and *Event*; the **Who I focused on** chart shows consented guests as *Dormant*, *New*, *Regular*. ![What I worked on and Who I focused on charts](https://help.useroam.com/uploads/images/gallery/2026-09/op-grafik-en.png)
4. In the **What I did** list, items awaiting approval are at the top on a yellow background. Read the prepared message draft (the draft texts are in Turkish). If it is fine, press **Approve**: the campaign is set up and starts sending (for an event reminder the SMS goes out at once). If you do not want it, press **Skip**; the item leaves the approval queue and nothing is sent. ![Item awaiting approval and the Approve / Skip buttons](https://help.useroam.com/uploads/images/gallery/2026-09/op-onay-en.png)

## Items and messages on the screen

<table id="bkmrk-itemmeaning-automati"><thead><tr><th>Item</th><th>Meaning</th></tr></thead><tbody><tr><td>Automation rate subtitle</td><td>"I handle most of the work without waiting for your approval" (short form "I handle most of the work without approval").</td></tr><tr><td>Mode descriptions</td><td>On hover: "Fully automatic: sends without asking for approval" or "Approval mode: asks for your approval before sending".</td></tr><tr><td>Chart subtitles</td><td>"How this week's work breaks down by channel" and "segment breakdown of your … opted-in guests".</td></tr><tr><td>Work cards</td><td>Each card says what was done, a short reason and, if any, the expected effect (for example "~6 return estimate", "+ visibility"). Alert cards describe something you need to fix (for example an event with no start date).</td></tr><tr><td>Result of an approved event item</td><td>"… guests were sent an SMS", "All of them had already been messaged for this event", "License not eligible, nothing was sent" or "Event not eligible (inactive or its page has no QR)".</td></tr><tr><td>First opening</td><td>"Scanning your data…": "I just started, I'll list the opportunities I find in the first scan here."</td></tr><tr><td>Below the list</td><td>**Last scan:** date and time ("now" if there has been no scan yet).</td></tr></tbody></table>

## Frequently asked questions

**Should I choose Fully Automatic or Approval Mode?**  
**Approval Mode** is recommended at first: Autopilot prepares, and it is sent only if you read it and press **Approve**. Once you trust its messages you can switch to Fully Automatic.

**I approved it. When does the message go out?**  
When a campaign item is approved, the campaign is set up; the messages go out through the campaign engine within a few minutes, over the guest's login channel (WhatsApp or SMS). You see the new campaign on the **Campaigns** screen.

**The same alert appears many times in the list.**  
Autopilot may report a missing setting again at every scan. Fix what the alert describes (for example enter the start date in the Event Studio).

**How do I turn Autopilot off completely?**  
Press **Stop Autopilot**. Existing campaigns keep their own status; you can pause them on the **Campaigns** screen.

## Related pages

- [Campaigns](/books/bumerang-guide/page/campaigns)
- [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests)
- [Event Studio](/books/bumerang-guide/page/event-studio)

# Events

## What is it for?

**Events** is where you build an **invitation page** for a concert, opening, brunch or special night. The screen subtitle: *"Event invitation pages opened by QR: design, translate, share."* Guests open the page at `menu.useroam.com/e/...` and can RSVP. If you serve drinks or food at the event, you can send each guest a **personal QR**, have staff scan it, and see who received what in the report.

> **How do I open this screen?** In the left menu go to **Bumerang → Business → Events**. The top of the screen reads *"Bumerang · Business"*.

![Events screen and New Event button](https://help.useroam.com/uploads/images/gallery/2026-09/e-liste-en.png)

## When to use it

- When you want to announce an event and collect RSVPs.
- When you want to track services such as coffee, food or cloakroom with QR codes.
- When you need a page to link from a campaign or bulk message.
- After the event, to see which staff member served how many guests.

## Before you start

- Your device needs a **Bumerang (marketing) licence**.
- The **Events** link in the left menu only appears when at least one event is set up and the module is on. The first time, the **Event** row on the **Business Modules** card of **Settings → Module Permissions** shows **Not set up · Set up**; the **Set up** link brings you here. Once set up, keep that row's switch on; switching it off removes the menu link and takes the guest pages offline.
- If you will use QR scanning, your departments (for example Restaurant, Waiter) and staff must be set up on **Bumerang → Staff**. Staff scan QR codes from the **Event** screen of the Useroam Go app.

## Step by step: your first event

1. Press **New Event** at the top right (with no events, the **Start in the Studio** button in the middle does the same). ![New Event button](https://help.useroam.com/uploads/images/gallery/2026-09/e-liste-en.png)
2. The **Event Studio** opens. Type the name into **Event Name \*** on the right (example: `Friday Jazz Night`), fill in **Date &amp; Time** and **Location**, then press **Save** at the top right. ![Event name and Save button](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-yeni-en.png)
3. Design the page by dragging elements from the left, add a cover image, optionally switch on the **RSVP Form**, and press **Save** again. Details: [Event Studio](/books/bumerang-guide/page/event-studio). ![Event Studio](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-genel-en.png)
4. Go back to the list (**All Events**). If the card does not show the green **● Live** badge (it shows grey **Draft**), press the play button (**Publish**) under the card. ![Event card and its buttons](https://help.useroam.com/uploads/images/gallery/2026-09/e-kart-en.png)
5. Copy the address with the clipboard button (**Copy link**) next to the `/e/...` link and share it on social media, in a campaign message or via **Bulk Send**. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-kart-en.png)
6. To use personal QR codes, press the chart button (**QR Scan Report**) on the card, type the guest's number and press **Send SMS** or **Send WhatsApp** (details below). ![Generate test link box and send buttons](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-gonder-en.png)
7. On the day, staff scan the guest's QR with Useroam Go. Scans appear immediately in the **QR Scan Report**. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-filtre-en.png)

## Event card

<table id="bkmrk-itemwhat-it-does-cov"><thead><tr><th>Item</th><th>What it does</th></tr></thead><tbody><tr><td>Cover image</td><td>Opens the studio (**Edit**).</td></tr><tr><td>**● Live** / **Draft**</td><td>Live: the page is open to guests. Draft: the page does not open.</td></tr><tr><td>Title and date</td><td>Event title, date (for example *"12 Sep 2026 · 20:00"*) and location. Without a date: *"No date set"*.</td></tr><tr><td>Eye icon and number</td><td>How many times the page was viewed.</td></tr><tr><td>People icon and **RSVPs**</td><td>Number of people who filled in the RSVP form. When above zero it is clickable and opens the RSVP list.</td></tr><tr><td>`/e/...` link</td><td>Opens the guest page in a new tab.</td></tr><tr><td>Clipboard icon (**Copy link**)</td><td>Copies the full address; the icon briefly turns into a tick.</td></tr><tr><td>Pause / play (**Unpublish** / **Publish**)</td><td>Message: *"Event unpublished."* or *"Event is live."*</td></tr><tr><td>Chart icon (**QR Scan Report**)</td><td>Sending personal links and the scan report.</td></tr><tr><td>Pencil (**Edit**)</td><td>Opens the studio.</td></tr><tr><td>Bin (**Delete**)</td><td>Deletes after *"Delete this event?"*: *"Event deleted."*</td></tr></tbody></table>

**Empty state:** with no events you see *"Create your first event"* and *"A concert, an opening, a special night… Build an invitation page shared by QR. AI writes the title and translates the languages; guests confirm their attendance."*

## RSVP list

Pressing the **RSVPs** count opens a list at the top: the event name and the number of **attendees**; columns **Name**, **Phone**, **People** (party size), **Note** and **Date**. Name and phone are masked for data protection. **CSV** downloads the list (also masked; columns Name, Phone, People, Note, Date). The cross closes it. With no RSVPs: *"No RSVPs yet."*

![RSVP list](https://help.useroam.com/uploads/images/gallery/2026-09/e-kat-en.png)

## QR Scan Report

Opened with the chart button on the card; the header shows the event name and **QR Scan Report**. The info box at the top explains the buttons:

- **Generate link**: sends no message at all; it only shows the personal link on screen.
- **Send SMS**: texts the guest *"Etkinlik QR kodunuz: &lt;link&gt;"* (the SMS is in Turkish). Enter 10 digits without a leading 0 or 90, for example `5321234567`.
- **Send WhatsApp**: sends the same link as a WhatsApp message; it goes out the moment you press the button and it is billable. A QR image cannot be attached, and it is not needed: the guest's QR code already carries this link.
- *"At most 5 messages per minute. Pressing twice for the same guest will not send a second message; you have to wait a minute."*

### Step by step: sending a guest their personal QR

1. Type the guest's number into **Generate test link (mobile number)** (`5321234567`) and their name into **Name (optional)**. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-gonder-en.png)
2. To try it first press **Generate link**. A green box shows *"Personal test link is ready. Opening it shows the QR code that staff can scan."* and the link. Pressing Enter also only generates the link and sends nothing. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-gonder-en.png)
3. To send it press **Send SMS** or **Send WhatsApp**. Result: *"Queued for SMS delivery; it leaves for the operator within a minute."* or *"WhatsApp message sent."* Sending again to the same number does not create a new link; the link the guest already has keeps working. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-liste-en.png)

![Number, name and send buttons](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-gonder-en.png)

### People who already have a link

The number of **records** is shown on the right. Info note: *"Phone and name are masked for data-protection reasons; to find someone, type their full number into the search box. "First invited" is when the guest was added to this event. "Last manual send" only covers messages sent from this panel or the staff app; an empty cell does NOT mean the person was never messaged, the invite may have gone out through a bulk campaign."*

- Type the number into **Search phone or name** and press **Search**; **Clear search** brings the list back.
- Columns: **Phone**, **Name**, **First invited**, **Last manual send**. The blue and green buttons on the row resend the same link by SMS or WhatsApp.
- With more than 100 people: *"Showing the 100 most recently added people. If the person you need is not here, type their number into the search box."*
- If the search finds nothing: *"No record matches your search. Try the 10-digit number (starting with 5), or clear the search and browse the list."*
- If no link was ever generated: *"No link has been generated for this event yet. Enter a number in the box above and send it; the person is added to this list automatically."*

![People who already have a link, with resend buttons](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-liste-en.png)

### Filter, counters and tables

Filter boxes: **Start date**, **End date**, **Department** and **Staff** (**All** shows everything). Press **Filter**; **Clear** removes it. With a filter on: *"Filter applied. All figures below and every downloaded file reflect this filter."*

![QR Scan Report: filter, counters and tables](https://help.useroam.com/uploads/images/gallery/2026-09/e-rapor-filtre-en.png)

<table id="bkmrk-counter-%2F-tablemeani"><thead><tr><th>Counter / table</th><th>Meaning</th></tr></thead><tbody><tr><td>**Connected to hotspot**</td><td>Distinct guests who joined the Wi-Fi between the event's start and end time. Without an end time: *"No date range set"*. Note: the studio has no end time field, so this box shows that text for most events.</td></tr><tr><td>**Links sent**</td><td>Guests who have a personal link.</td></tr><tr><td>**Guests scanned**</td><td>Distinct guests whose QR was scanned at least once.</td></tr><tr><td>**Total scans**</td><td>Number of all scans.</td></tr><tr><td>**Department** chips</td><td>For each department, the number of **scans** and **guests**.</td></tr><tr><td>**Scans by staff member**</td><td>**Staff**, **Total scans**, **Distinct guests**, **Departments**, **First / Last** scan time. Staff names are not masked.</td></tr><tr><td>**Staff breakdown by department**</td><td>Under each department, which staff member made how many scans.</td></tr><tr><td>**Scans by hour**</td><td>Bars for hours 0-23.</td></tr><tr><td>**Scans by guest**</td><td>**Guest**, **Phone** (masked), **Total scans**, **Departments**. Guests with a link but no scans show *"never scanned"*.</td></tr><tr><td>Scan list</td><td>Each scan: **Time**, **Guest**, **Phone**, **Department**, **Staff**. With no scans: *"No QR codes scanned yet."*</td></tr></tbody></table>

The **CSV**, **XLSX** and **PDF** buttons next to the staff, guest and scan tables download that table with the current filter (file title *"Event QR Report"*). The note at the bottom: *"Instagram engagement is self-reported by the guest and is not verified."*

## Messages you may see

<table id="bkmrk-messagewhat-to-do-en"><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td>*Enter a valid mobile number (10 digits starting with 5).*</td><td>Type the number as `5321234567`.</td></tr><tr><td>*Could not generate link. Check that the event is published.*</td><td>Publish the event with the play button on the card.</td></tr><tr><td>*The event is not published, so the link would not open. Publish the event first.*</td><td>Publish, then send again.</td></tr><tr><td>*This record has no valid mobile number (10 digits starting with 5); no message was sent.*</td><td>Type the correct number in the box above and send again.</td></tr><tr><td>*You have hit the limit of 5 messages per minute. Please try again shortly.*</td><td>Wait a minute.</td></tr><tr><td>*This guest was messaged a moment ago. You can try again in a minute.*</td><td>Wait; this prevents double sending.</td></tr><tr><td>*The message could not be sent. Check the number and try again.*</td><td>Correct the number and try again.</td></tr><tr><td>*Record not found. Refresh the page and try again.* / *Event not found.*</td><td>Refresh; the event may have been deleted.</td></tr></tbody></table>

## Frequently asked questions

**A guest says the link does not open.**  
The event may be a **Draft**. Publish it with the play button on the card.

**If I send twice to the same guest, do they get two QR codes?**  
No. There is one link per number; resending sends the same link.

**How many times can a guest use the same QR?**  
Unlimited by default. Limit it with **QR scan rule** and **Allowance per department** in the studio.

**Why does the SMS not include the event name?**  
The SMS is deliberately short and without Turkish characters so it fits into one SMS.

**How do I promote the event with a campaign?**  
Add the `/e/...` link to a **Bumerang → Campaigns** or **Bulk Send** message.

## Related pages

- [Event Studio](/books/bumerang-guide/page/event-studio): page design, RSVP, languages, QR rules.
- [Useroam Go: Event](/books/useroam-go-staff-app/page/event): how staff scan the QR.
- [Bulk Sending](/books/bumerang-guide/page/bulk-sending) and [Campaigns](/books/bumerang-guide/page/campaigns).

# Event Studio

## What is it for?

The screen subtitle: *"Drag an element from the left, edit it on the canvas, customise it on the right"*.

**Event Studio** is where you design the event invitation page guests see on their phone. You build it with a title, date, location, cover image, colours and drag-and-drop blocks. The RSVP form, QR menu link, languages and QR scan rules are also set here.

> **How do I open this screen?** On **Bumerang → Business → Events**, press **New Event** or the pencil (**Edit**) on a card.

![Event Studio: elements on the left, phone preview in the middle, settings on the right](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-genel-en.png)

**Note:** some labels on this screen stay in Turkish even when the panel is in English; the Turkish label is given in brackets where that happens.

## When to use it

- When creating a new event (the first save happens here).
- When you want to add a programme, map, gallery or video to the invitation.
- When you want to switch on the RSVP form, translate the page or set QR service allowances.

## The three areas of the screen

- **Left: ELEMENTS.** **Heading**, **Text**, **Image**, **Gallery**, **Video**, **Button**, **Map**, **Divider**, **QR Code**, **HTML / CSS**; below them **ARTIFICIAL INTELLIGENCE** and **Generate with AI**.
- **Middle: phone preview.** Above it the page tabs (**Ana Sayfa**, the home page, and pages you add) and the **+** button.
- **Right: Page Settings.** General settings with no block selected; the block's settings when one is selected.

Top right: **All Events** (back to the list), **Open** (opens the guest page in a new tab; only for a saved event) and **Save**.

## Step by step: preparing the invitation

1. Type the name into **Event Name \*** and press **Save**. Without a name nothing is saved. After the first save you stay on the screen and *"Saved."* appears. Until you type a title, a new event's preview shows *"Event Title"*. ![Event name and Save](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-yeni-en.png)
2. Drag an element from the left into the phone. An empty page shows *"Drag an element from the left and drop it here"*. ![Text block dropped onto the phone](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-surukle-en.png)
3. Click the block; the right panel switches to its settings. Enter the text or link. Use the back arrow (*"Back to Page Settings"*) to return. Reorder blocks with the **drag** handle or the **Up** / **Down** arrows; the bin (**Delete**) removes a block. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-surukle-en.png)
4. For an extra page press **+** (**Add page**) and answer *"New page name:"* (suggestion `Program`). Double-click a tab name to rename it via *"Page name:"*; the cross on a tab (**Delete page**) deletes the page. Up to 12 extra pages are saved. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-genel-en.png)
5. Scroll the right panel down, set the RSVP form, languages and QR rules, then press **Save**. Press **Open** to see the page. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-temel-en.png)

## Page Settings

![Page Settings panel](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-temel-en.png)

<table id="bkmrk-fieldwhat-it-doesexa"><thead><tr><th>Field</th><th>What it does</th><th>Example</th></tr></thead><tbody><tr><td>**Event Name \***</td><td>The event's name. Required.</td><td>`Friday Jazz Night`</td></tr><tr><td>**Title (name is used if empty)**</td><td>The large title at the top of the page.</td><td>`Jazz Night`</td></tr><tr><td>**Description**</td><td>Text under the title.</td><td></td></tr><tr><td>**Date &amp; Time**</td><td>Event start; shown on the page and in the list.</td><td>26.09.2026 20:00</td></tr><tr><td>**Location**</td><td>Place name; shown next to the date.</td><td>`Garden`</td></tr><tr><td>**Cover Image**</td><td>Paste a link (*"https://… or upload"*) or use the upload button. JPG, PNG, WEBP or GIF; at most 5 MB.</td><td></td></tr><tr><td>Theme (**Tema**): Main (**Ana**) / Accent (**Vurgu**), **Font**</td><td>Colours and typeface (Poppins, Inter, Fraunces, Montserrat).</td><td></td></tr></tbody></table>

## Menu Link and RSVP Form

![Menu Link and RSVP Form](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-rsvp-en.png)

- **Menu Link**: pick a QR menu and a **View Menu** button to that menu appears at the bottom of the page. Leave **No menu link** selected if you do not want one.
- **RSVP Form**: with **Show the form** on, a form appears at the bottom of the page where guests enter their name, phone, party size and a note. **Attendance heading** is the form title (if empty it reads *"I am attending"*; example `Book your seat`). The preview shows the **Your name** box and the **Register Me** button. Responses appear as **RSVPs** in the Events list.

## Languages and AI Translation

![Languages and AI Translation card](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-dil-en.png)

- **Language you write the content in**: the language you wrote the page in.
- **Languages to publish**: Turkish, English, Arabic, Russian, German, Persian. Selected ones become language buttons on the guest page.
- **Translate to selected languages with AI**: translates the content. The note below: *"After a change, save first, then translate."* When done it shows how many languages were translated. For an unsaved event the button is replaced by *"Save first, then AI translation appears."* Without an extra language: *"Pick at least one language other than the one you wrote in."*; trying before saving: *"Save first, then translate."*

## Preview link

![Preview link card](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-onizleme-en.png)

Note: *"Enter a number and a name to generate that person a personal page link. The QR code is drawn only on that link."* Fill in the number (`5321234567`) and **Name (optional)**, then press **Generate**; *"The generated link opens in a new tab."* For an unsaved event: *"Save first, then you can generate a preview link."* This sends no message.

## QR scan rule and Allowance per department

![QR scan rule and department allowances](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-qrkural-en.png)

- **One use per department**: off (default) means **unlimited scans**: the same guest can be scanned again and again and every scan is reported. On means each guest can be scanned **only once in each department**; on a second attempt staff see an "already used" warning (this explanation is shown in Turkish on screen).
- **Allowance per department**: *"How many times PER DAY a guest can have their QR code scanned in each department. Example: enter 5 for Coffee and the guest gets at most 5 coffees per day, after which staff see a "no allowance left" warning."* Each department has a number box and a period: **Renews daily** or **Whole event**. The note below: *"A department left blank has no limit. The allowance is DAILY: it resets every midnight. Example: enter 1 for Coffee and the guest gets 1 coffee per day."* (With Whole event the allowance does not renew.)
- Without departments: *"No departments defined for this device."* Add them on **Bumerang → Staff**.

## Block settings

Every block has a Style (**Stil**) card at the bottom: Alignment (**Hizalama**: left, centre, right), **Text colour**, **Background** (each with **reset**), and sliders for **Text size**, **Inner spacing**, **Corner rounding** and **Top spacing**.

<table id="bkmrk-blocksettings-headin"><thead><tr><th>Block</th><th>Settings</th></tr></thead><tbody><tr><td>**Heading**</td><td>**Heading text** (a new block reads *"New Heading"*).</td></tr><tr><td>**Text**</td><td>**Subheading** and **Text**. The text toolbar has **Bold**, **Italic**, **Underline**, **Add link** (asks *"Link (https://…):"*), **Remove link**, **Clear formatting**. A new block starts with *"Write your text here…"*; an empty box shows *"Write your text…"*.</td></tr><tr><td>**Image**</td><td>**Image URL** or the upload button. While empty the preview shows *"Image: add a URL on the right"*.</td></tr><tr><td>**Gallery**</td><td>**Images** list: one link per row, **Add URL** opens a new row, **Add image** uploads a file, the cross is *"Remove this image"*. For many images, paste links into **Have a lot? Paste your list** (one per line or separated by spaces; the box shows `https://ornek.com/1.jpg https://ornek.com/2.jpg`) and press **Add list**. While empty: *"Gallery: add images on the right"*.</td></tr><tr><td>**Video**</td><td>YouTube link (**YouTube linki**). While empty: *"Video: YouTube link on the right"*. File upload is not available.</td></tr><tr><td>**Button**</td><td>**Button text** (default *"View Button"*), **Target**: **External link (URL)** or one of your pages (*"Page: Rules"*). For an external link, the **Link** box. With no extra page the note says *"To target an internal page, first add a new page from the top."*</td></tr><tr><td>**Map**</td><td>**Address** and **Button text** (default "Yol Tarifi", directions).</td></tr><tr><td>**Divider**</td><td>No settings: *"A divider is just a separator line; it needs no content."*</td></tr><tr><td>**HTML / CSS**</td><td>**HTML / CSS / JS code** and **Height (pixels)**. Note: *"The frame cannot measure its own height; adjust it manually to fit the content."* The code runs in an isolated frame. A new block comes with a sample design titled *"Your own design"* reading *"HTML, CSS and JavaScript can be used freely in this block."* With empty code the preview shows *"HTML: write code on the right"*.</td></tr><tr><td>**QR Code**</td><td>A guest-specific QR code. The block text explains that the QR is drawn when the page is opened from a personal link, otherwise the warning below appears, and staff scan this QR to record the service. Settings: **Title** (example `Your QR code`), **Alt not** (sub note, example *"Show this code to the staff member"*), **Warning shown when there is no personal link** (example *"This page must be opened from the personal link sent to you."*) and **Generate a test link**: type a number and optional name and press **Generate** (*"Enter a number, open that person the personal link and see the QR code."*; *"Opens in a new tab; the QR is drawn on that link."*). For an unsaved event: *"Save the event first."* In the preview the block appears as a placeholder square labelled **Guest-specific QR** and *"a personal link"*.</td></tr></tbody></table>

## Generate with AI

![Generate Content with AI dialog](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-ai-en.png)

1. Press **Generate with AI** on the left. The **Generate Content with AI** dialog opens. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-ai-en.png)
2. Type the topic into **Content topic** (example: `Friday night live DJ set`) or enter your website address in **or your website** (optional). Note: *"If you provide an address, your site is read; the venue name, description and any date and location are taken from it."*![](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-ai-en.png)
3. Press **Generate**. You see *"Reading your site and preparing the content…"* or *"Preparing the content…"*. When done: *"Ready. The fields on the right have been filled, press Save."*![](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-ai-en.png)
4. Press **Save**. ![](https://help.useroam.com/uploads/images/gallery/2026-09/e-std-yeni-en.png)

<table id="bkmrk-messagewhat-to-do-wr"><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td>*Write the event topic or enter a web address.* / *Write a topic or enter a web address.*</td><td>Fill in at least one of the two boxes.</td></tr><tr><td>*Enter a valid web address.* / *This address cannot be read (local/private addresses are blocked).*</td><td>Enter a public website, for example `examplerestaurant.com`.</td></tr><tr><td>*No readable text was found on the site (it may be rendered with JavaScript). Please write the topic manually.*</td><td>Clear the address and type the topic yourself.</td></tr><tr><td>*The AI could not respond right now, please try again.* / *The AI output could not be read, please try again.* / *AI error* / *Connection error*</td><td>Press **Generate** again after a few seconds.</td></tr><tr><td>*This device has no marketing (Bumerang) licence, AI generation is disabled.*</td><td>Contact your sales team about the licence.</td></tr><tr><td>*The AI dialog could not be opened*</td><td>Refresh the page and try again.</td></tr></tbody></table>

## Image upload messages

- *"images only"*: only JPG, PNG, WEBP or GIF can be uploaded.
- *"en fazla 5MB"* (at most 5 MB): make the file smaller and try again.
- *"Upload failed"* / *"upload error"*: check your connection and try again.

## Frequently asked questions

**I saved but the page does not open.**  
The event may be a **Draft** in the list; publish it with the play button on the card.

**Why is the QR not visible on the page?**  
The QR is drawn only on the personal link. The public `/e/...` address shows the block's warning text instead. Send personal links from the **QR Scan Report** in the Events list.

**My changes disappeared.**  
The studio does not save automatically; press **Save** before leaving.

## Related pages

- [Events](/books/bumerang-guide/page/events): list, RSVPs, QR Scan Report.
- [Treasure Hunt Studio](/books/bumerang-guide/page/treasure-hunt-studio): the treasure hunt designer that works the same way.

# Treasure Hunt

## What is it for?

**Treasure Hunt** is a game that gives your guests scored tasks and encourages them to spend more time at your venue and share on social media. A guest signs in with the **code** you give them, completes tasks (for example "Try the dessert of the day") and sends a photo or text as proof. Points are added when you approve the submission on the **Approval Board**. A guest who reaches a point threshold wins the reward automatically.

The screen subtitle sums it up: *"Scored tasks, code based entry and an approval board."*

> **How do I open this screen?** In the left menu go to **Bumerang → Business → Treasure Hunt**. If it is not in the menu, see "Before you start" below.

![Treasure Hunt list screen](https://help.useroam.com/uploads/images/gallery/2026-09/oa-liste-en.png)

## When to use it

- When you want to give teams tasks during a contest, boat tour, camp or company event.
- When you want restaurant guests to try new items and post on social media.
- When you want to hand out a loyalty reward such as "20% off after 100 points".
- When you want to measure, with a report, how often each task is completed.

## Before you start

- Your device needs a **Bumerang (marketing) licence**. Without it the page sends you back to the Bumerang screen.
- The module appears on the **Business Modules** card of **Settings → Module Permissions**. If you have never created a treasure hunt, the row shows **Not set up · Set up**; the **Set up** link brings you to this screen. The **Treasure Hunt** link in the left menu only appears when a treasure hunt is set up and switched on.
- While the switch is on, the module works both in the panel and on the guest page. If you switch it off, it leaves the menu and the guest page goes offline.
- If your sub-users should see this screen, tick the **Treasure Hunt** box on their user card on the same page.

![Treasure Hunt row on the Business Modules card](https://help.useroam.com/uploads/images/gallery/2026-09/oa-izin-kart-en.png)

## Step by step: your first treasure hunt

1. On the **Treasure Hunt** screen, press **New Treasure Hunt** at the top right. ![New Treasure Hunt button](https://help.useroam.com/uploads/images/gallery/2026-09/oa-liste-yeni-en.png)
2. In the **Treasure Hunt Studio** that opens, type the hunt name into the first box on the right (the box is labelled **Event Name \*** on screen; it is the only required field). Example: `Taste Hunt`. Then press **Save** at the top right. After saving you stay on the studio screen and *"Saved."* appears at the top. ![Name field and Save button in the studio](https://help.useroam.com/uploads/images/gallery/2026-09/oa-studio-yeni-en.png)
    
    For page design details see [Treasure Hunt Studio](/books/bumerang-guide/page/treasure-hunt-studio).
3. Add **tasks**: press **Tasks** on the card in the list, type the task name into **Task** and its points into **Points**, choose the **Proof** type and press **Add**. Repeat for each task. ![Add task form](https://help.useroam.com/uploads/images/gallery/2026-09/oa-gorev-ekle-en.png)
4. Add **participant codes**: press **Participants** on the card. The easiest way is to type a number into **How many participants?** and press **Generate codes**. To add people one by one, use the form at the top and press **Add**. ![Generate codes form](https://help.useroam.com/uploads/images/gallery/2026-09/oa-kat-uret-en.png)
    
    **Important:** without codes nobody can sign in. Guests cannot register themselves.
5. Optionally define a **reward**: press **Rewards** on the card, type the reward name and the number of points needed, then press **Add**. ![Add reward form](https://help.useroam.com/uploads/images/gallery/2026-09/oa-odul-ekle-en.png)
6. Get the codes to the participants: press **QR cards** on the card and use **Print**, or use the **SMS** / WhatsApp buttons in the Participants table. ![QR cards and the Print button](https://help.useroam.com/uploads/images/gallery/2026-09/oa-qr-en.png)
7. Publish the hunt: a new treasure hunt starts with a grey **Draft** badge and guests cannot submit tasks. Go back to the list and press the power button (⏻) under the card; the badge turns green **Published** and *"Published."* appears. ![Treasure hunt card and its buttons](https://help.useroam.com/uploads/images/gallery/2026-09/oa-liste-kart-en.png)
8. When a guest scans the QR on their card, or opens `menu.useroam.com/oa/...` and types their code, they see the tasks. Every submitted task lands on the **Approval Board**; approve it there. Details: [Treasure Hunt Approval Board](/books/bumerang-guide/page/treasure-hunt-approval-board). ![Sign-in screen the guest sees on the phone](https://help.useroam.com/uploads/images/gallery/2026-09/oa-public.png)

## List screen and card buttons

Each treasure hunt is listed as a card showing its name, guest address (`menu.useroam.com/oa/`), number of active **tasks**, number of **participants**, and a yellow **pending** badge when submissions are waiting for approval.

<table id="bkmrk-button-%2F-badgewhat-i"><thead><tr><th>Button / badge</th><th>What it does</th></tr></thead><tbody><tr><td>**Published** / **Draft**</td><td>Green badge: the guest page is open. Grey badge: not published, guests cannot submit tasks.</td></tr><tr><td>**Design**</td><td>Opens the Treasure Hunt Studio (page design, end date, languages).</td></tr><tr><td>**Tasks**</td><td>Task add and edit panel.</td></tr><tr><td>**Participants**</td><td>Participant codes, phone numbers, sending by SMS/WhatsApp.</td></tr><tr><td>**QR cards**</td><td>A printable QR card for every participant.</td></tr><tr><td>**Rewards**</td><td>Reward definitions and the winners list.</td></tr><tr><td>**Approval Board**</td><td>Approve or reject submitted tasks.</td></tr><tr><td>**Report**</td><td>Per task tracking and ranking.</td></tr><tr><td>Power button (⏻)</td><td>Publishes or unpublishes. Message: *"Published."* or *"Unpublished."*</td></tr><tr><td>Bin</td><td>Deletes the treasure hunt after the *"Delete?"* confirmation (*"Deleted."*).</td></tr></tbody></table>

**Empty state:** with no treasure hunt you see the heading *"No treasure hunt yet"*, the text *"Score the tasks, upload participant codes, approve submissions from the board."* and the **New Treasure Hunt** button.

## Tasks panel

The new task form is at the top and the existing tasks table below it. Each row can be edited in place; confirm with the row's **Save** button.

<table id="bkmrk-fieldwhat-it-doesexa"><thead><tr><th>Field</th><th>What it does</th><th>Example</th></tr></thead><tbody><tr><td>**Task**</td><td>Task name shown to the guest. Required. If empty: *"Task title is required."*</td><td>`Try the dessert of the day`</td></tr><tr><td>**Description**</td><td>Short explanation (optional).</td><td>`Take a photo with the dessert`</td></tr><tr><td>**Points**</td><td>Points earned on approval (0 to 9999). Default 10.</td><td>`20`</td></tr><tr><td>**Proof**</td><td>What the guest sends: **Photo**, **Video**, **Photo or video**, **Text** or **No proof** (saying "done" is enough).</td><td>Photo</td></tr><tr><td>**Required**</td><td>When ticked, the guest cannot submit without proof.</td><td>ticked</td></tr><tr><td>**Repeatable**</td><td>When ticked, the same guest can submit the task several times and earn points each time. Otherwise it can be done once.</td><td>not ticked</td></tr><tr><td>**Status** switch</td><td>When off, the task is hidden from guests, the row turns grey and gets a **Draft** badge in the report.</td><td>on</td></tr><tr><td>Bin</td><td>Removes the task. Past submissions and points already earned are kept.</td><td></td></tr></tbody></table>

With no tasks the table shows *"No tasks added yet."* After adding you see *"Task added."*, after editing *"Saved."*. Press **Back to list** to close the panel.

**Note:** if you later change a task's points, already approved submissions keep their points; the new value only applies to future approvals.

## Participants panel

The note at the top reads: *"Participants can only sign in with the codes listed here; they cannot register themselves. The code is what the guest types: boat number, table number, team name..."* There are three ways to add participants:

### 1. Add a single participant

![Add a single participant form](https://help.useroam.com/uploads/images/gallery/2026-09/oa-kat-ekle-en.png)

<table id="bkmrk-fieldwhat-it-doesexa-1"><thead><tr><th>Field</th><th>What it does</th><th>Example</th></tr></thead><tbody><tr><td>**Code**</td><td>The code the guest types. *"Leave blank to generate automatically"*. *"Code must be at least 4 characters. Leave blank and a unique code is generated."* A shorter code is rejected so it cannot be guessed. If the code exists: *"This code is already on the list."*</td><td>`M042` or blank</td></tr><tr><td>**Name / Team** (optional)</td><td>The participant's or team's name. Can be edited later in the table.</td><td>`Blue Team`</td></tr><tr><td>**Mobile number (optional)**</td><td>*"If entered, the participant receives their code and personal link by SMS."* Enter 10 digits without a leading 0.</td><td>`5321234567`</td></tr><tr><td>**Add**</td><td>Adds the participant: *"Participant added."* With a number you also see *"Code sent by SMS."* If the number is not 10 digits the participant is still added, with the warning *"The number must be 10 digits (5xxxxxxxxx); no SMS was sent."*</td><td></td></tr></tbody></table>

### 2. Generate codes automatically (recommended)

Type a number (1 to 500) into **How many participants?** and press **Generate codes**. The note says: *"The safest option: unguessable 6-character codes with no confusing letters (e.g. K7M4QX). Read them from the list and hand them out."* The result tells you how many codes were generated.

![How many participants and Generate codes](https://help.useroam.com/uploads/images/gallery/2026-09/oa-kat-uret-en.png)

### 3. Paste a whole list

Click **Many participants? Paste the whole list at once**. Paste the codes into the box (it shows the example *"42, 43, 128 ... or one code per line"*) and press **Add codes**. The note under the box: *"Write one code per line (or paste the Excel column). You can add the names later from the table."* The message tells you how many codes were added and how many already existed (those are skipped).

![Paste list box](https://help.useroam.com/uploads/images/gallery/2026-09/oa-kat-toplu-en.png)

### Participants table

The box above the table explains the send buttons: **Send by SMS** sends the participant their code and personal link as text; **Send by WhatsApp** sends the same code and link as a WhatsApp message, and it goes out the moment you press the button. The third note: *"A QR image cannot be attached to the message, and it is not needed: the participant QR code already carries this same link, so we send the link itself. For printed QR cards:"* followed by the **Participant QR cards** link.

![Participants table and row buttons](https://help.useroam.com/uploads/images/gallery/2026-09/oa-kat-tablo-en.png)

<table id="bkmrk-column-%2F-buttonwhat-"><thead><tr><th>Column / button</th><th>What it does</th></tr></thead><tbody><tr><td>**Code**</td><td>The participant's sign-in code.</td></tr><tr><td>**Name / Team**</td><td>Type in the box and press the tick (✓) next to it to save.</td></tr><tr><td>**Phone**</td><td>Type the number and save with ✓. Saving an empty box deletes the number. Without a number, red *"Enter a number first"* appears below; after sending you see *"Last sent: 25.09 14:30"*.</td></tr><tr><td>**Points**</td><td>Points collected from approved tasks.</td></tr><tr><td>**Submissions**</td><td>Number of tasks the participant submitted (pending, approved and rejected).</td></tr><tr><td>**Status**</td><td>Green **Active** or grey **Blocked**. A blocked participant cannot sign in with their code and cannot win point threshold rewards.</td></tr><tr><td>Outgoing arrow</td><td>Opens the participant's personal page in a new tab (you appear signed in as that participant; use it for testing).</td></tr><tr><td>**SMS**</td><td>Sends the code and personal link by SMS: *"Code sent by SMS."* Greyed out when there is no number.</td></tr><tr><td>WhatsApp icon</td><td>Sends the same by WhatsApp immediately: *"WhatsApp message sent."*</td></tr><tr><td>Power button (⏻)</td><td>Switches the participant between Active and Blocked.</td></tr><tr><td>Bin</td><td>Deletes the participant, their submissions and rewards won. Cannot be undone.</td></tr></tbody></table>

With no participants you see *"No participant codes yet."* If old codes are shorter than 4 characters, a yellow warning says they can be guessed, that they keep working, and that you should generate codes for new participants.

## QR cards

The page is titled **Reward Hunt QR Cards**: *"Print the participant cards. Scanning the QR signs the participant in automatically."* Pick the hunt in the **Reward hunt** box; the number of **cards** is shown next to it. **Print** prints three columns per A4 page (menus and titles are hidden in print). Each card shows the **REWARD HUNT** heading, the hunt name, the QR code, the participant name, the code and the note *"Kamera çalışmazsa bu kodu girin."* / *"If the camera does not work, enter this code."*

- With no treasure hunt: *"There is no reward hunt for this device yet."* and a **Create a reward hunt** link.
- With no participants: *"This reward hunt has no participants. Cards cannot be printed without participants."* and an **Add participants** link.

**Careful:** the QR carries the personal link; whoever scans it signs in as that participant. Give each card only to its owner.

## Rewards panel

The note on screen: *"A participant who reaches the point threshold wins the reward automatically. Rank rewards are handed out with the button below when the hunt ends."*

![Add reward form with Rank selected](https://help.useroam.com/uploads/images/gallery/2026-09/oa-odul-ekle-en.png)

<table id="bkmrk-fieldwhat-it-doesexa-2"><thead><tr><th>Field</th><th>What it does</th><th>Example</th></tr></thead><tbody><tr><td>**Reward**</td><td>Reward name. Required; if empty: *"Reward name is required."*</td><td>`Captain's Coffee`</td></tr><tr><td>**Description** (optional)</td><td>Short note shown to the guest.</td><td>`Show at the counter`</td></tr><tr><td>**Winning condition**</td><td>**Point threshold**: everyone reaching the points wins, automatically at approval. **Rank**: the top N win at the end of the hunt, handed out manually.</td><td>Point threshold</td></tr><tr><td>**At how many points**</td><td>Shown when Point threshold is selected.</td><td>`100`</td></tr><tr><td>**Top how many**</td><td>Shown when Rank is selected.</td><td>`3`</td></tr><tr><td>**Menu discount** (optional)</td><td>**None**, **Percent (%)** or **Amount** and its value. Note: *"If you set a menu discount, the participant reaches the QR menu from the reward card and the discount is applied to prices. It stays valid until you mark it as handed over."*</td><td>Percent, `20`</td></tr></tbody></table>

Without a number for the condition you see *"Enter a number for the winning condition."* After adding: *"Reward added."* The table shows each reward's **Winners** count, a **Status** switch, **Save** and a delete button. With no rewards: *"No rewards defined yet."*

### Winners and handover

![Winners list, end hunt and handed over buttons](https://help.useroam.com/uploads/images/gallery/2026-09/oa-odul-tablo-en.png)

- The **Winners** table: **Code**, **Name / Team**, **Reward**, **Points** at the time of winning and **Handover** status (yellow **Pending** or the green handover date). With no winners: *"Nobody has won a reward yet."*
- When you give the reward to the guest, press **Handed over** on the row: *"Marked as handed over."* Any menu discount ends at that moment.
- When a rank reward exists, the **End the hunt, hand out rank rewards** button appears. Note: *"Ranking changes during the hunt; this button freezes the current leaderboard and hands out the rewards. A granted reward is never revoked."* Confirmation: *"Rank rewards will be handed out based on the current leaderboard. Continue?"* The result tells you how many rewards were handed out.

**Note:** a reward already won is not taken back even if a submission is later rejected and points drop (the guest may already have received it).

## Report

![Treasure hunt report](https://help.useroam.com/uploads/images/gallery/2026-09/oa-rapor-en.png)

- Counters at the top: **Participants**, **With points**, **Submissions**, **Pending** and **Points granted**. With pending items an **Approval Board (4)** button appears.
- **Per task tracking** table: **Task**, **Points**, **Submissions**, **Pending**, **Approved**, **Rejected**, **Completed by** (number of different people approved), **Points granted** and thumbnails of the last 4 **Proof** items (click to enlarge). Switched-off tasks are grey with a **Draft** badge.
- **Ranking** table: the top 20 participants by points. If nobody has points: *"No participant has points yet."*

## Messages you may see

<table id="bkmrk-messagemeaning-%2F-wha"><thead><tr><th>Message</th><th>Meaning / what to do</th></tr></thead><tbody><tr><td>*You need to enter a code.*</td><td>No code could be generated automatically. Type a code in the Code box and try again.</td></tr><tr><td>*Enter a number first*</td><td>The participant has no phone number. Type the 10-digit number and press ✓.</td></tr><tr><td>*This participant was messaged a moment ago. Please try again in a minute.*</td><td>Wait a minute; this prevents double sending.</td></tr><tr><td>*The message could not be sent. Check the number and try again.*</td><td>The number may be wrong; correct it and send again.</td></tr><tr><td>*Record not found.*</td><td>The record was deleted or belongs to another device. Go back to the list and refresh.</td></tr></tbody></table>

## Frequently asked questions

**Can a guest register on their own?**  
No. Only the codes you add can sign in. This stops strangers from collecting points.

**A guest submitted a task but their points did not increase.**  
Points are only added when the submission is approved on the **Approval Board**. Look for the yellow **pending** badge on the card.

**A guest says "I cannot submit a task".**  
Check: is the hunt **Published**, has the start time (**Date &amp; Time** in the studio) arrived, has the **End date** passed, is the participant **Blocked**, or is the task not repeatable and already submitted.

**Can I use the same code in two different hunts?**  
Yes. Codes are kept separately for each treasure hunt.

**Why does the SMS have no Turkish characters?**  
The SMS text is deliberately sent without Turkish characters so it fits into a single SMS and does not use two credits.

**Why does the QR page say "Reward Hunt" instead of "Treasure Hunt"?**  
It is the same module; the English panel uses two names for it.

## Related pages

- [Treasure Hunt Studio](/books/bumerang-guide/page/treasure-hunt-studio): guest page design, end date, languages.
- [Treasure Hunt Approval Board](/books/bumerang-guide/page/treasure-hunt-approval-board): approving and rejecting submissions.
- [Module Permissions](/books/settings/page/module-permissions): switching the module on/off and sub-user permission.

# Treasure Hunt Studio

The screen subtitle sums it up: *"Drag an element from the left, edit it on the canvas, customise it on the right"*.

## What is it for?

**Treasure Hunt Studio** is where you design the treasure hunt page the guest sees on their phone. You build the page with a title, description, cover image, colours and drag-and-drop blocks. The hunt's end date, proof rule, leaderboard and publishing languages are also set here.

> **How do I open this screen?** On **Bumerang → Business → Treasure Hunt**, press **Design** on the card. For a new hunt press **New Treasure Hunt**.

![Treasure Hunt Studio: elements on the left, phone preview in the middle, settings on the right](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-genel-en.png)

**Note:** some labels on this screen stay in Turkish even when the panel is in English. Where that happens, the Turkish label is given in brackets below.

## When to use it

- When creating a new treasure hunt (the first save happens here).
- When you want to add rules, a map, a gallery or a promo video to the guest page.
- When you want to change the end date or translate the page into other languages.

## The three areas of the screen

- **Left: ELEMENTS.** Blocks you can add: **Heading**, **Text**, **Image**, **Gallery**, **Video**, **Button**, **Map**, **Divider**, **QR Code**, **HTML / CSS**. Below them the **ARTIFICIAL INTELLIGENCE** heading and the **Generate with AI** button.
- **Middle: phone preview (canvas).** Shows live how the page will look to the guest. Above it are the page tabs (**Ana Sayfa**, the home page, and pages you add) and the **+** button.
- **Right: Page Settings.** With no block selected you see the page's general settings; with a block selected you see that block's settings.

Top right: **All Treasure Hunts** (back to the list), **Open** (opens the guest page in a new tab; only shown for a saved hunt) and **Save**.

## Step by step: preparing the page

1. Type the hunt name into the first box on the right and press **Save**. (The box is labelled **Event Name \*** on screen; it is the treasure hunt's name.) If empty: *"Treasure hunt name is required."* After the first save you stay on the same screen and *"Saved."* appears. ![Name field and Save button](https://help.useroam.com/uploads/images/gallery/2026-09/oa-studio-yeni-en.png)
2. Drag an element from the left into the phone in the middle. An empty page shows *"Drag an element from the left and drop it here"*; the element lands there. ![Text block dropped onto the phone](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-surukle-en.png)
3. Click the block on the phone. The right panel switches to that block's settings (for example **Heading Block**). Enter the text, link or image there; the preview changes instantly. Press the back arrow at the top left of the right panel (*"Back to Page Settings"*) to return to the page settings. ![Selected heading block and its settings on the right](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-blok-en.png)
4. To reorder blocks, use the **drag** handle that appears when you hover over a block, or the **Up** / **Down** arrows at the block's top right. The bin (**Delete**) removes the block. The cross on a page tab is called **Delete page**. ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-blok-en.png)
5. Add extra pages if you like: press **+** (**Add page**) next to the tabs and answer *"New page name:"* (the box suggests `Program`; type for example `Rules`). A single click on a tab switches to that page; double-click the tab name to rename it via *"Page name:"*. The cross on a tab deletes the page (*"Rules" page will be deleted. Continue?*). The home page cannot be deleted. Up to 12 extra pages are saved. ![Add page button](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-sayfa-en.png)
6. Scroll the right panel down and check your tasks on the **TASKS** card; press **Add task** for a new one (details below). ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-gorevler-en.png)
7. On the **TREASURE HUNT SETTINGS** card set the end date and languages, then press **Save**. Press **Open** to see the page. ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-ayarlar-en.png)

## Page Settings (no block selected)

<table id="bkmrk-fieldwhat-it-doesexa"><thead><tr><th>Field</th><th>What it does</th><th>Example</th></tr></thead><tbody><tr><td>**Event Name \***</td><td>The treasure hunt's name. Required. Used in the list, on QR cards and in the SMS.</td><td>`Useroam Bistro Taste Hunt`</td></tr><tr><td>**Title (name is used if empty)**</td><td>The large title at the top of the guest page. While empty, the preview of a new hunt shows *"Event Title"*.</td><td>`Taste Hunt`</td></tr><tr><td>**Description**</td><td>Intro text under the title.</td><td>`Complete tasks, collect points, win rewards!`</td></tr><tr><td>**Date &amp; Time**</td><td>Start time. Shown as a date on the page. Guests cannot submit tasks before it. If empty the hunt starts immediately.</td><td>12.08.2026 00:00</td></tr><tr><td>**Cover Image**</td><td>Image above the title. Paste a link (*"https://… or upload"*) or pick a file with the upload button. JPG, PNG, WEBP or GIF; at most 5 MB.</td><td></td></tr><tr><td>Theme (**Tema**): Main (**Ana**) / Accent (**Vurgu**)</td><td>Colour of the title background and highlights.</td><td>navy / green</td></tr><tr><td>**Font**</td><td>Typeface: Poppins, Inter, Fraunces, Montserrat.</td><td>Poppins</td></tr></tbody></table>

## TASKS card

![Tasks card and Add task button](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-gorevler-en.png)

- Each row shows the task name, its **points** on a navy badge, the **proof type** in grey (for example Photo, Text, No proof) and the number of **submissions** on a green badge.
- Below it a summary of the number of tasks and total points (for example *"6 tasks · 140 points total"*). With no tasks: *"No tasks added yet."*
- If the hunt has not been saved yet, the card only says *"Save first, then you can add tasks."*
- With no participant codes a yellow warning appears: *"No participant codes: nobody can sign in or see the tasks."* The **Add codes** link next to it opens the Participants panel.
- **Add task** opens the dialog below. **Edit tasks** opens the Tasks panel. **Participants** opens the Participants panel.

### Add task dialog

![Add task dialog](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-gorev-modal-en.png)

<table id="bkmrk-fieldwhat-it-doesexa-1"><thead><tr><th>Field</th><th>What it does</th><th>Example</th></tr></thead><tbody><tr><td>**Task**</td><td>Task name. Required.</td><td>`Sunrise video`</td></tr><tr><td>**Description**</td><td>Short explanation (optional).</td><td></td></tr><tr><td>**Points**</td><td>Points earned on approval. Default 10.</td><td>`10`</td></tr><tr><td>**Proof**</td><td>Photo, Video, Photo or video, Text or No proof.</td><td>Photo</td></tr><tr><td>**Required**</td><td>When ticked, submissions without proof are not accepted.</td><td>ticked</td></tr><tr><td>**Repeatable**</td><td>When ticked, the same guest can do the task more than once.</td><td>not ticked</td></tr><tr><td>**Add**</td><td>Saves the task and returns to the studio.</td><td></td></tr></tbody></table>

The dialog note: *"After saving the task you return to the design screen. Participants see the task on the page and mark it done; points are granted when approved on the approval board."*

**Important:** the dialog saves separately. If you changed anything else on the page, press **Save** first and then add the task; otherwise unsaved design changes are lost.

## TREASURE HUNT SETTINGS card

![Treasure Hunt Settings card](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-ayarlar-en.png)

<table id="bkmrk-fieldwhat-it-does-en"><thead><tr><th>Field</th><th>What it does</th></tr></thead><tbody><tr><td>**End date**</td><td>*"Leave empty for no end date. No new submissions after it ends."*</td></tr><tr><td>**Proof required for all tasks**</td><td>When on, every task requires proof, regardless of the task's "Required" tick.</td></tr><tr><td>**Show leaderboard to participants**</td><td>When on, the guest page shows the points ranking of the top 10 participants. On by default.</td></tr><tr><td>**Language you wrote the content in**</td><td>The language you wrote the page in (Turkish, English, Arabic, Russian, German, Persian).</td></tr><tr><td>**Languages to publish**</td><td>Languages offered as buttons (TR, EN...) at the top right of the guest page. The language you wrote in is always included.</td></tr><tr><td>**Translate to selected languages with AI**</td><td>Translates the title, description, blocks, tasks and rewards with AI. While running it shows *"Translating… 1/2 (en)"*, then *"✓ Translated into 2/2 languages."* Below it a status like *"Translated languages: EN"*.</td></tr><tr><td>**Report**</td><td>Opens the treasure hunt report.</td></tr></tbody></table>

- Before the hunt is saved, the translate button is replaced by *"Save the hunt first to translate it."*
- If you press translate without choosing a language other than the one you wrote in: *"Select at least one language other than the one you wrote in."*
- If you added tasks or rewards after translating, a yellow warning says some items are missing a translation and may have been added later: *"Translate again."* Press the button again.

## Block settings

Every block has a Style (**Stil**) card at the bottom: Alignment (**Hizalama**: left, centre, right), **Text colour**, **Background** (each with **reset**), and sliders for **Text size**, **Inner spacing**, **Corner rounding** and **Top spacing**.

<table id="bkmrk-blocksettings-headin"><thead><tr><th>Block</th><th>Settings</th></tr></thead><tbody><tr><td>**Heading**</td><td>**Heading text** (a new block reads *"New Heading"*).</td></tr><tr><td>**Text**</td><td>**Subheading** and **Text**. The text toolbar has **Bold**, **Italic**, **Underline**, **Add link** (asks *"Link (https://…):"*), **Remove link**, **Clear formatting**. A new block starts with *"Write your text here…"*; an empty box shows *"Write your text…"*.</td></tr><tr><td>**Image**</td><td>**Image URL** or the upload button. While empty the preview shows *"Image: add a URL on the right"*.</td></tr><tr><td>**Gallery**</td><td>**Images** list: one link per row, **Add URL** opens a new row, **Add image** uploads a file, the cross is *"Remove this image"*. For many images, paste links into **Have a lot? Paste your list** (one per line or separated by spaces; the box shows `https://ornek.com/1.jpg https://ornek.com/2.jpg`) and press **Add list**. While empty: *"Gallery: add images on the right"*.</td></tr><tr><td>**Video**</td><td>YouTube link (**YouTube linki**). While empty: *"Video: YouTube link on the right"*. File upload is not available.</td></tr><tr><td>**Button**</td><td>**Button text** (default *"View Button"*), **Target**: **External link (URL)** or one of your pages (*"Page: Rules"*). For an external link, the **Link** box. With no extra page the note says *"To target an internal page, first add a new page from the top."*</td></tr><tr><td>**Map**</td><td>**Address** and **Button text** (default "Yol Tarifi", directions).</td></tr><tr><td>**Divider**</td><td>No settings: *"A divider is just a separator line; it needs no content."*</td></tr><tr><td>**HTML / CSS**</td><td>**HTML / CSS / JS code** and **Height (pixels)**. Note: *"The frame cannot measure its own height; adjust it manually to fit the content."* The code runs in an isolated frame. A new block comes with a sample design titled *"Your own design"* reading *"HTML, CSS and JavaScript can be used freely in this block."* With empty code the preview shows *"HTML: write code on the right"*.</td></tr><tr><td>**QR Code**</td><td>This block comes from the Events module. **It does not draw a QR on the Treasure Hunt page**; the guest only sees the **Warning shown when there is no personal link** text (*"This page must be opened from the personal link sent to you."*). The block's description, **Title**, **Alt not** (sub note, example *"Show this code to the staff member"*) and the **Generate a test link** box (*"Enter a number, open that person the personal link and see the QR code."*, *"Opens in a new tab; the QR is drawn on that link."*, *"Save the event first."*) are meant for events and have no effect in Treasure Hunt. Use the **QR cards** screen for participant QR codes.</td></tr></tbody></table>

## Generate with AI

![Generate Content with AI dialog](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-ai-en.png)

1. Press **Generate with AI** on the left. The **Generate Content with AI** dialog opens. ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-ai-en.png)
2. Type the topic into **Content topic** (example: `Friday night live DJ set`) or enter your website address in **or your website** (optional). Note: *"If you provide an address, your site is read; the venue name, description and any date and location are taken from it."*![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-ai-en.png)
3. Press **Generate**. You see *"Reading your site and preparing the content…"* or *"Preparing the content…"*. When done: *"Ready. The fields on the right have been filled, press Save."*![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-std-ai-en.png)
4. Press **Save**. ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-studio-yeni-en.png)

<table id="bkmrk-messagewhat-to-do-wr"><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td>*Write a topic or enter a web address.*</td><td>Fill in at least one of the two boxes.</td></tr><tr><td>*Enter a valid web address.* / *This address cannot be read (local/private addresses are blocked).*</td><td>Enter a public website, for example `examplerestaurant.com`.</td></tr><tr><td>*No readable text was found on the site (it may be rendered with JavaScript). Please write the topic manually.*</td><td>Clear the address and type the topic yourself.</td></tr><tr><td>*The AI could not respond right now, please try again.* / *The AI output could not be read, please try again.* / *AI error* / *Connection error*</td><td>Press **Generate** again after a few seconds.</td></tr><tr><td>*This device has no marketing (Bumerang) licence, AI generation is disabled.*</td><td>Contact your sales team about the licence.</td></tr><tr><td>*The AI dialog could not be opened*</td><td>Refresh the page and try again.</td></tr></tbody></table>

## Image upload messages

- *"images only"*: only JPG, PNG, WEBP or GIF can be uploaded.
- *"en fazla 5MB"* (at most 5 MB): make the file smaller and try again.
- *"Upload failed"* / *"upload error"*: check your connection and try again.

## Frequently asked questions

**I saved, but guests cannot submit tasks.**  
A new hunt starts as **Draft**. Publish it with the power button on its card in the list. Also, if **Date &amp; Time** is in the future, submissions open only at that time.

**Why does the label say "Event Name"?**  
The studio uses the same foundation as the Events studio. This box is the treasure hunt's name.

**Can I upload a video file?**  
Not in the page design; the Video block works with a YouTube link. Guests, however, can send a video from their phone as task proof (when the task's proof type is Video or Photo or video).

**My changes disappeared.**  
The studio does not save automatically. Press **Save** before leaving the page or adding a task.

## Related pages

- [Treasure Hunt](/books/bumerang-guide/page/treasure-hunt): tasks, participants, rewards, QR cards, report.
- [Treasure Hunt Approval Board](/books/bumerang-guide/page/treasure-hunt-approval-board): approving submissions.

# Treasure Hunt Approval Board

## What is it for?

The **Approval Board** is where you see the tasks participants submitted (photo, video, text) and approve or reject them. **Points are only added when you approve here.** Point threshold rewards are also won automatically at the moment of approval.

> **How do I open this screen?** On **Bumerang → Business → Treasure Hunt**, press the blue **Approval Board** button on the card. The **Approval Board (4)** button in the report also brings you here.

![Approval Board, Pending tab](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-en.png)

## When to use it

- When you see a yellow **pending** badge on the treasure hunt card.
- During an event, to approve submissions regularly (guests want to see their points right away).
- To reject a wrong or inappropriate submission and tell the guest why.
- To undo a submission you approved earlier.

## Step by step: approving a submission

1. Make sure the **Pending** tab is open (its number is the count of pending submissions). Submissions are grouped by participant: each group starts with the **code** in a navy box, the participant name and their current points (**pts**). ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-en.png)
2. Look at the proof on the card. Click a photo to open it full size; a video plays on the card; text proof is shown at the top of the card. For a task without proof the card says *"Task without proof."*![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-bekleyen-en.png)
3. If it is fine, press the green tick (✓, **Approve**) at the bottom of the card. A message such as *"Approved, 40 points granted."* appears and the card moves to the **Approved** tab. ![Approve and reject buttons on a card](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-bekleyen-en.png)
4. If not, press the red cross (✗, **Reject**). Answer the question *"Reason for rejection (participant will see it):"* (example: `The photo is blurry, please send it again.`) and press OK. *"Rejected."* appears. The participant sees the reason on their page and can submit the task again. ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-red-en.png)

## Step by step: bulk approval

1. Tick the boxes on the cards you want to approve. To select all submissions of one participant, press **Select all from this person** in the group header (press again to clear). ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-toplu-en.png)
2. Once something is selected, the **Approve selected (1)** button appears at the top; the number in brackets is the count of selected cards. Press it. ![Approve selected and Select all from this person buttons](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-toplu-en.png)
3. A message tells you how many submissions were approved. Submissions that could not be approved (for example, approved by someone else a moment ago) are not counted. ![](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-onayli-en.png)

## Every field and button on the screen

<table id="bkmrk-field-%2F-buttonwhat-i"><thead><tr><th>Field / button</th><th>What it does</th></tr></thead><tbody><tr><td>**Pending** / **Approved** / **Rejected**</td><td>Tabs that show submissions by status; each has a count badge.</td></tr><tr><td>**Task** box</td><td>Shows only the selected task's submissions. **All tasks** shows everything. The list refreshes as soon as you choose.</td></tr><tr><td>**Participants** box</td><td>Shows only the selected participant's submissions. Only participants with pending submissions are listed, with their pending count in brackets. **All participants** shows everyone.</td></tr><tr><td>**Clear filter**</td><td>Appears when a task or participant is selected; removes the filter.</td></tr><tr><td>Group header</td><td>The participant's **code**, **name** and total points.</td></tr><tr><td>Card</td><td>Proof, task name, the task's points (grey round badge), submission time (day.month time). Pending cards have an orange border.</td></tr><tr><td>Green tick (✓)</td><td>Approves and adds the points. Not shown on the Approved tab.</td></tr><tr><td>Red cross (✗)</td><td>Rejects and asks for a reason. Not shown on the Rejected tab.</td></tr><tr><td>**Back to list**</td><td>Returns to the Treasure Hunt list.</td></tr></tbody></table>

## Approved and Rejected tabs

![Approved tab](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-onayli-en.png)

- A card on the **Approved** tab only has the red cross. If you reject an approved submission, **its points are taken back**. (A reward already won is not taken back, though; the guest may already have received it.)
- On the **Rejected** tab the reason you wrote appears in orange under the card. The green tick there lets you change your mind and approve.

![Rejected tab and rejection reason](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-red-en.png)

### Filter

![Task filter and Clear filter](https://help.useroam.com/uploads/images/gallery/2026-09/oa-pano-filtre-en.png)

## Messages you may see

<table id="bkmrk-messagemeaning-%2F-wha"><thead><tr><th>Message</th><th>Meaning / what to do</th></tr></thead><tbody><tr><td>*Approved, 20 points granted.*</td><td>Points were added. If a point threshold was reached, the reward was granted automatically (visible in the Rewards panel).</td></tr><tr><td>*Rejected.*</td><td>The participant sees the reason.</td></tr><tr><td>*This submission is already approved; points were not added again.*</td><td>Another manager approved it at the same time. Points are never added twice; nothing to do.</td></tr><tr><td>*Could not complete the action.*</td><td>Refresh the page and try again.</td></tr><tr><td>*No submissions in this list.*</td><td>Nothing in this tab or filter. Check another tab or press **Clear filter**.</td></tr></tbody></table>

## Frequently asked questions

**If I approve the same submission twice by mistake, are the points added twice?**  
No. An approval is processed only once.

**I changed a task's points; what happens to earlier approvals?**  
Approved submissions keep the points from the moment of approval. The new value applies to later approvals.

**Can a guest resubmit a rejected task?**  
Yes. A rejected submission can be done again and lands on the board again.

**There are hundreds of submissions; how do I go faster?**  
Pick a person in the **Participants** box, tick them with **Select all from this person** and press **Approve selected**. At most 500 submissions are listed at a time.

## Related pages

- [Treasure Hunt](/books/bumerang-guide/page/treasure-hunt): tasks, participants, rewards and report.
- [Treasure Hunt Studio](/books/bumerang-guide/page/treasure-hunt-studio): guest page design.

# Staff

## What is it for?

The **Business Staff** screen is where you manage your team on the floor (housekeeping, waiters, technical, front desk). You add staff members and choose their department and role; the person then sees requests, tasks and orders in the **Useroam Go** staff app on their phone.

<div class="alert-box" id="bkmrk-this-screen-is-not-f">This screen is not for people who sign in to the **panel**. Panel users are kept on the **Administrators** screen under **Settings**.</div>## When do you use it?

- When a new staff member starts or leaves.
- When a staff member's area changes (for example from cleaning to the front desk).
- During the first setup, to create departments and decide what each department sees in the app.
- When you want the staff app to open only from the venue Wi-Fi.

## Before you start

- The venue must have a **Hotel** or **QR Menu / Restaurant** profile. Otherwise the screen says "This device has no hotel or menu profile. First create a Hotel Portal or a Digital Menu." and the **Add Staff** button stays disabled.
- To make changes you must be the account owner or a venue manager. Otherwise you see "You can view this page, but changes require an account administrator or a venue manager."

## Step by step: add your first staff member

1. In the left menu, under the **BUSINESS** heading, click **Staff**. ![Staff link in the left menu](https://help.useroam.com/uploads/images/gallery/2026-09/pr-menu-en.png)
2. Create your departments in the **Departments** card. To add one at a time, type a name in **Department name** (example: `Bar`) and press **Add**. For a ready list, press **Add restaurant departments** (Cleaning, Technical, Waiter, Kitchen) or **Add hotel departments** (Housekeeping, Technical, Restaurant, Front Desk); existing departments are left untouched. ![Department name box and ready department buttons](https://help.useroam.com/uploads/images/gallery/2026-09/pr-dep-en.png)
3. On each department row, tick what appears in the app: **Requests, spots, tasks**, **Orders, calls, floor**, **Event QR scanning**. The change is saved as soon as you tick a box ("Department app access saved."). Close a department you no longer use with **Deactivate**; bring it back with **Reactivate**. ![Three boxes on a department row and the Deactivate button](https://help.useroam.com/uploads/images/gallery/2026-09/pr-dep-kutu-en.png)
4. Press **Add Staff** at the top right. ![Add Staff button](https://help.useroam.com/uploads/images/gallery/2026-09/pr-yeni-btn-en.png)
5. Fill in the **New Staff Member** window: **Name** (required), **Last Name**, **Mobile phone (login ID)** (example: `5321234567`), **Role** and at least one **Department(s)** box. Under **How should the password be delivered?** keep **Send by SMS (recommended)**. Then press **Add**. ![New Staff Member window](https://help.useroam.com/uploads/images/gallery/2026-09/pr-yeni-en.png)
6. If an SMS will not reach the person (for example a foreign number), choose **Let me set the password** and type a password of at least 6 characters in the box below. No message is sent in this case; you give the password to the person. ![Let me set the password option](https://help.useroam.com/uploads/images/gallery/2026-09/pr-yeni-elle-en.png)
7. (Optional) If the person should also get job notifications by email, type their address in **Email (optional)** (example: *ayse@business.com*). The **Email notifications** switch next to it is on for a new staff member; if you turn it off, the address is saved but no email is sent. Below it: *Manager: job assignment, delay and job done notifications. Staff: only when a job is assigned to them.* Which event sends an email to whom is in the "Email notifications" section below.
    
    ![Email (optional) box and Email notifications switch in the New Staff Member window](https://help.useroam.com/uploads/images/gallery/2026-09/pers-mail-yeni-en.png)
8. The staff member appears in the list. Ask them to install the app: share the **App Store**, **Google Play** or **Download page** links in the **Staff app** card. To open it in a browser, use **Open the app**. ![Staff app card and download links](https://help.useroam.com/uploads/images/gallery/2026-09/pr-app-en.png)

## Step by step: edit or remove a staff member

1. In the staff table, press the pencil icon on the person's row. ![Edit button in the staff table](https://help.useroam.com/uploads/images/gallery/2026-09/pr-tablo-en.png)
2. In the **Edit Staff Member** window, change the phone, **Role**, departments, the **Email (optional)** address or the **Email notifications** switch. If you delete the address, email notifications stop too. To change the password, type it in **New password (blank = unchanged)** (at least 6 characters). To pause the person, untick **Active**; they show as *Inactive* in the list. Press **Save**. ![Edit Staff Member window](https://help.useroam.com/uploads/images/gallery/2026-09/pr-duzenle-en.png)
3. To remove the person completely, press the red **Remove staff member** icon on the row and confirm "Remove this staff member from the venue? Their mobile app access will be revoked." ![Remove staff member button](https://help.useroam.com/uploads/images/gallery/2026-09/pr-cikar-en.png)

## Step by step: app settings

1. In the **Staff-created requests** card, switch on **Staff can open requests from the app** and press **Save**. When on, staff open requests like "fault in room 305" themselves; the request goes to the right department. When off, only managers open requests. ![Staff-created requests switch](https://help.useroam.com/uploads/images/gallery/2026-09/pr-talep-en.png)
2. In the **Staff App Access Security** card, if you switch on **Allow access only from the business network**, staff can only sign in to the app from the venue Wi-Fi. Managers and the account owner can sign in from anywhere. If you also want an office or static IP to work, type the IPs separated by commas in **Extra allowed IPs** (example: `88.99.100.101, 203.0.113.0/24`) and press **Save**. The bottom of the card shows the **Recognized business network IP** and **Your current connection IP**. ![Access security card](https://help.useroam.com/uploads/images/gallery/2026-09/pr-guv-en.png)

## Email notifications

In addition to Useroam Go app notifications, staff with an email address and the **Email notifications** switch on also get job notifications by email. In the list an envelope icon appears next to the phone number: a green envelope with a tick means on, a grey envelope means off. Hovering over the icon shows the address and *email notifications on* or *email notifications off*.

![Green envelope icon next to the phone in the staff list](https://help.useroam.com/uploads/images/gallery/2026-09/pers-mail-liste-en.png)

<table id="bkmrk-eventmanagersstaff-j"><thead><tr><th>Event</th><th>Managers</th><th>Staff</th></tr></thead><tbody><tr><td>Job assigned (automatic assignment, assignment from the panel or the app, assigning a person to a daily task)</td><td>Email: *New job assigned*</td><td>Only if the job was assigned to them: *A new job was assigned to you*</td></tr><tr><td>A request passed its SLA time (Restaurant or Hotel SLA rule)</td><td>Email: *Job is overdue*</td><td>Not sent</td></tr><tr><td>A daily task is late (still not done 30 minutes after its time; once per task time, never for tasks without a time)</td><td>Email: *Job is overdue*, app notification: *Task overdue*</td><td>If the task is assigned to one person, that person also gets it (email and app notification)</td></tr><tr><td>Job completed (closed from the panel or the app, order delivered)</td><td>Email and app notification: *Job completed*</td><td>Not sent</td></tr><tr><td>Daily task done / reading out of range</td><td>Email: *Task completed* / *Task: out-of-range reading*</td><td>Not sent</td></tr><tr><td>Nudge, request message</td><td>No email (app notification only)</td><td>No email</td></tr></tbody></table>

- The person who did the job gets no email about it; one person gets one email per event.
- The email is in the staff member's language (Turkish or English). The subject shows the business name, the event, the job and the location; the email has an **Open the staff app** button.
- If staff reply to the email, the reply goes to your business account's email address.
- Inactive staff and demo accounts get no email.

## Fields and columns on the screen

<table id="bkmrk-field-%2F-columnwhat-i"><thead><tr><th>Field / column</th><th>What it does</th></tr></thead><tbody><tr><td>Subtitle</td><td>Shows the venue name, the active modules (*Hotel*, *Menu/Restaurant*) and "add staff, assign roles, get them into the mobile app (/m/)".</td></tr><tr><td>Demo info strip</td><td>Only on the demo venue: "Try the staff app with the demo account (view only, changes are not saved)." with **Phone** / **Password**.</td></tr><tr><td>**Role**</td><td>**Staff (handles requests/orders)** or **Manager (manages staff + assignments)**. A manager sees every section in the app.</td></tr><tr><td>**Department(s)**</td><td>Staff only see the requests and tasks of the departments you select. With no departments you see "This business has no departments defined yet. Add them in the Departments section above." A staff member with no department only sees Profile in the app.</td></tr><tr><td>Number used at several venues</td><td>"If the number is registered at another venue, no new user is created: the person is linked here too and signs in with their existing password, picking a branch in the app."</td></tr><tr><td>**Name**, **Phone**, **Role**, **Department**</td><td>Table columns. The role badge is *Manager* or *Staff*; departments show as badges.</td></tr><tr><td>**Open Tasks** / **Assigned Rooms**</td><td>Shown when the hotel module is set up: open requests on the person and rooms assigned to them. Use it to balance the workload.</td></tr><tr><td>**Status**</td><td>*Active* or *Inactive*.</td></tr><tr><td>**Email (optional)**</td><td>Address for job notifications, up to 160 characters. The grey example in the box is *name@business.com*. Can be left empty.</td></tr><tr><td>**Email notifications**</td><td>When on and an address is filled in, notifications also go by email. On for a new staff member.</td></tr><tr><td>Envelope next to the phone</td><td>Only shown for staff with an address. Green with a tick: *email notifications on*; grey: *email notifications off*.</td></tr><tr><td>Below the table</td><td>A summary of the modules staff see and the tabs by department. In the hotel, task assignment is done from **Request Management**.</td></tr><tr><td>"No staff yet. Add one from the top right."</td><td>Shown when the list is empty.</td></tr><tr><td>"No departments defined yet."</td><td>Shown when the Departments card is empty; add a department first.</td></tr><tr><td>Hints under the boxes</td><td>Under **Mobile phone**: "Staff sign in to the app with this number". Under the password choice: "The password is generated automatically and sent to the staff member (SMS when the panel is in Turkish, WhatsApp when in English)." The full name of the box in the edit window is "Active (if turned off, shown as inactive in the list)".</td></tr><tr><td>**Extra allowed IPs (comma-separated; CIDR supported, office/static IP)**</td><td>Type a single IP or a range; the grey example in the box is "e.g. 88.99.100.101, 203.0.113.0/24".</td></tr><tr><td>Card descriptions</td><td>Staff app card: "Staff can see requests, daily tasks and board status from their phone." Departments card: "Tick what each department sees in the app. Staff only see the sections ticked for their own departments. Managers see everything." Next to the ready buttons: "Creates … departments at once; existing ones are left untouched."</td></tr></tbody></table>

## Messages you may see

<table id="bkmrk-messagewhat-to-do-%22s"><thead><tr><th>Message</th><th>What to do</th></tr></thead><tbody><tr><td>"Staff member added" + "Password sent via WhatsApp." (when the panel is in Turkish: "Password sent via SMS.")</td><td>Nothing; the person signs in with the password they received.</td></tr><tr><td>"Password set manually, no message sent. Password: …"</td><td>Give the password to the person yourself.</td></tr><tr><td>"Password COULD NOT BE SENT. Temporary password: … (hand it over manually)."</td><td>The message did not go out; give the temporary password on screen to the person.</td></tr><tr><td>"Existing staff member also added to this venue (password unchanged)" / "This number is already registered as staff; the password was not changed and no message was sent. They sign in with their existing password."</td><td>The person also works at another of your venues; they use their old password.</td></tr><tr><td>"Enter a valid mobile number: 10 digits, e.g. 5321234567"</td><td>Type the number as 10 digits (example: `5321234567`).</td></tr><tr><td>"This number is already a staff member of this venue." / "This mobile number is already registered, please use another"</td><td>Look for that number in the list, or use another number.</td></tr><tr><td>"New password must be at least 6 characters."</td><td>Type a password of at least 6 characters.</td></tr><tr><td>"Invalid email address."</td><td>Write the address as *name@domain.com* or leave the box empty. Nothing was saved.</td></tr><tr><td>"Staff member updated." / "Staff member not found."</td><td>Saved / the person was removed in the meantime; refresh the page.</td></tr><tr><td>"You cannot remove yourself from the staff list."</td><td>Another manager can remove your own account.</td></tr><tr><td>"Staff member removed and the user account was deleted." / "Staff member removed from the venue and access revoked. The user account was kept so their name still shows on past records." / "Staff member removed from this venue. The user account and their access at the other venue were kept."</td><td>Removal is done. Which one you see depends on whether the person has past records or another venue.</td></tr><tr><td>"Department added." / "… departments added." / "Department name cannot be empty and must be 60 characters or less."</td><td>Result of a department action.</td></tr><tr><td>"Department status updated." / "Department app access saved."</td><td>Deactivation or a box change was saved.</td></tr><tr><td>"Request setting saved." / "PWA access security updated."</td><td>An app setting was saved.</td></tr><tr><td>"Staff management is only for business managers and the account owner."</td><td>You do not have permission; ask the account owner.</td></tr></tbody></table>

## Frequently asked questions

**My staff member did not get the SMS.**  
If the screen said "Password COULD NOT BE SENT", give the temporary password yourself. To change it later, edit the staff member and use **New password**. The staff member can also get a new password with "Forgot password" in the app.

**The staff member sees no tabs in the app.**  
The person needs at least one department, and at least one box must be ticked on that department's row.

**The staff member cannot sign in from home.**  
**Allow access only from the business network** is on. This is intended; if they must sign in from home, switch it off or add their IP to **Extra allowed IPs**.

**The same person works at two of my venues.**  
Add them at the second venue with the same number; no new account is created and the person picks a branch in the app.

**A manager gets no email.**  
Their row must show the green envelope: an address filled in and **Email notifications** on; the person must be *Active* and have the **Manager** role at this venue. If they did the job themselves, they get no email about it. If it is not in the inbox, check the spam folder.

**Does a nudge send an email?**  
No. Nudges and request messages are sent only as app notifications.

**A staff member wants to stop the emails.**  
Edit the staff member and turn off **Email notifications**, or delete the address. The footer of the email says the same.

## Related pages

- [Useroam Go: Staff accounts and departments](/books/useroam-go-staff-app/page/staff-accounts-and-departments)
- [Useroam Go: App screens by department](/books/useroam-go-staff-app/page/app-screens-by-department)
- [Hotel: Request Management](/books/hotel-solution/page/request-management)
- [Operations](/books/restaurant-solution/page/operations)

# Summary

## What is it for?

The **Summary** screen (titled **Marketing Command Center**) is Bumerang's one-page summary: how many guests came, how many campaign messages went out, how many were clicked, how many guests came back and what that is roughly worth. It is the screen to open in the weekly meeting. Each box opens the related detailed report.

## When do you use it?

- When you want a quick look at how marketing is going overall.
- When you want to see which campaign works best and which product draws most interest.
- When you want to quickly read what guests wrote in surveys.

## Step by step

1. In the left menu, under the **ANALYTICS** heading, click **Summary**. Under the title you see the selected period ("Last 30 days") and a green *live* mark. ![Summary link in the left menu](https://help.useroam.com/uploads/images/gallery/2026-09/oz-menu-en.png)
2. Use the **7g** or **30g** button at the top right to choose the last 7 or 30 days (the buttons keep the Turkish "g" for day). ![7g and 30g period buttons](https://help.useroam.com/uploads/images/gallery/2026-09/oz-donem-en.png)
3. Read the **Guest Journey** strip from left to right: **guests arrived**, **campaigns sent**, **clicked**, **viewed menu**, **returned**, **est. earnings**. Click a step (**Open report**) to open the related report. The six cards below it (**Unique guests**, **Campaigns sent**, **Returns**, **Est. earnings**, **Menu views**, **Survey responses**) are clickable too; the percentage next to them is the **conversion %**. ![Guest Journey strip](https://help.useroam.com/uploads/images/gallery/2026-09/oz-dongu-en.png)
4. The **Menu View Trend** chart shows daily menu opens. Below are the **SOURCE BREAKDOWN** (Direct, QR, Wi-Fi, Campaign) and **CHANNEL (CAMPAIGN)** (WhatsApp, SMS) charts. Press **Detailed report** for more. ![Menu View Trend and breakdown charts](https://help.useroam.com/uploads/images/gallery/2026-09/oz-trend-en.png)
5. The **Most Popular Items** list on the right shows the most opened menu items; under it you see how many were never opened ("… items never viewed"). The **Report** button opens the Product Performance report. The **Campaigns** list shows each campaign's sends (*sent*), *returns* and earnings; the best campaign has a *BEST* badge. ![Most Popular Items and Campaigns](https://help.useroam.com/uploads/images/gallery/2026-09/oz-kampanya-en.png)
6. The **Guest Voice** section at the bottom shows the *avg. score*, the number of *responses* and the latest written comments from surveys. ![Guest Voice section](https://help.useroam.com/uploads/images/gallery/2026-09/oz-ses-en.png)

## Empty states and hints

<table id="bkmrk-textwhat-to-do-%22no-c"><thead><tr><th>Text</th><th>What to do</th></tr></thead><tbody><tr><td>"No campaigns yet" with a **create your first** link</td><td>Press the link to set up your first campaign (see [Creating your first campaign](/books/bumerang-guide/page/creating-your-first-campaign)).</td></tr><tr><td>In Guest Voice: "No text comments yet" and "add an open-ended question to your rating survey"</td><td>Add an **Open Text** question to your survey.</td></tr><tr><td>Page tour</td><td>**Guest Journey** ("Arriving guests, sent campaigns, clicks and returns in one strip. Click a step to open the related report."), **Period summary** ("Six core metrics. Each card is clickable; the related report opens pre-filtered."), **Period selection** ("Switch between the 7- and 30-day view."), **Your campaigns** ("Your active campaigns' performance is here. Use the Report button for details."), **Guest Voice** ("Survey scores and recent comments are collected here.").</td></tr></tbody></table>

## Frequently asked questions

**Everything shows 0.**  
There was no activity in the selected period (7 or 30 days). For a longer period, widen the date range in [Bumerang Reports](/books/bumerang-guide/page/bumerang-reports).

**Guest Voice shows short comments like "Evet" (Yes).**  
The section shows the text answers from surveys; short answers are listed too.

**How is the estimated earnings figure calculated?**  
Returning guests times the average check you entered in the campaign, minus the coupon cost.

## Related pages

- [Bumerang Reports](/books/bumerang-guide/page/bumerang-reports)
- [Campaigns](/books/bumerang-guide/page/campaigns)
- [Guest 360°](/books/bumerang-guide/page/guest-360)

# Guest 360°

## What is it for?

**Guest 360°** combines each guest's Wi-Fi visits, survey score and behaviour group (segment) into one profile: "Wi-Fi visits + surveys + RFM segments merged into one profile". You see who is loyal and who is drifting away, and set up the right campaign for that group. Segments are calculated automatically from how often and how recently the guest came.

## When do you use it?

- When you want to find guests who are drifting away (at risk) or have not come for a long time.
- When you are thinking of a thank-you campaign for your most valuable guests (champions).
- When you want to see how many times a guest came and their survey score.

## Step by step

1. In the left menu, under the **ANALYTICS** heading, click **Guest 360°**. Under the title you see the total number of guests and the number that are "marketing-opted-in". The **Bumerang** button at the top right goes back to the Campaigns screen. ![Guest 360 screen](https://help.useroam.com/uploads/images/gallery/2026-09/m3-menu-en.png)
2. Read the six segment cards at the top; each shows the number of guests, a short description and a suggested campaign. To set up a campaign for a group, press the card's **Create campaign** button (the number in brackets is the consented guests in that group; with none, the button is disabled). The button opens the **New Campaign** screen, where you set up the campaign. ![Segment cards and Create campaign buttons](https://help.useroam.com/uploads/images/gallery/2026-09/m3-segment-en.png)
3. If you do not know which group to reach first, press **Get AI suggestion** in the **Useroam AI · Loyalty Advisor** card. The AI prioritises "which segment to reach first and with which campaign" (while working it shows "Useroam AI is analyzing your guests…"). ![Loyalty Advisor card and Get AI suggestion button](https://help.useroam.com/uploads/images/gallery/2026-09/m3-ai-en.png)
4. To find a guest in the **Guest Profiles** list, type in **Search name or phone**, choose **All** or a segment in the segment box and press the search button. **Clear** resets the search. The list shows 50 guests per page. ![Guest Profiles list, search and segment filter](https://help.useroam.com/uploads/images/gallery/2026-09/m3-liste-en.png)

## Segments

<table id="bkmrk-segmentwho%3Fsuggested"><thead><tr><th>Segment</th><th>Who?</th><th>Suggested</th></tr></thead><tbody><tr><td>**Champions**</td><td>Frequent + recent visits. Your most valuable guests.</td><td>VIP thanks / special reward</td></tr><tr><td>**Loyal**</td><td>Regular visitors.</td><td>Strengthen the bond with a surprise discount</td></tr><tr><td>**New**</td><td>Newly met guests.</td><td>Welcome + 2nd-visit coupon</td></tr><tr><td>**At Risk**</td><td>Used to visit often, now drifting away.</td><td>Win them back now with a tempting offer</td></tr><tr><td>**Dormant**</td><td>Hasn't visited in a while.</td><td>Reminder + discount</td></tr><tr><td>**Lost**</td><td>Gone for a long time.</td><td>Strong win-back campaign</td></tr></tbody></table>

## List columns and messages

<table id="bkmrk-itemmeaning-guest-%2F-"><thead><tr><th>Item</th><th>Meaning</th></tr></thead><tbody><tr><td>**Guest** / **Phone**</td><td>Name and phone (masked under KVKK). The eye icon shows the full value if you have permission.</td></tr><tr><td>**Visits**</td><td>Number of distinct days connected to Wi-Fi.</td></tr><tr><td>**Last**</td><td>Days since the last connection ("… days").</td></tr><tr><td>**Survey**</td><td>Average satisfaction score (star badge). Empty (a dash) with no survey.</td></tr><tr><td>**Lang** / **Segment** / **Consent**</td><td>The guest's language, segment badge and marketing consent (green tick: consented).</td></tr><tr><td>Bottom note</td><td>"Visits = number of distinct days connected to Wi-Fi · Last = most recent connection · Survey = average satisfaction score · Segment is automatic based on RFM."</td></tr><tr><td>"No guest matches this filter."</td><td>Reset the search with **Clear**.</td></tr><tr><td>"No registered guests yet. Profiles build automatically as guests connect to the Wi-Fi and register."</td><td>Just wait.</td></tr><tr><td>AI messages</td><td>"No guest data yet. Suggestions will appear as guests connect to the Wi-Fi.", "Useroam AI is currently unavailable, please try again shortly.", "Currently unavailable.", "Connection issue, please try again.": try again in a few minutes.</td></tr></tbody></table>

## Frequently asked questions

**Does Create campaign send to that segment?**  
No. The button opens the New Campaign screen. Pick the recipe that fits the segment's suggestion (for example We Missed You for Dormant) and set up the campaign.

**Are my own staff in the list?**  
Phone numbers on the **Excluded Users** list are not included.

## Related pages

- [Creating your first campaign](/books/bumerang-guide/page/creating-your-first-campaign)
- [Live Radar](/books/bumerang-guide/page/live-radar)
- [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests)

# Live Radar

## What is it for?

**Live Radar** (Useroam Radar, "Live Floor Monitoring") is a full-screen board that shows, live, the recognised guests who are in your venue right now and have been before. When a known guest connects to Wi-Fi they appear on screen, so staff see at once that a VIP or a long-absent guest has arrived.

## When do you use it?

- To keep open on a screen at the front desk or till.
- When you want to give special attention to a loyal or drifting guest when they arrive.
- When you want to see how busy the floor is and how much the menu is being viewed.

## Step by step

1. In the left menu, under the **ANALYTICS** heading, click **Live Radar** (with the *LIVE* badge). ![Live Radar link in the left menu](https://help.useroam.com/uploads/images/gallery/2026-09/rd-menu-en.png)
2. The radar opens full screen. Recognised guests inside appear as dots on the radar in the middle; on the right are three numbers: **Recognized Inside**, **VIP / Champion** and **Menu Pulse 15min** (menu opens in the last 15 minutes). The strip below shows "… devices online" and the floor status ("floor is quiet" when nothing is happening, otherwise "… menu views (15min)"). The **Guests Inside** list shows each guest's name, segment, visit number, last visit and minutes inside. The clock is at the top; the **Close** (cross) button at the top right closes the screen. ![Live Radar full screen view](https://help.useroam.com/uploads/images/gallery/2026-09/rd-ekran-en.png)

## Information on the screen

<table id="bkmrk-itemmeaning-segment-"><thead><tr><th>Item</th><th>Meaning</th></tr></thead><tbody><tr><td>Segment badges</td><td>*Champion*, *Loyal*, *New*, *At Risk*, *Dormant*, *Lost* (see [Guest 360°](/books/bumerang-guide/page/guest-360)).</td></tr><tr><td>Visit information</td><td>"… . visit", **Last visit:** "today" or "… days ago"; for a first-time guest "First visit". "… min inside" shows how long the guest has been connected.</td></tr><tr><td>Consent</td><td>"📣 marketing opt-in" or "no consent": whether campaigns can be sent to the guest.</td></tr><tr><td>Guest without a name</td><td>Shown as "Guest"; phone numbers are masked.</td></tr><tr><td>Empty screen</td><td>"No recognized guests inside right now." and "When a known guest connects to the Wi-Fi, they will appear here."</td></tr></tbody></table>

## Frequently asked questions

**The screen is always empty.**  
Radar only shows guests who registered before (recognised). A first-time guest joins the list once registration is complete. If no recognised guest is inside, the screen stays empty.

**Do my staff appear on the radar?**  
Phone numbers on the **Excluded Users** list are not shown.

**How do I close the screen?**  
Press the cross (**Close**) at the top right.

## Related pages

- [Guest 360°](/books/bumerang-guide/page/guest-360)
- [Summary](/books/bumerang-guide/page/summary)

# Bumerang Reports

## What is it for?

The **Reports** screen brings all of your venue's marketing data together in one place: campaigns, returning guests, menu, surveys, table calls, hotel requests and the consented guest pool. You pick a date range, see the table on screen and download it as **XLSX**, **PDF** or **CSV**.

## When do you use it?

- At the end of the month, when your boss or partner asks "what did Bumerang bring in this month?" (**Executive Summary**).
- When you want to see which campaign actually brought guests back (**Campaign Performance**, **Return Report**).
- When you want to know which menu item is never opened, or which table calls the waiter most.
- When you want to check whether the same hotel room keeps having faults (**Fault Analysis**).

## Before you start

- The screen shows the data of the device (venue) selected in the panel. If you have several venues, select the right device first.
- Campaign reports only fill up after at least one campaign has run. The menu, table and hotel tabs fill up when those modules are set up.

## Step by step: open and download a report

1. In the left menu, under **Bumerang**, open the **ANALYTICS** heading and click **Reports**. The screen first opens on the **Executive Summary** tab with the last 30 days. ![Reports link in the left menu](https://help.useroam.com/uploads/images/gallery/2026-09/rp-menu-en.png)
2. Choose the report you want from the tabs at the top. The selected tab turns blue. ![Report tabs](https://help.useroam.com/uploads/images/gallery/2026-09/rp-sekmeler-en.png)
3. Set the date range: type dates into **Start** and **End**, or press one of the quick buttons **7g**, **30g**, **90g** (last 7, 30 or 90 days; the buttons keep the Turkish "g" for "gün", day, in the English interface). Quick buttons count back from today and refresh the report at once. ![Date boxes and the 7g 30g 90g buttons](https://help.useroam.com/uploads/images/gallery/2026-09/rp-tarih-en.png)
4. If the report has its own filters (for example **Campaign**, **Channel**, **Opened coupon menu**), choose them and press **Apply**. Press **Clear** to reset the filters. ![Report filters and the Apply button](https://help.useroam.com/uploads/images/gallery/2026-09/rp-filtre-en.png)
5. Review the table. To get it as a file, press **XLSX** (Excel), **PDF** or **CSV** at the top right. The file uses the same filters as the screen. ![Report table and the XLSX PDF CSV buttons](https://help.useroam.com/uploads/images/gallery/2026-09/rp-tablo-en.png)
6. Guest lists (**Guests Who Clicked**, **Return Report**, **Guest Lifetime Value**, **Consented Guests**) can be clicked row by row. Click a row. ![Clickable guest row](https://help.useroam.com/uploads/images/gallery/2026-09/rp-tiklayan-en.png)
7. A **Guest Journey** card opens above the table: every event from the guest's Wi-Fi registration to the campaign and the return visit, in date order. Press **Close** to close it. ![Guest Journey card](https://help.useroam.com/uploads/images/gallery/2026-09/rp-yolculuk-en.png)

## Report tabs

There are 12 tabs. Under each tab title there is a short description and the selected date range.

<table id="bkmrk-tabwhat-it-showscolu"><thead><tr><th>Tab</th><th>What it shows</th><th>Columns</th><th>Extra filters</th></tr></thead><tbody><tr><td>**Campaign Performance**</td><td>Delivery, receipt, click, return and estimated gain summary for each campaign.</td><td>Campaign, Status, Sent, WhatsApp, SMS, Clicks, Returns, Return %, Estimated Gain ₺</td><td>Campaign, Channel</td></tr><tr><td>**Guests Who Clicked**</td><td>Guests who clicked the button in a campaign message. This is your own consented guest data.</td><td>Phone, Campaign, Channel, Registration Type, Sent, Clicks</td><td>Campaign, Channel, Registration type</td></tr><tr><td>**Return Report**</td><td>Guests who came back after a campaign (14 day window) and how long it took.</td><td>Phone, Campaign, Channel, Message Date, Return Date, Elapsed (hours), With Coupon</td><td>Campaign, Channel, Opened coupon menu, Registration type</td></tr><tr><td>**Guest Lifetime Value**</td><td>The big picture per guest: how often they came, how they reacted to campaigns, their estimated total spend.</td><td>Phone, Registered, Total Visits, Last Visit, Campaigns Received, Clicked, Returned, Estimated Total Spend ₺</td><td>Received a campaign</td></tr><tr><td>**Menu Views**</td><td>How many times your digital menu was opened, day by day.</td><td>Date, Views, QR, Wi-Fi, Campaign, Direct, Unique</td><td>Source (QR, Wi-Fi, Campaign, Direct), Language, Table</td></tr><tr><td>**Product Performance**</td><td>How often each product's detail was opened, and guest ratings. Review the ones at zero.</td><td>Product, Category, Detail Opens, Rating ★, Responses</td><td>Category</td></tr><tr><td>**Survey Results Summary**</td><td>Impressions and completions per survey. For question level detail use the report and export on the **Surveys** screen.</td><td>Survey, Impressions, Completed, Completion %</td><td>None</td></tr><tr><td>**Table Calls**</td><td>Waiter call and bill request records.</td><td>Date, Table, Type (*Called a waiter* / *Requested the bill*), Status (*Answered* / *Pending*)</td><td>Table</td></tr><tr><td>**Hotel Requests**</td><td>Housekeeping and extra requests from the guest portal.</td><td>Date, Room, Type, Detail, Preferred Time, Status, Amount ₺, Note</td><td>None</td></tr><tr><td>**Consented Guests**</td><td>The pool of guests who gave marketing consent. Details: [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests).</td><td>Phone, Registration Type, Full Name, Registration Date, Last Login, Login Count, Overseas Consent</td><td>Channel</td></tr><tr><td>**Fault Analysis**</td><td>Fault history per room, recurring issues and an AI summary.</td><td>Room, Total Faults, Open, Last Fault, Avg. Resolution (min), Assessment</td><td>None</td></tr><tr><td>**Executive Summary**</td><td>A one page summary of the whole marketing cycle, compared with the previous period.</td><td>Metric, This Period, Previous Period, Change</td><td>None</td></tr></tbody></table>

In **Hotel Requests**, the **Type** column can be *Housekeeping*, *Extra*, *Late Checkout*, *Early Check-in*, *Fault* or *Room Service*. **Status** can be *Pending*, *In progress*, *Completed* or *Cancelled*. The **Registration Type** column shows where the guest came from: *Wi-Fi (SMS)* or *Hotel (PMS)*. **With Coupon** shows *Yes* or *No*. Products without a category name show "Category #" and a number.

## Executive Summary

A green **gain card** appears at the top of this tab: "Bumerang earned you an estimated ₺…", how many guests came back after a campaign in the period, and the change **versus the previous period**. The middle box shows the **Proven campaign impact**: the **return with campaign** rate, the **organic return** rate, and how many times **more frequent returns** guests with a campaign make.

![Executive Summary tab and gain card](https://help.useroam.com/uploads/images/gallery/2026-09/rp-ozet-en.png)

The table metrics are: **Unique guests (Wi-Fi)**, **Campaign deliveries**, **Campaign clicks**, **Returning guests**, **Return rate**, **Menu views**, **Coupon menu opens**, **Survey responses**, **Estimated gain (net)**. With enough data, three more rows are added: **Return rate of guests with campaigns**, **Organic return rate (no campaign)** and **Campaign impact multiplier** ("x more frequent returns"). The **Change** column shows increases in green and decreases in red; if the previous period is zero it shows **NEW**.

<div class="alert-box" id="bkmrk-if-you-see-%22not-enou">If you see **"Not enough data yet to compare campaign and organic returns (at least 30 organic + 10 campaign guests are needed)"**, this is not an error. The comparison appears by itself as data builds up. In the meantime, widening the date range (for example **90g**) is often enough.</div>**How is it calculated?** It is also written on the right of the card: a *return* is a guest who received a campaign message reconnecting to Wi-Fi within 14 days. *Gain* is the number of returns times the average bill you entered in the campaign; for coupon returns the discount cost is deducted (net). The *organic comparison* is the rate at which guests registered before the period, who received no campaign, came back on their own in the same period.

## Fault Analysis

If the hotel module is set up, this tab lists rooms by number of faults. The **Assessment** column has three values: *One off*, *Recurring* and *CHRONIC (permanent maintenance advised)*. The **AI Fault Analysis** card above the table summarises the common pattern of recurring faults ("Summary generated with Groq; verify technical decisions with your own observation."). If no two rooms have more than one fault, the card says "No recurring fault pattern was found, or the analysis could not be generated right now."

![Fault Analysis tab and AI card](https://help.useroam.com/uploads/images/gallery/2026-09/rp-ariza-en.png)

## Guest Journey card

It opens when you click a guest row. At the top: the phone number (masked), **Registered:**, **Total visits:** and **Last visit:**. Below: the events in date order (up to 60). The events you can see:

<table id="bkmrk-eventmeaning-wi-fi-r"><thead><tr><th>Event</th><th>Meaning</th></tr></thead><tbody><tr><td>**Wi-Fi registration created** / **Joined your guest pool**</td><td>The guest registered on Wi-Fi for the first time.</td></tr><tr><td>**Visited the venue (Wi-Fi)**, "stayed connected … min"</td><td>A visit and how long the guest stayed on Wi-Fi.</td></tr><tr><td>**Campaign "…" was sent**, Coupon: …</td><td>A campaign message went to the guest; the coupon code is shown if there was one.</td></tr><tr><td>**Clicked the campaign button**</td><td>The guest pressed the button in the message.</td></tr><tr><td>**CAME BACK to the venue**, after campaign "…"</td><td>The guest came back within 14 days of the campaign.</td></tr><tr><td>**Opened the coupon menu**</td><td>The guest opened the menu link from the campaign.</td></tr><tr><td>**Completed the survey**</td><td>The guest answered a survey to the end.</td></tr></tbody></table>

If the guest has no Wi-Fi record (for example only a campaign record), the card says "No guest record found for this phone number." If there are no events it says "No events recorded yet."

## Other items on the screen

<table id="bkmrk-itemwhat-it-does-sta"><thead><tr><th>Item</th><th>What it does</th></tr></thead><tbody><tr><td>**Start** / **End**</td><td>Free date range. You cannot pick a date after today; the range is at most 365 days. If Start is after End, the two are swapped.</td></tr><tr><td>**7g** / **30g** / **90g**</td><td>Selects the last 7, 30 or 90 days. The active one is darker.</td></tr><tr><td>Filter boxes</td><td>Each tab shows only the filters that fit that report. When a filter is set to **All**, nothing is filtered by that field. In **Table** you type a table number (example: `12`).</td></tr><tr><td>**Apply** / **Clear**</td><td>Runs the filters / goes back to the tab's default.</td></tr><tr><td>**XLSX** / **PDF** / **CSV**</td><td>Downloads the report as Excel, PDF or CSV. The file contains all rows (up to 2000).</td></tr><tr><td>Yellow KVKK strip</td><td>"This report may contain personal data; process and store it under KVKK/GDPR." It appears on guest reports.</td></tr><tr><td>Masked phone and eye icon</td><td>Phone numbers are masked on screen and in the file, like `5590****17`. If you have the **View guest data (unmask)** permission (Module Permissions), an eye icon appears next to the number; pressing it shows the full number.</td></tr><tr><td>"Showing the first 200 rows; the full set is in the download files."</td><td>The screen draws at most 200 rows; download the file for the rest.</td></tr><tr><td>"No data for this period and these filters."</td><td>There are no records in the selected range. Widen the date range or reset the filters with **Clear**.</td></tr><tr><td>Page tour</td><td>The first time you open the screen a short tour appears (**Report types**, **Proof of gain**, **Filters**, **Download**, **Data table**). You can close it; the question mark at the bottom right opens it again.</td></tr></tbody></table>

## Frequently asked questions

**The report looks empty, but my campaign is running.**  
The default range is the last 30 days. If the campaign was sent earlier, press **90g** or move **Start** back.

**Why is the estimated gain zero?**  
Gain is calculated with the average bill you entered in the campaign. If the campaign has no average bill, the gain shows zero. Edit the campaign and enter the average bill.

**Why are phone numbers starred in my download?**  
Under KVKK the numbers are masked in the file too. If you need the full number, ask your administrator for the unmask permission and use the eye icon on screen.

**The tour says "nine ready reports", but I see 12 tabs.**  
The tour text is outdated; the screen has 12 tabs and all of them are described on this page.

**Do my own staff appear in the reports?**  
Phone numbers on the **Excluded Users** list are removed from **Guest Lifetime Value**, **Consented Guests** and the unique guest count in the **Executive Summary**.

## Related pages

- [Opted-in Guests](/books/bumerang-guide/page/opted-in-guests)
- [Campaigns](/books/bumerang-guide/page/campaigns)
- [Summary](/books/bumerang-guide/page/summary)
- [Guest 360°](/books/bumerang-guide/page/guest-360)