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 customized 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 > Offer (Pop-up) 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:

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.