Broadcasts

Broadcasts allow you to push messages to all guests at once — great for announcements, promotions, or recurring reminders. Unlike individual conversation messages, broadcasts are one-to-many and can be scheduled for a future time or set to repeat automatically.

Broadcast Fields

Field	Required	Description
Title	✅	Internal label for identifying the broadcast
Content	✅	The message text guests will receive
Language	✅	Target language for the message (default: English)
Status	✅	draft — not yet sent; active — ready to send
Publish At	❌	Scheduled send time (leave blank for immediate)
Recurring	❌	Toggle to enable repeat sending

Status Lifecycle

draft → active → sent

• Draft broadcasts are saved but not sent.
• Active broadcasts will be sent at the scheduled publishAt time (or immediately via “Send Now”).
• Once sent, the broadcast record is updated with the sent timestamp.

Scheduling a Broadcast

1. Click Create Broadcast.
2. Fill in Title and Content.
3. Select the target Language.
4. Set Status to active.
5. Choose a Publish At date and time using the date-time picker.
6. Click Save.

The system will send the broadcast at the scheduled time.

Tip

Leave Publish At blank and click Send Now from the list view to send immediately.

Recurring Broadcasts

Toggle Recurring to enable scheduled repetition. Two frequency options:

Daily

Sends every day at a specific time.

Setting	Description
Frequency	daily
Time	The time of day to send (e.g., 09:00)
Ends At	Optional expiry date — stop repeating after this date

Weekly

Sends on selected days of the week.

Setting	Description
Frequency	weekly
Time	The time of day to send
Days	Toggle buttons for S, M, T, W, T, F, S (Sunday = 0)
Ends At	Optional expiry date

Example: A “Good Morning” message every Monday and Friday at 08:00 until Dec 31.

Actions on Existing Broadcasts

Action	Description
Edit	Modify the broadcast (only for draft or future-scheduled ones)
Send Now	Immediately trigger the broadcast, bypassing the schedule
Delete	Permanently remove the broadcast record

Language Targeting

The Language field determines which guests receive the broadcast. Broadcasts are matched to conversations/guests based on their detected primaryLanguage. If set to English (en), only guests whose conversations are flagged as English will receive it.

Available languages are loaded from Settings → Language configuration.

---

Welcome Messages

Welcome Messages are automatic messages sent to guests the moment they scan a QR code and open a new conversation. Unlike scheduled broadcasts (which push to all active conversations at a set time), welcome messages trigger only for brand-new conversations — ensuring every first-time visitor receives a greeting without any manual effort.

Welcome Messages are managed from the same Broadcasts page, in a dedicated panel above the broadcast list.

How It Works

Guest scans QR → New conversation created → All active Welcome Messages inserted → Guest sees them instantly

1. An admin creates one or more welcome messages in Broadcasts → Welcome Messages.
2. When a guest scans a QR code, the system initializes a new conversation.
3. All Active welcome messages are automatically inserted as system messages at the very start of that conversation.
4. The guest sees the message(s) immediately upon opening the chat window.

Note

Welcome messages are sent only when a new conversation is created (first QR scan per session). Returning guests who already have an active open conversation will not receive them again.

Welcome Message Fields

Field	Required	Description
Internal Title	✅	Admin-only label — not visible to guests
Message Content	✅	The text the guest will see on first scan
Language	❌	All Languages sends to everyone; a specific code (e.g. vi) reserves future targeting
Status	✅	Active — delivered automatically; Inactive — paused

Creating a Welcome Message

1. In the Broadcasts page, click Create Welcome Message.
2. Enter an Internal Title (e.g. “General Greeting EN”).
3. Write the Message Content guests will read.
4. Set Language — choose All Languages to reach every guest.
5. Set Status to Active.
6. Click Save.

The message will be sent to all new conversations from that point forward.

Managing Existing Welcome Messages

The Welcome Messages panel displays all messages with their current status. Available actions:

Action	Icon	Description
Toggle Status	👁 / 👁‍🗨	Switch between Active and Inactive without deleting
Edit	✏️	Modify title, content, language, or status
Delete	🗑	Permanently remove the welcome message

Multiple Welcome Messages

The system supports multiple active welcome messages simultaneously. All active messages are delivered in ascending Sort Order, then by creation date. This enables you to:

• Send a greeting in multiple languages at once.
• Combine a “welcome” message with a separate “menu/shop available” announcement.
• Pause or re-activate messages seasonally without deleting them.

Example: Two active messages — one greeting in English, one reminder about the shop:

Order	Title	Content	Status
0	General Welcome	”Welcome! How can we help you today?”	Active
1	Shop Reminder	”Our menu is available — tap the cart icon to browse.”	Active

Both messages appear back-to-back in the guest’s chat, in order.

Language Field Behaviour

Language Setting	Behaviour
All Languages	Sent to every new guest regardless of detected language
en, vi, ko, etc.	Currently stored for reference; all active messages are sent to all guests

Tip

Use All Languages to ensure every guest receives the welcome message regardless of their browser or conversation language.

---

Role Requirements

Creating and managing broadcasts and welcome messages requires at minimum the Manager role (level 50).