Pop-Up Marketing Offers

Set up pop-up notifications for users. These notifications can include an image, a button with a link, and a description. They can be sent to all chats available in the service, selected chats, or customised for individual users manually or via API.

Pop-ups are clickable and displayed on top of the chat; the user can close the notification by clicking the close button.

To set up manual sending, open the Widgets > Marketing Offer (pop-ups) section, then click the Create button.

Then, you need to configure the offer itself, including its appearance, display, and sending timing/frequency.

First, choose a template: it can contain an image (in three different placements) and text or only an image (suitable for sending ready-made banners) or only text. While configuring the offer, you can preview how it looks after adding text and images, and if necessary, use a different template.

After selecting the template, add all the necessary elements.

If everything is filled out correctly, the fields will be highlighted in green. If there are critical errors (e.g., a required field is missing), the section that needs correction will be highlighted in red.

Tech requirements

Title—no more than 23 characters

Text—no more than 180 characters

Button text—no more than 80 characters

The image should not be more than 10 MB.

For a picture template, please use an image with 600×240 proportions.

For a “text + pic” template, use an image 600×400 proportion.

After filling in all the fields, click "Next Step."

Next, choose the period during which the notification will be shown to users and how many times it should be displayed—once upon entering the chat or multiple times, either immediately or with a delay of a few seconds.

In the next step, you need to select the audience for the notification.

You can send it to all rooms (this means that all users who enter any available chat on the platform will see the notification), to selected rooms, or customize a specific list of users.

For personal offers, there are two configuration options:

• Manually (you upload a list of users, either by entering them comma-separated in a special field or by uploading a CSV file with a list of UserIDs)
• Via API.

Keep in mind that you can configure either sending by rooms or by users in the following hierarchy:

1. Personal offer by userId: Specifies target users for the offer. If they are specified, the offer will be shown only to these users when they enter the chat.
2. Public offer by roomId: If user IDs are not specified, the pop-up can be displayed in specific rooms. If room IDs are not specified, the pop-up will be sent to all available chats.

This approach works for both manual configuration through the admin panel and sending via API.

After specifying to whom and where to show the notification, click "Send."

Your pop-up is ready, received by the user, and clickable:

Multilingual Support

Pop-up marketing offers now support localization into all interface languages available in your service. This ensures users receive offers in their preferred language, increasing clarity and conversion.

Language Tabs
Admins can switch between tabs for each supported language and fill in:

• Title
• Description text
• Button text
• Button link
• Image
• External link (if applicable)

⚠️

Behavior and Visual Settings

Behavior settings — such as when and how the pop-up appears (timing, frequency, delay) — as well as visual configuration (template type, image placement, layout) are shared across all language versions. This means that the offer’s structure and style remain consistent, while the textual content and image can vary per language.

Fallback Behavior
If the content for a certain language is missing, the system will automatically show the pop-up using the default service language. If a tab is partially filled, for example missing the button text or link, the missing fields will also fall back to values from the default language.

Preview Switching
Switching between language tabs updates the visual preview accordingly, helping admins double-check how each localized version will appear to users.

Data about published pop-ups

All published pop-ups are gathered in the same section. You can find the buttons to manage them: edit or delete, and all the main info about the pop-ups. You cane dit them even after they are published.

If you start to create a pop-up, you can save it as a draft. However, you can save only one draft at a time.