Как разрешить боту отправлять сообщения в телеграмме

Отправка уведомлений в Telegram

Вы можете использовать мессенджер Telegram для получения уведомлений о состоянии виртуальных машин и узлов кластера. Для отправки уведомлений VMmanager использует Telegram-бота.

Чтобы настроить отправку уведомлений в Telegram:

1. Создайте бота в Telegram.
2. Подключите бота к VMmanager.
3. Добавьте Telegram в качестве канала ув едомлений.

Настройка на стороне Telegram

1. Откройте диалог с ботом @BotFather.
2. Отправьте команду /newbot .
3. Введите название бота. Например, VMmanager Notifier.
4. Введите имя пользователя для бота. Оно должно оканчиваться сочетанием «bot». Например, vmnotifybot.
5. Сохраните значение токена из ответа.
6. Добавьте бота в группу Telegram для отправки уведомлений.

Чтобы бот мог отправлять сообщения пользователю Telegram, пользователь должен открыть диалог с ботом и нажать Запустить.

Пример создания бота

Настройка на стороне VMmanager

Подключение бота

1. Перейдите в → Мессенджеры → Подключить мессенджер.
2. Вставьте Токен Бота.
3. Нажмите Активировать.
4. Выберите нужные чаты для отправки уведомлений.
5. Выберите Язык сообщений.
6. Нажмите Сохранить.

Чтобы изменить настройки бота, нажмите значок → введите Токен Бота → Сохранить.

Чтобы удалить подключенного бота, нажмите значок → Удалить бота → Удалить.

Пример подключения бота

Управление каналами

В разделе → Мессенджеры вы можете управлять каналами, в которые бот будет отправлять сообщения. Каналами могут быть группы и отдельные пользователи Telegram.

Для добавления канала:

1. Нажмите Добавить канал.
2. Выберите Язык сообщений.
3. Укажите произвольное Имя канала.
4. Выберите канал из списка или Введите ID чата.
5. Укажите произвольное Примечание для канала.
6. Нажмите Добавить.

Чтобы изменить настройки канала, нажмите значок .

Чтобы включить/отключить отправку сообщений в канал, нажмите переключатель .

Чтобы удалить канал, нажмите .

Интерфейс раздела «Мессенджеры»

Добавление канала к уведомлению

Чтобы использовать Telegram в качестве канала уведомления:

1. Перейдите в раздел «Центр уведомлений»: → Настройка уведомлений.
2. Нажмите на название уведомления.
3. Выберите каналы в поле В каналы мессенджеров.
4. Нажмите Сохранить.

Подробнее об управлении уведомлениями см. в статье Уведомления.

Добавление канала уведомления

Настройка одновременной отправки уведомлений

По умолчанию VMmanager одновременно отправляет не более пяти уведомлений в Telegram. Чтобы изменить этот параметр:

1. Подключитесь к серверу с VMmanager по SSH.
2. Перейдите в докер-контейнер vm_msgsender_1:

docker exec -it vm_msgsender_1 bash

environment=TELEGRAM_TASK_LIMIT=

Как разрешить боту отправлять сообщения в телеграмме

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

Добавление бота в группу

Чтобы бот работал в группе, просто добавьте его в эту группу. Это можно сделать так:

1. Откройте настройки группы или бота.
2. Нажмите кнопку «Добавить».
3. В поиске найдите нужного бота или группу.
4. Сделайте бота администратором с необходимыми правами.
5. Включите поддержку групп в настройках Ботмамы.

Управление правами бота в группе

Управлять возможностями бота можно через BotFather.

1. Отправьте боту BotFather команду /mybots.
2. Выберите нужного бота и нажмите Bot Setting.

В разделе Bot Setting есть следующие настройки для группы:

Аllow Groups? — разрешить добавлять бота в группы.

Если выключить группу, нажав Turn group off после перехода в Allow Groups, то добавить бота в группы не получится. Если бот уже добавлен в какие-то группы, то он останется в них и не смотря на запрет и сможет обрабатывать запросы.

Group Privacy отвечает за доступ бота ко всем сообщениям группы.

Если перейти по кнопке Group Privacy затем выключить Privacy mode (режим конфиденциальности) то бот сможет получать все сообщения из группы.

В Group Admin Rights и Channel Admin Rights можно управлять правами бота в группах и каналах.

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

Поддержка групп в Ботмаме

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

После добавления бота в группу через BotFather и добавления настройки для работы с группами в конструкторе, боту можно написать из группы. Для этого любой пользователь группы может написать /start в группе. После этого запустится цепочка сообщений от бота и в разделе Пользователи появится ID и название группы.

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

Сообщения от бота будут видны всем участникам группы.

Если в боте настроено Событие Шаблон то оно сработает и в группе, если бот добавлен в группу.

В группу можно отправлять обычные и триггерные рассылки.

Бот не разделяет участников группы между собой, воспринимая группу как одного пользователя, это значит, что в разделе Диалоги не будет видно разделения по пользователям внутри группы (то есть группа будет единым пользователем).

Работа с группами через конструктор

В Ботмаме доступны следующие функции для работы с группами:

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

2. Запрет на работу со всеми группами кроме одной конкретной.

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

Если делать запрет на работу с группами через Bofather, то он запретит работу со всеми группами, а Ботмама таких запретов делать не может в принципе. Но бот может проверять, из какой группы пришел пользователь и переводить на сценарий бота только тех пользователей, которые перешли из разрешенной группы.

Для реализации создайте событие Сообщение в группе (Телеграм).

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

На экран, который придет, когда сработает событие, первым компонентом добавьте Развилку.

Имя переменной, откуда развилка будет брать значение должно быть lastUpdate.update.chat.id

В этой переменной лежит ID группы.

В Развилку добавьте одну цель, в значении которой должен быть ID разрешенной группы.

Переход по Цели 1 будет вести на основной сценарий.

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

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

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

4. В группу можно пересылать сообщения от пользователей бота с помощью Запроса или Нативного запроса.

5. Алерт и Сообщение по ID получателя помогут отправить сообщение определенному пользователю в Телеграм. Этим пользователем может быть и группа.

Запросы API для групп

В документации API Telegram есть множество других методов работы бота с группами.

Их можно реализовывать с помощью Нативного запроса или Запроса.

Боты: информация для разработчиков

Боты — специальные аккаунты в Telegram, созданные для того, чтобы автоматически обрабатывать и отправлять сообщения. Пользователи могут взаимодействовать с ботами при помощи сообщений, отправляемых через обычные или групповые чаты. Логика бота контролируется при помощи HTTPS запросов к нашему API для ботов.

Общие сведения

Что могут делать боты?

Вот несколько примеров использования ботов:

• Интеграция с другими сервисами. Например, бот может отправлять комментарии или управлять «умным домом». Или, например, отправлять вам уведомления при совершении каком-то действия или события (Примеры: GitHub Bot, Image Bot).
• Утилиты и инструменты. Бот может отображать погоду, переводить тексты или предупреждать о предстоящих событиях по вашему запросу (Например: бот опросов).
• Одно- и многопользовательские игры. Бот может поиграть с вами в шашки или шахматы, проводить викторины и так далее. (Пример: Trivia bot).
• Социальные сервисы. Бот может находить вам собеседника, основываясь на ваших общих интересах и увлечениях. (Пример: HotOrBot).
• Все, что вам захочется. Бота можно запрограммировать для чего угодно. Разве что посуду они помыть не смогут.

Как работают боты?

Как уже было сказано ранее, роботы — особые аккаунты, которые не требуют номера телефона при создании. По сути, эти аккаунты играют роль интерфейса к вашему сервису, который работает на удалённом сервере.

Самое интересное в роботах это то, что для их создания вам не нужно изучать низкоуровневые методы работы с MTProto и шифрованием — общение с роботом организовано при помощи обычного HTTPS интерфейса с упрощёнными методами Telegram API. Мы назвали его Bot API.

Примечание

Рекомендуем также ознакомиться с подробным описанием Bot API.

Как создать бота?

Для этого есть. Бот. Просто напишите пользователю @BotFather и следуйте его инструкциям. Как только вы создали бота и получили свой ключ (токен) авторизации, переходите в раздел документации Bot API, чтобы начать настраивать вашего бота.

Чем бот отличается от обычного аккаунта?

• У роботов нет статусов «онлайн» и «был в сети», вместо этого отображается надпись «бот».
• Для ботов выделено ограниченное место на серверах — все сообщения будут удалены по прошествии определённого срока после обработки.
• Боты не могут сами начать общение с пользователем. Пользователь должен либо добавить робота в группу, либо первым начать с ним диалог. Для этого можно использовать ссылки вида t.me/ или поиск по имени пользователя.
• Имя пользователя у робота должно заканчиваться на «bot» (например, @controllerbot).
• При добавлении в конференцию, по умолчанию робот не получает всех сообщений (см. режим приватности).
• Роботы никогда не спят, не едят и не жалуются (если только вы не запрограммируете их на обратное).

Суперспособности

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

Инлайн-режим

Пользователи могут общаться с вашим ботом напрямую из поля ввода сообщения — из любого чата или группы. Для этого нужно всего лишь набрать имя пользователя вашего бота и запрос для поиска. Получив запрос, бот может возвратить какие-либо результаты. Как только пользователь нажмёт на один из них, он сразу же отправится в чат. Таким образом можно запрашивать контент от бота в чатах, группах или каналах.

Игры

С помощью ботов пользователи могут играть в HTML5-игры в группах или приватных чатах. Игровая платформа Telegram поможет составить таблицу рекордов и оповещать пользователей об изменении рейтинга.

Под капотом у игр — HTML5, поэтому вы можете создавать игры любой сложности. На данный момент командой Telegram созданы несколько демо-игр:

Клавиатуры

Одна из самых необычных возможностей Bot API — кастомизированные клавиатуры. При передаче сервером ответа есть возможность передать команду на отображение специальной клавиатуры с предустановленными вариантами ответа (см. ReplyKeyboardMarkup). Клиент Telegram, получив сообщение, отобразит пользователю вашу клавиатуру. Нажатие на клавишу сразу же отправит на сервер соответствующую команду. Таким образом можно значительно упростить взаимодействие робота с пользователем. На данный момент для отображения на клавише могут использоваться эмодзи и текст. Вот несколько примеров таких клавиатур:

За более подробной информацией обращайтесь к описанию метода sendMessage.

Команды

Команды представляют собой более гибкий способ общения с ботом. Рекомендуется следующий синтаксис:

/команда [необязательный] [аргумент]

Команда должна начинаться с символа косой черты «/» и не может быть длиннее 32 символов. Команды могут состоять из букв латинского алфавита, цифр и подчёркивания. Несколько примеров:

/get_messages_stats /set_timer 10min Alarm! /get_timezone London, UK

Сообщения, начинающиеся с косой черты, будут всегда доставляться боту (точно также, как и при ответе на его сообщения и на @упоминания бота в чате). Приложения Telegram будут:

• Предлагать список поддерживаемых команд с их описанием, когда пользователь введёт символ косой черты «/» (чтобы этот пункт работал, вам необходимо задать описание команд у @BotFather). Нажатие на описание приведёт к отправке этой команды.
• Показывать кнопку (/) в поле ввода текста во всех чатах с ботами. Нажатие на эту кнопку отобразит список доступных команд.
• Подсвечивать /команды в сообщениях. При нажатии на такую подсвеченную команду, она будет сразу же отправлена боту.

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

/start@TriviaBot /start@ApocalypseBot

Это происходит автоматически, если вы выбираете команду из списка доступных.

Глобальные команды

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

• /start — начинает общение с пользователем (например, отправляет приветственное сообщение). В эту команду также можно передавать дополнительные аргументы (см. внешнее связывание).
• /help — отображает сообщение с помощью по командам. Оно может представлять собой короткое сообщение о вашем боте и список доступных команд.
• /settings — (по возможности) возвращает список возможных настроек и команды для их изменения.

При попытке начать общение с роботом, пользователь увидит кнопку СТАРТ. На странице профиля бота также будут доступны ссылки Помощь и Настройки.

Режим приватности

Ботов часто добавляют в группы, чтобы получать различную информацию — новости, уведомления и т.д. Однако, при добавлении бота вы наверняка спрашивали себя: «А что если этот маленький засранец пересылает всю групповую переписку куда-то “налево”?» Именно поэтому у роботов есть режимы приватности.

Робот с включенным режимом приватности не будет получать всех сообщений, а только сообщения, удовлетворяющие этим условиям:

• Сообщения, начинающиеся с символа косой черты «/» (см. раздел Команды)
• Сообщения, содержащие @упоминание бота
• Ответы на сообщения бота
• Служебные сообщения (о добавлении пользователя, смены изображения группы и т.д.)

Это хорошо со всех сторон: во первых, некоторые люди будут спать спокойно (в своих шапочках из фольги), не опасаясь, что их будут прослушивать. Во-вторых, режим приватности избавляет разработчиков от необходимости обрабатывать сотни ненужных сообщений из групповых чатов.

Режим приватности включен по умолчанию во всех ботах. Он может быть выключен — тогда бот начнёт получать все сообщения, как и обычный пользователь. Всем участникам конференции виден текущий статус режима приватности в списке участников группы.

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

Внешнее связывание

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

У каждого робота есть ссылка, при помощи которой можно начать с ним диалог — https://t.me/ . К этой ссылке можно добавить параметры *start или startgroup со значением длиной до 64 символов. Пример:

https://t.me/triviabot?startgroup=test

Допустимо использование символов A-Z , a-z , 0-9 , _ и — . Мы рекомендуем использовать base64url для кодирования параметров.

Переход по ссылке с параметром start начнет чат с ботом, при этом в поле ввода текста будет отображаться кнопка СТАРТ. При переходе по ссылке с параметром startgroup пользователю будет предложено добавить бота в одну из доступных групп. Как только пользователь подтвердит своё действие (нажмёт на кнопку СТАРТ или выберет группу), бот получит сообщение следующего формата:

/start PAYLOAD

В PAYLOAD будет значение параметра start или startgroup , который был передан в ссылке.

Пример реализации внешнего связывания

Предположим, сайт example.com хочет отправлять пользователю уведомления с помощью Telegram-бота. Ниже приведено описание последовательности действий для реализации отправки уведомлений пользователю с ID 123 .

1. Создайте бота с любым именем, например, @ExampleComBot
2. Настройте вебхук для входящих сообщений
3. Сгенерируйте ключ достаточной длины, напр. $memcache_key = ‘TESTKEY’
4. Запишите значение 123 с ключом $memcache_key в Memcache на 3600 секунд (один час)
5. Отправьте пользователю ссылку https://t.me/ExampleComBot?start=TESTKEY
6. Настройте обработчик веб-хуков так, чтобы он запрашивал в Memcached значение входящего параметра каждый раз, когда приходит сообщение, начинающееся со /start . Если ключ существует, записываем chat_id, переданный в веб-хук, в telegram_chat_id для пользователя 123 . Удаляем ключ из Memcache.
7. Теперь, если мы хотим отправить сообщение пользователю 123 , сначала проверяем telegram_chat_id . Если оно существует, используем метод sendMessage, чтобы отправить пользователю сообщение.

BotFather

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

Создание бота

Напишите команду /newbot , чтобы создать нового робота. BotFather спросит у вас имя нового бота и предложит придумать username.

Имя (name) будет отображаться в контактах и чатах.

Username — короткое имя на латинице, которое используется для упоминаний бота и в ссылках на профиль в telegram.me. Username должен состоять из букв латинского алфавита, подчёркиваний и цифр и быть длиной от 5 до 32 символов. Также имя пользователя обязательно должно заканчиваться на «bot», например: «tetris_bot» или «TetrisBot».

Ключ (токен) это набор символов вида 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw , который нужен, чтобы получать и отправлять сообщения с помощью Bot API.

Создание токена

Если вы потеряли или утратили доступ к токену, отправьте команду /token , чтобы сгенерировать новый.

Настройки

• /setname — Изменить имя робота.
• /setdescription — Изменить описание робота, представляющее собой короткий текст с описанием бота. Пользователи увидят его в самом начале, под заголовком «Что умеет этот робот?».
• /setabouttext — Изменить информацию о боте, ещё более короткий текст, отображающийся в профиле бота. Ещё, если кто-то поделится вашим ботом, то вместе со ссылкой на него отправится этот текст.
• /setuserpic — Изменить аватарку бота. Картинки — всегда хорошо.
• /setcommands — Изменить список команд бота. Каждая команда состоит из собственно командного слова, начинающегося с символа косой черты («/») и короткого описания. Пользователи увидят список команд при вводе символа «/».
• /setjoingroups — Определяет, можно ли добавлять вашего бота в группы.
• /setprivacy — Определяет, все ли сообщения видит ваш бот в группах. В выключенном состоянии роботу будут отправляться все сообщения.
• /deletebot — Удалить бота и его имя пользователя.

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

Сайт про Telegram на русском (неофициальный).

Здесь собраны приложения на базе MTProto, переведена некоторая документация с официального сайта, а также работает Webogram.

Добавление бота в чат Телеграм

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

В статье расскажем, как добавить робота в чат Телеграм и как настроить его работу по определённому сценарию.

Видеозвонки в SberJazz
Общайтесь с друзьями и близкими везде, где есть Интернет
Попробовать сейчас

Как добавить в Телеграм

Для создания бота в Телеграме необходимо выполнить следующие шаги:

1. Через поиск найдите профиль BotFather или перейдите по ссылке https://telegram.me/BotFather.
2. Нажмите кнопку «Start» в чате.
3. Введите команду /newbot.
4. Укажите название — это то, как пользователи будут видеть его в списке контактов.
5. Укажите системное имя: это логин после знака @.

Системное имя должно быть уникальным, а название может повторяться с уже существующими.

Когда бот будет создан, вы увидите токен. Он нужен для интеграции со сценариями. Если вы забыли сохранить токен, просто напишите команду /token в диалог с BotFather.

Основа для чат-бота создана, и ему даже можно написать сообщение. Но чтобы он заработал, нужно создать для него сценарий. Сделать это можно через сервис SaluteBot.

Создайте своего чат-бота в Telegram
Простая настройка чат-бота в личном кабинете Цифровой витрины
Попробовать

Как настроить бота в личном кабинете Цифровой витрины

Чтобы создать свой собственный сценарий и привязать его к чат-боту, зарегистрируйтесь в личном кабинете Цифровой витрины и войдите в аккаунт. Мы будем использовать инструмент SaluteBot, который помогает создать сценарий в режиме карты. Навыки программирования не нужны, если нет интеграции со сторонними системами.

После этого зарегистрируйтесь в сервисе Jivo, который свяжет робота со сценарием. Для работы потребуется профессиональный аккаунт, первые 14 дней им можно пользоваться бесплатно. Подробнее как создать читайте в статье.

Далее порядок действий будет следующий:

1. Зайдите в личный кабинет Цифровой витрины и нажмите «Создать проект».
2. Выберите «Приложения» — SaluteBot.
3. Нажмите «Добавить аккаунт» и авторизуйтесь в Jivo.
4. Придумайте название проекта.
5. Выберите «Свой сценарий», это бесплатное создание сценария в режиме конструктора.
6. Далее вы попадёте в конструктор, где сможете собрать нужный сценарий.

Вот какие возможности есть в конструкторе:

• Отправка пользователю текста (приветствие, ответ на сообщение или на действие).
• Запрос данных — если нужно уточнить у клиента какую-то информацию, например, имя, телефон, номер заказа.
• Условие — сценарий должен гибко реагировать на действия клиента, поэтому при выборе того или иного пункта меню бот, в зависимости от настроенного условия, будет реагировать по-разному.
• Перевод диалога на оператора. Если бот не справляется с вопросом, он автоматически пригласит оператора в чат.
• Вызов скрипта — для продвинутых сценариев, где подразумевается обмен данными со сторонними системами.

Как добавить в группу

Самый частый сценарий для чат-ботов в группе — это онбординг для новых участников и модерация сообщений на предмет запрещённых тем с вынесением предупреждений.

Чтобы использовать телеграм-бот в группе, просто выберите его как нового участника: созданный нами робот — это обычный отдельный аккаунт в списке участников группы.

Вот что нужно сделать:

1. Перейдите в настройки группы в Телеграме.
2. Нажмите на кнопку «Добавить участников».
3. Найдите бот по системному имени через @имя.
4. Нажмите на него, а затем — «ОК», чтобы добавить его к телеграм-чату.

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

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

Как добавить в канал

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

1. Зайдите в телеграм-канал, нажмите на три точки и выберите «Управление каналом».
2. Перейдите в раздел «Администраторы».
3. В поиске найдите бот по системному имени через @имя.
4. Добавьте его в качестве администратора и укажите, какие разрешения у него должны быть. Если не выдать нужное разрешение, то некоторые функции могут не работать.

В канал можно добавить собственный бот или выбрать уже существующий.

Для личных чатов

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

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

А ещё работа с ботом напрямую позволяет протестировать его перед использованием в группе или канале — так можно проверить, что все функции работают, как ожидалось.