Knowledge base

hotline.tg

Telegram Bulk Message Sender and Audience Segmentation Bot

Features /send, /mark and /export commands for Telegram CRM Hotline.
After connecting your bot or regular user account to Hotline CRM (connects in parallel to existing bots or accounts, does not affect their work, done for free in a few minutes), it becomes possible to use three powerful interconnected commands from our extension bot on the side of your backend group:

/send – for mass sendings of messages or templates with message chains to Telegram users

/mark – to assign marks (labels, additional statuses) to user topics and determine the behavior of these marks

/export – to export as a file a list of users with whom there was correspondence through the system Hotline and/or having the specified mark
Attention: This page contains fragments with automatic translation. If you have difficulty understanding this information, try switching the language to English or Russian and use your trusted system for translating websites.
Connecting Extension Bot
To use the commands described in this article, you must add an extension bot @hotlinetg_extensions_bot with administrator rights to your backend group.

Basic version Hotline (the core of the system) is responsible for the reliable forwarding of the flow of messages with users and contains only main functionality.
Sending System Limits
The free version of the system allows you to send via the sending system a command /send up to 200 messages per month. The paid version of the system allows you to send up to 1000*N messages per month, where N is equal to the number of system operators in a paid subscription.

If you need to expand the standard limits for sending messages, please contact Support Service.

There are no restrictions for the /mark and /export commands.
Quick Help
To get quick help in English in your backend group, you can send a command at any time /send, /mark or /export without parameters in the appropriate context (in General topic, custom topic, or in a reply to a message).
Access Limitation
Team Administrative Functions /send, /mark и /export only available from General backend group topic, access to them can be limited through a special parameter @EXTENSIONS_ALLOWED@ in the installation bot @hotlinetg_bot.

/send command usage options

Command /send allows you to send individual messages or even message threads containing all major message types Telegram: text with any formatting, stickers, voice messages, videos, images, files.

The following may be indicated as mailing recipients:
  • operator executing the command /send, to test the message (option = test)
  • all users with whom there is a dialogue (topic) through the system Hotline (option = all)
  • list of users in the attached file (option = file)
  • list of users separated by commas in the command itself (option = list)
  • all users who are given the corresponding mark by the command /mark (option = mark)

You can send both single messages (without saving the sending as a template) and message chains (by saving a single message or a sequence of messages as a template with the necessary options).

For each message sent in the optional parameter [now,delay,datetime] you can specify a time to send:
  • now (to be sent at the time the command is called, used by default)
  • with delay in format 100s 10m 5h 2d (from 1 to 4 parameters with the required number of seconds, minutes, hours or days) from the moment the command was sent or the moment the previous message in the chain was sent)
  • fixed date and time of dispatch by UTC in the format 2024-12-27 14:25:55
Command /send has 3 main contexts of use:

Optional parameters for commands are indicated in [square] brackets.

/send in General topic as reply to message

Send a message to the desired list of recipients
↳ /send test [now,delay,datetime] [instance_id]
Send specified in reply message to yourself for testing
↳ /send all [now,delay,datetime] [instance_id]
Send specified in reply message to all users with whom there has ever been a dialogue via Hotline
↳ /send file [now,delay,datetime] [instance_id]
Send the message specified in reply to all users whose user_id is specified in the attached file. The list of user_id in the file can be separated by commas, spaces or a new line. Non-numeric values from the file are ignored.
↳ /send list [now,delay,datetime] [instance_id] USERS_LIST
Send the message specified in reply to all users whose user_id is specified in the list (the last parameter of the command). Values in the user_id list are separated by commas.
↳ /send mark MARK_NAME [now,delay,datetime] [instance_id]
Send specified in reply message to all users with a given label MARK_NAME cookie command /mark.
Optional parameter instance_id can be specified if several instances are connected to one backend group and it is necessary to explicitly indicate for which of them the command from General topic. By default, all commands are executed independently for each instance Hotline.
Create a template to send or add a message to an existing template
↳ /send TEMPLATE_NAME [now,delay,datetime]
Adds the specified in reply message to a new or existing template named TEMPLATE_NAME. The template name must begin with a Latin letter and may contain numbers, a hyphen or an underscore; letters are not case sensitive. A template can contain either one message or a chain of messages. You can set the time at which the message is sent (from the moment the command is called for the first message, or the moment the previous message in the chain is sent).

/send in General topic (without reply)

Send messages from a specified template to the desired list of recipients
/send test TEMPLATE_NAME [now,delay,datetime] [instance_id]
Send template TEMPLATE_NAME to yourself for testing
/send all TEMPLATE_NAME [now,delay,datetime] [instance_id]
Send template TEMPLATE_NAME to all users with whom there has ever been a dialogue via Hotline
/send file TEMPLATE_NAME [now,delay,datetime] [instance_id]
Send the TEMPLATE_NAME template to all users whose user_id is specified in the attached file. The list of user_id in the file can be separated by commas, spaces, or a newline. Non-numeric values from the file are ignored.
/send list TEMPLATE_NAME [now,delay,datetime] [instance_id] USERS_LIST
Send the TEMPLATE_NAME template to all users whose user_id is specified in the list (the last parameter of the command). Values in the user_id list are separated by commas.
/send mark MARK_NAME template TEMPLATE_NAME [now,delay,datetime] [instance_id]
Send the TEMPLATE_NAME template to all users with the given MARK_NAME mark via the /mark command.
View the list or properties of created templates and mailings
/send templates
Show all created sendings templates.
/send sendings [instance_id]
Show the latest created sendings (if several instances are connected to the backend group, you can specify which one).
/send TEMPLATE_NAME
Show properties of the specified sending template.
/send sidSENDING_ID
Show the status and properties of the specified mailing, as well as get a report on its execution at the current moment.
Editing and deleting templates and mailings
/send TEMPLATE_NAME name NEW_NAME
Set a new name for the template
/send TEMPLATE_NAME for MESSAGE_ID [now,delay,datetime]
Set a new sending time in the template for a message with the specified ID
/send TEMPLATE_NAME del MESSAGE_ID
Remove a message with a specified ID from the template
/send TEMPLATE_NAME del
Delete the specified template
/send sidSENDING_ID del
Delete and cancel a sending with the specified ID (available only if the mailing has not yet been executed and is in the status awaits)

/send in a custom topic (without reply)

Sending the specified template to the topic user
/send TEMPLATE_NAME [now,delay,datetime]
Additionally, you can specify the time of sending.
Displaying information about templates and mailings
/send templates
Show templates created in the backend group.
/send sendings
Show sends by command /send for the current topic.
/send sidSENDING_ID
Show the status and properties of the specified submission (without receiving a report).
IMPORTANT: After adding extensions bot @hotlinetg_extensions_bot all command functions called in user topics to your backend group /send и /mark become available to all users of the backend group (employees, managers). At the same time, the administrative functions of the teams /send, /mark or /exportcalled in General the topic can be limited through the parameter @EXTENSIONS_ALLOWED@ at the corresponding connection in the installation bot @hotlinetg_bot.

/mark command usage options

Command /mark allows you to assign an arbitrary set of labels to topics with dialogues on the side of the backend group (these can be either topics of dialogues with users or bots, or topics for communication in groups).

Marks can be used to assign arbitrary additional properties to topics and/or convenient auxiliary operations.
Marks capabilities:

  • assign additional marks to topics properties for segmentation and/or subsequent use in sendings by the command /send or when exporting with the command /export
  • setting sales funnel statuses, when setting the next status removes all previous statuses from the specified set (after parameter)
  • automatic sending of a template with a chain of messages after assigning an appropriate label to the topic (sends parameter)
  • displaying a short string or emoji in the topic title, containing the initials of the manager responsible for the transaction, the user's country/language flag or other property in the title of the topic (ticker parameter).
Command /mark has 2 main contexts of use:

/mark in General topic

/mark
Show a list of created marks for this backend group.
/mark new MARK_NAME
Create a new mark with the given name. The mark name must begin with a Latin letter and may contain Latin letters, numbers, a hyphen or an underscore; letters are not case sensitive.
/mark MARK_NAME
Show mark properties and a list of topics with this mark.
/mark MARK_NAME after MARK1, MARK0
Set parameter AFTER for the mark. The value specifies a list of mark names that will be removed from the topic when this mark is assigned. The list can be of any length, the values ​​are separated by commas. To clear a parameter, send the value CLEAR.
/mark MARK_NAME sends TEMPLATE_NAME
Set parameter SENDS for the mark. The value specifies the name of the command template for /send (with a single message or a chain of messages) that will be activated when this mark is assigned. To clear a parameter, send the value CLEAR.
/mark MARK_NAME ticker STRING|EMOJI
Set parameter TICKER for the mark. The value can be a short string (Latin letters, numbers, hyphen, underscore) or emoji, which will be added to the topic name when assigning this mark. To clear a parameter, send the value CLEAR.
/mark MARK_NAME name NEW_MARK_NAME
Set a new name for the mark.

/mark in the topic with dialogue

/mark
Show a list of specified marks for this topic.
/mark MARK_NAME
Add the specified mark for this topic.
/mark del MARK_NAME
Remove the specified mark for this topic.

Using the command /export

Command /export allows you to obtain in the form of a file a list of users with whom there was correspondence through the system Hotline and having the specified mark.
The command can only be used in General group topic.
/export all
Exports all topics as a CSV file that contains all the main properties of the topic (user_id, date of last message, dialogue status, topic name, topic type, link to topic).
/export MARK_NAME
Exports all topics with a given mark as a CSV file in the format described above.
If you encounter difficulties using the extension bot functions, please contact Support Service.