Labels and Sales Funnels `/mark`¶

The /mark command allows you to create an arbitrary set of labels for dialog topics. Labels are used for customer segmentation, building sales funnels, and process automation.

How It Works¶

Labels are additional properties that can be assigned to customers with dialogs and conveniently displayed in topic names. Each label can have its own behavior parameters and automatically trigger actions when assigned (remove other labels, send a template, send a quick reply, or change topic icon).

Main Features¶

Visual indicators in topic name with short command
Assigning supported Telegram topic icons via the ICON parameter
Bulk assignment and removal of labels
Segmentation for mailings and export
Building sales funnels with automatic removal of previous statuses
Automatic quick reply sending when assigning label
Automatic template sending when assigning label

Calling the Command¶

In General Topic¶

Administrative functions for managing labels.

Viewing labels

Show list of all labels in backend group:

/mark

Show label properties and list of topics with this label:

/mark MARK_NAME

Quick help:

/mark help

Creating label

Create new label. Name must start with Latin letter, can contain letters, numbers, hyphen or underscore. Case insensitive.

/mark new MARK_NAME

Configuring label parameters

Set AFTER parameter — list of labels to remove:

/mark MARK_NAME after MARK1,MARK2

Clear AFTER parameter:

/mark MARK_NAME after CLEAR

Set SENDS parameter — template for auto-sending:

/mark MARK_NAME sends TEMPLATE_NAME

Clear SENDS parameter:

/mark MARK_NAME sends CLEAR

Set SAY parameter — quick reply name for auto-sending:

/mark MARK_NAME say QUICK_REPLY_NAME

Clear SAY parameter:

/mark MARK_NAME say CLEAR

Set TICKER parameter — visual indicator:

/mark MARK_NAME ticker STRING|EMOJI

Clear TICKER parameter:

/mark MARK_NAME ticker CLEAR

Show available Telegram topic icons so you can copy and use them in the command:

/mark MARK_NAME icon

Set the ICON parameter — the icon assigned to a topic together with the label:

/mark MARK_NAME icon EMOJI

You can use only an EMOJI from the list shown by /mark MARK_NAME icon. If you provide another value, the system displays the available icons again.

Clear ICON parameter:

/mark MARK_NAME icon clear

Bulk label assignment and removal

Assign a label to dialogs listed in the command:

/mark MARK_NAME list CHAT_ID1,CHAT_ID2,CHAT_ID3

Remove a label from dialogs listed in the command:

/mark del MARK_NAME list CHAT_ID1,CHAT_ID2,CHAT_ID3

Assign a label to dialogs from an attached text file (attach the file to the message containing the command):

/mark MARK_NAME file

Remove a label from dialogs in an attached text file:

/mark del MARK_NAME file

The command and text file support the following formats:

Format	Dialog
`123456789`	Private dialog
`-1001234567890`	Group without a topic
`-1001234567890(42)`	Topic `42` in a group; uses the Bot API `thread_id`

IDs can be separated by commas, spaces, or line breaks. Duplicate values are processed once. In a TSV file, the first non-empty column of each row is read and the header row is skipped.

A single command can process up to 1,000 unique dialogs. Topic title and icon changes, the AFTER parameter, and the SAY quick reply are applied sequentially to each dialog with Telegram limits taken into account, so a large list can take considerable time to process.

For a list of more than 10 dialogs, the system reports that the operation has started. When it finishes, a summary appears in the General topic with the numbers of processed dialogs, successful assignments or removals, dialogs not found, and errors.

Renaming

Change label name:

/mark MARK_NAME name NEW_MARK_NAME

In Dialog Topic¶

Setting and removing labels

Show labels assigned to this topic:

/mark

Add label to topic:

/mark MARK_NAME

Remove label from topic:

/mark del MARK_NAME

Usage Examples¶

Distributing topics by managers

Create labels for each manager with commands in General topic:

/mark new aa
/mark aa ticker Alex

/mark new ma
/mark ma ticker Maria

/mark new jk
/mark jk ticker John

Now managers can apply commands in topics to quickly label topics with their name:

/mark aa

/mark ma

/mark jk

Segmentation by countries

Create labels for users from different countries:

/mark new es
/mark es ticker 🇪🇸

/mark new ru
/mark ru ticker 🇷🇺

/mark new uk
/mark uk ticker 🇺🇦

Sales funnel

Creating a classic funnel with automatic removal of previous statuses:

/mark new lead
/mark new ticker LEAD

/mark prop
/mark prop after lead
/mark prop ticker PROPOSAL

/mark deal
/mark deal after lead,prop
/mark deal ticker ✅

/mark lost
/mark lost after lead,prop,deal
/mark lost ticker ❌

Now when moving a customer through the funnel, previous statuses are automatically removed.

Automatic VIP customer greeting

Create greeting template for /send command:
```
/send vip_welcome
```

Configure label with auto-sending:

/mark new vip
/mark vip sends vip_welcome
/mark vip ticker 👑

Now when assigning label /mark vip in any topic, customer automatically receives message according to vip_welcome template.

Traffic sources

Track where customers came from:

/mark new source_website
/mark source_website ticker 🌐

/mark new source_instagram
/mark source_instagram ticker 📸

/mark new source_referral
/mark source_referral ticker 👥

Then export database by sources for analyzing channel effectiveness.

Mailings by labels

/send mark vip template special_offer

Send special offer to all VIP customers with /send command.

Export by labels

/export mark deal

Export all customers with deal status using /export command.

Access Restriction¶

By default, functions for creating and configuring labels in General topic are only available to connections administrators. Access can be extended via EXTENSIONS_ALLOWED parameter.

Working in topics

Operators can add and remove created labels in dialog topics even without administrative access.

Useful Tips¶

Plan your structure

Before creating labels, think through their structure and relationships. This is especially important for the AFTER parameter in sales funnels.

Combine attributes

Labels can be combined — one topic can have multiple labels simultaneously (for example, vip + english + alex).

Labels and Sales Funnels /mark¶