Функции работы в чатах и каналах Telegram

19.09.2025

На этой странице

Так как внутри Salebot идентификаторы клиентов (пользователей, групп, каналов) внутри мессенджера записываются в переменной platform_id без каких-либо меток, к чему это принадлежит группе или пользователю, то для работы с функциями принятия/отклонения заявки требуется единожды запомнить значения platform_id чата и platform_id пользователя в переменные с разными именами, например, chat_id и user_id.

Как изменить настройки чата/канала Telegram

Как поменять имя чата через бот в Telegram

tg_set_group_title(platform_id, title)

Параметры:

Как поменять описание чата через бот в Telegram

tg_set_chat_description(platform_id, description)

Как установить аватарку на группу/чат в Telegram

tg_set_chat_photo(platform_id, photo)

Как удалить аватарку группы/чата в Telegram

tg_delete_chat_photo(platform_id)

Как забанить/разбанить группу Telegram

Как забанить группу Telegram

tg_ban_chat_sender_chat(platform_id, sender_chat_id)

Параметры:

При этом владелец забаненного чата не сможет писать и от имени других своих чатов до тех пор, пока не будет разбанен

Как разбанить группу Telegram

tg_unban_chat_sender_chat(platform_id, sender_chat_id)

Параметры:

Как работать с ссылками на чат/канал Telegram

Как создать ссылку на вступление в чат в Telegram

tg_create_chat_invite_link(platform_id, member_limit, hours, request, name)

Параметры:

При передаче параметра member_limit значение параметра request автоматически заменится на False. Если же нужно принимать заявки на вступление, то параметр member_limit оставляем пустым.

Создание ссылки на вступление в чат:

Как удалить ссылку на вступление в чат в Telegram

tg_revoke_chat_invite_link(platform_id, invite_link)

Параметры:

Как сделать неактивными все существующие ссылки и заменить их на одну

Использовать с осторожностью. Все существующие ссылки для входа в вашу группу станут неактивными.

tg_export_chat_link(platform_id)

Параметры:

Результат - ссылка, которая будет единственным способом попасть в группу до тех пор, пока не будут созданы дополнительные ссылки прочими способами.

Как работать с заявками в чат/канал Telegram

Как принять заявку и добавить пользователя в канал/чат в Telegram

tg_approve_chat_join_request(chat_id, user_id)

Параметры:

Прием заявки:

Как отклонить заявку в канал/чат в Telegram

tg_decline_chat_join_request(chat_id, user_id)

Параметры:

Отклонение заявки

Как работать с подписчиками чата/канала Telegram

Как заблокировать пользователя в Telegram

tg_ban_chat_member(chat_id, user_id, hours)

Параметры:

Как разблокировать пользователя в Telegram

tg_unban_chat_member(chat_id, user_id)

Параметры:

Как проверить наличие подписки в Telegram

tg_get_chat_member(chat_id, user_id)

Параметры:

Как определить число участников в канале/чате

tg_get_chat_member_count(platform_id)

Параметры:

Как проверить, состоит ли участник чата в определенном списке

some_client_in_list(list_id, recepient)

Параметры:

https://www.youtube.com/watch?v=PajSl8clgVk

Проверка подписки на канал Телеграм

Как показать действия в чате/канале Telegram

Как показать пользователю действия бота (печатает/выбирает стикер и т.д)

tg_send_chat_action(platform_id, bot_action, message_thread_id)

! Работает с бизнес-аккаунтом в Телеграм

Параметры:

typing для текстовых сообщений,
&#xNAN;upload_photo для фотографий,
&#xNAN;record_video или upload_video для видео ,
&#xNAN;record_voice или upload_voice для голосовых заметок,
&#xNAN;upload_document для общих файлов,
&#xNAN;choose_sticker для стикеров,
&#xNAN;find_location для данных о местоположении,
&#xNAN;record_video_note или upload_video_note для видеозаметки.

Данное уведомление будет отображаться, пока не будет получен какой-либо ответ от бота, но не более 5 секунд.

Как показывать пользователю Alert-уведомления

tg_answer_callback_query(callback_query_id, text,show_alert,cache_time)

Alert-уведомления показываются только в результате нажатия на callback-кнопку в телеграмме.

Для примера используем следующие кнопки:

[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"первая"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"вторая"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"третья"}]

После нажатия на такую кнопку приходит callback с текстом, содержащимся в соответствующем поле. При нажатии на кнопку “111” придет callback с текстом “первая”.

Создадим блок с первостепенной проверкой условия и в условие пишем желаемый текст. В нашем случае “первая”:

Если в поле Выбор соответствия выбрать Игнорируя ошибки и неточности, то в дальнейшем можно будет такой блок использовать для всех вариантов, которые отличаются на 1-2 символа. Например, благодарить за поставленную такой кнопкой оценку работы.

Далее в калькуляторе используйте функцию tg_answer_callback_query и в нее поместите такие параметры:
callback_query_id - данный id позволяет идентифицировать нажавшего кнопку и продемонстрировать ему Alert-уведомление,
text - текст Alert-уведомления.

Пример кода для копирования:

tg_answer_callback_query('#{callback_query_id}', "Вы нажали кнопку 111")

Важно! Параметр callback_query_id нужно передавать так, как показано в примере, т.е. в '#{}'

Если все подготовлено правильно, то результатом нажатия на кнопку будет Alert-уведомление с заданным текстом. В мобильной версии имя бота будет как заголовок над текстом.

Если же вы хотите показать простое всплывающее сообщение, то передайте третьим параметром False, как в примере ниже:
tg_answer_callback_query('#{callback_query_id}', "Вы нажали кнопку 222", False)

Как в реакции на callback-кнопку добавить переход в бота с тэгом

tg_callback_url_open(callback_query_id, url, cache_time)

Параметры:

В реакции на callback-кнопку можно добавить переход в бота с тегом tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX')

Для примера используем следующие кнопки:

Создадим блок с первостепенной проверкой условия и в условие пишем желаемый текст. В нашем случае “первая”:

Далее в калькуляторе блока укажем tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX'):

Как настроить права в чате/канале Telegram

Как повысить пользователя до администратора в супергруппе или канале в Telegram

tg_promote_user(platform_id, user_id, promote_options_list)

Параметры:

В списке прав promote_options_list можно указать следующие права:

is_anonymous — присутствие администратора в чате скрыто,
can_manage_chat — администратор может получить доступ к журналу событий чата, статистике чата, статистике сообщений в каналах, видеть участников канала, видеть анонимных администраторов в супер-группах и игнорировать медленный режим. Этот уровень прав выдается по умолчанию, в случае указания любой из последующих привилегий.
can_post_messages — администратор может создавать сообщения канала, только для каналов
can_edit_messages — администратор может редактировать сообщения других пользователей и может закреплять сообщения, только для каналов
can_delete_messages — администратор может удалять сообщения других пользователей
can_manage_video_chats — администратор может управлять видеочатами,
can_restrict_members — администратор может ограничивать, ставить/отменять бан участникам чата,
can_promote_members — администратор может добавлять новых администраторов с подмножеством их собственных привилегий или понижать в должности администраторов, которых он повысил, прямо или косвенно (повысили администраторы, которые были им назначены)
can_change_info — администратор может изменить название чата, фото и другие настройки
can_invite_users — администратор может приглашать новых пользователей в чат
can_pin_messages — администратор может закреплять сообщения, только для супергруппы.

Разберем пример как повысить пользователя до администратора в супергруппе:

В данном примере помимо перечисленных прав будут по умолчанию выданы права can_manage_chat.

Пример кода для копирования

Как изменить титул администратора с помощью бота в Telegram

tg_set_administrator_title(platform_id, user_id, title)

Параметры:

ВАЖНО!

Работает только на пользователях, которых администраторами супергруппы назначил бот

Пример кода для копирования:

result=tg_set_administrator_title(platform_id, reply_from, "огоньтитул")

Ограничения для пользователей

Общие ограничения для обычных пользователей чата или для отдельных пользователей Telegram

tg_chat_permission(platform_id, permission, media_permissions)

Параметры:

Список ограничений permission:
1. ! can_send_messages - разрешение отправлять текстовые сообщения, контакты, местоположения и места проведения
2. ! can_send_media_messages - разрешение отправлять аудио, документы, фотографии, видео, видеозаметки и голосовые заметки, подразумевается наличие разрешения can_send_messages
3. ! can_send_polls - разрешение отправлять опросы, подразумевается наличие разрешения can_send_messages
4. ! can_send_other_messages - разрешение отправлять анимацию, игры, стикеры и использовать встроенных ботов, подразумевается наличие разрешения can_send_media_messages
5. ! can_add_web_page_previews - разрешение добавлять превью веб-страницы к своим сообщениям, подразумевается наличие разрешения can_send_media_messages
6. ! can_change_info - разрешение изменять название чата, фото и другие настройки. Игнорируется в публичных супергруппах
7. ! can_invite_users - разрешение приглашать пользователей
8. ! can_pin_messages - разрешение закреплять сообщения. Игнорируется в публичных супергруппах
9. can_manage_topics - разрешение создавать темы в группах-форумах. Если пытаться применить в группах неподходящего типа, то функция не сработает и вернет ошибку.

Список значений для выдачи прав по работе с медиа media_permissions:

1. can_send_audios - разрешение отправлять аудиофайлы
2. can_send_documents -разрешение отправлять документы
3. can_send_photos - разрешение отправлять фото
4. can_send_videos - разрешение отправлять видео
5. can_send_video_notes - разрешение отправлять круглое видео
6. can_send_voice_notes - разрешение отправлять голосовые сообщения

Персональные ограничения для обычных пользователей чата или для отдельных пользователей Telegram

tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).

Параметры:

Параметр	Описание
! platform_id	идентификатор чата внутри Telegram *
! user_id	идентификатор пользователя внутри Telegram *
minutes	кол-во минут, в течении которого будет действовать ограничение (если не указать явно, по умолчанию будет применено значение 3600, что соответствует 60 часам, а если указать 0, то ограничения будут действовать бессрочно)
permission	массив значений для списка ограничений
media_permissions	список значений для выдачи прав по работе с медиа

Список значений для выдачи прав по работе с медиа media_permissions:

Пример применения функции, в котором пользователю запретили все на 3 минуты:

При входе в чат пользователю будет показано уведомление о невозможности писать в чат и если ограничение по времени было выставлено, то он увидит срок действия данного ограничения.

Код для копирования:

permission = [0, 0, 0, 0, 0, 0, 0, 0] 
tg_restrict_chat_member(-1001607137668, 473737685, 3, permission)

Как работать с сообщениями в чате/канале Telegram

Как закрепить сообщение

tg_pin_chat_message(platform_id, message_id, disable_notification)

Параметры:

Как открепить сообщение

tg_unpin_chat_message(platform_id, message_id)

Параметры:

Как открепить все закрепленные сообщения

tg_unpin_all(platform_id)

Параметры:

ВНИМАНИЕ!

В Telegram существует ограничение для функций закрепить/открепить сообщение.

Сроки возможности использования функций tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all ограничиваются НЕ системой Сейлбота.

Если срок обращения к сообщению для закрепления прошел, то функция хотя и вернет true, но для самого Телеграм настройки не будет применены.

Также важно учитывать, что закрепленные сообщения могут сохраниться в кеше и визуально удалиться не сразу.

Как создать/закрыть опрос в чате/канале Telegram

Как создать простой опрос в Telegram

tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)

Параметры:

Примечания

1. Функция возвращает ответ от телеграма, в котором есть message_id, его лучше сохранять, так как с его помощью можно будет завершить опрос функцией tg_stop_poll (описание ниже) и получить результат.

2. Если опрос добавлен пользователем в канал, то в диалог придет колбек:

poll_added - неизменная часть
Вопрос - текст вопроса из опроса

Второй колбек после poll_added содержит цифры - это не что иное, как идентификатор пользователя в Telegram, который добавил опрос.

При создании опроса ботом колбек не приходит.

3. В канале можно создавать только анонимные опросы

Внимание, рекомендуется отправлять в группу только анонимные опросы!

4. После создания опроса в переменную сохраните его идентификатор, чтобы понимать на какой опрос пришел колбек.

В своей работе мы часто задаемся вопросами, на которые могли бы ответить наши клиенты. Опросы очень помогают получить обратную связь от клиентов и сделать определенные выводы.

Пример кода для копирования:

Как создать викторину в Telegram

tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )

Параметры:

Примечания

1. Функция возвращает ответ от Telegram, в котором есть message_id, его лучше сохранять, так как с его помощью можно будет завершить викторину функцией tg_stop_poll (описание ниже) и получить результат.

2. Если опрос добавлен пользователем в канал, то в диалог придет колбек:
poll_added - неизменная часть
Вопрос - вопрос опроса

Если опрос создан в чате, то колбек дополнительно будет содержать цифры - это идентификатор пользователя в Telegram, который добавил опрос.

При создании опроса ботом колбек не приходит.

3. В канале можно создавать только анонимные викторины

4. Если викторина была отправлена в диалог пользователя с ботом или в чат группы, то колбек о выбранном ответе придет в диалог бота с клиентом и будет иметь следующий вид:

Нумерация ответов начинается с 0.
poll_answer 5325838371359031648
[3]

poll_answer - неизменяемая часть
5325838371359031648 - идентификатор викторины
&#xNAN;[3] - ответ

5. Если неанонимный опрос был создан в группе (неважно функцией или пользователем), в которой состоит в качестве администратора бот, то на каждый голос будет отправлен вебхук, при получении которого в диалог бота с клиентом будет отправлен колбек из пункта

6. Если клиент не контактировал с ботом, то отправить ему что-либо в ответ не получится, пока клиент не активирует бота.

Внимание рекомендуется отправлять в группу только анонимные викторины!

7. После создания викторины сохраните в переменную его идентификатор, чтобы понимать на какой опрос пришел колбек.

Пример кода для копирования:

/*Пример создание Викторины*/
options = ["белый", "красный", "синий", "зеленый"] 
r = tg_send_quiz_poll(platform_id, 'Какого цвета крокодил?', options, 'Вот такое вот объяснение.', 4, '', '', '', '', 1)

Пример создания Викторины:

Как завершить опрос

Когда опрос или викторина завершаются этой функцией в ответ приходит словарь с результатом опроса.

tg_stop_poll(platform_id, message_id)

Параметры:

Как работать с Форумами/Темами Telegram

1. Как работать с главной темой Telegram

Важно!

Главная тема группы не имеет id и для работы с ней есть отдельные функции.

Как переименовать главную Тему группы

tg_edit_general_forum_topic(platform_id, topic_name, bot_name)

Параметры:

Изменить Главную тему группы можно при помощи функции tg_edit_general_forum_topic(). Здесь 2 обязательных параметра - это идентификатор чата и новое наименование для Темы группы:

переименовать чат главной Темы/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')

Как закрыть главную Тему

tg_close_general_forum_topic(platform_id)

Параметры:

/закрыть чат главной Темы/
answer = tg_close_general_forum_topic(-1001839380031)

Как открыть ранее закрытую главную Тему

tg_reopen_general_forum_topic(platform_id, bot_name)

Параметры:

/открыть чат главной Темы/
answer = tg_reopen_general_forum_topic(-1001839380031)

Как скрыть главную Тему

tg_hide_general_forum_topic(platform_id, bot_name)

Параметры:

Суть данной операции в том, что чат Главной темы будет закрыт для участников Темы (можно читать, но нельзя писать) и скрыт из общего списка чатов Telegram для новых пользователей.

/скрыть чат главной Темы/
answer = tg_hide_general_forum_topic(-1001839380031)

Как отобразить главную Тему или вернуть её видимость

tg_unhide_general_forum_topic(platform_id, bot_name)

Параметры:

Важно!

Данная функция не открывает главную тему, а только делает ее видимой

/отобразить чат главной Темы/
answer = tg_unhide_general_forum_topic(-1001839380031)

2. Как работать с дополнительными темами Telegram

Как создать новую тему Telegram

tg_create_forum_topic(platform_id, name, icon, icon_color, bot_name)

Параметры:

Изменить установленный цвет нельзя, цвет задается только в момент создания темы

В результате исполнения функция вернет ответ, содержащий параметры новой темы, в том числе идентификатор темы (нужен для различных функций)

Давайте создадим чат дополнительной темы:

Переменная answer будет содержать ответ следующего содержания:
{"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}

Здесь нам важно сохранить значение message_thread_id, оно нам понадобится в дальнейшем для работы с созданной темой:

Создаем чат дополнительной темы
answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)

Сохраняем идентификатор чата созданной дополнительной темы
answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/
idtema1=answer['result']['message_thread_id']

Как изменить тему. Как переименовать и/или поменять эмодзи для темы

tg_edit_forum_topic(platform_id, message_thread_id, name, icon, bot_name)

Параметры:

answer = tg_edit_forum_topic(-1001839380031, 254)

Как закрыть выбранную тему

Закрыть тему - это значит оставить ее только для чтения, писать в закрытую тему нельзя

tg_close_forum_topic(platform_id, message_thread_id, bot_name)

Параметры:

answer = tg_close_forum_topic(-1001839380031, 254)

Как открыть ранее закрытую тему

tg_reopen_forum_topic(platform_id, message_thread_id, bot_name)

Параметры:

answer = tg_reopen_forum_topic(-1001839380031, 254)

Как удалить тему со всеми сообщениями

tg_delete_forum_topic(platform_id, message_thread_id, bot_name)

Параметры:

answer = tg_delete_forum_topic(-1001839380031, 254)

Как открепить все сообщения темы

tg_unpin_topic_messages(platform_id, message_thread_id, bot_name)

Параметры:

answer = tg_unpin_topic_messages(-1001839380031, 254)

Как получить список эмодзи для Темы Telegram

tg_get_forum_icon() - функция вернет какие эмодзи можно ставить на иконки тем форумов. Необходимо присвоить функцию переменной, так как в ответ будет словарь, в котором ключом будет эмодзи, а значением идентификатор этого эмодзи id

Параметры: без параметров.

Для получения списка эмодзи для чата Темы отправьте команду в необходимый чат:

В ответ функция вернет список эмодзи, т.е. переменная answer будет иметь в качестве значения словарь:

{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}

answer = tg_get_forum_icon()