Подключение и настройка Telegram

Как создать нового бота

Создание и настройка ботов в Telegram происходит с помощью официального бота BotFather.

1. Откройте в Telegram бота @BotFather.

2. Отправьте ему команду /newbot.

3. Задайте имя для вашего нового бота. Имя будет отображаться в контактах и чатах.

4. Придумайте username и отправьте его.

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

5. Чтобы бот заработал, его нужно подключить к конструктору. Вернитесь в Botmother, перейдите в раздел Настройки, активируйте платформу Telegram переключателем, нажмите кнопку Изменить и вставьте токен в поле. Затем нажмите кнопку Сохранить в правом нижнем углу.

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

Защитить контент во всем боте не даст пересылать или сохранять контент сразу из всех следующих компонентов: Видео, Сообщение, Изображение, Галерея, Медиафайлы, Платные медиафайлы, Динамические кнопки, Документ, Аудио, Кнопки. Для отдельных компонентов защиту можно снять в настройках компонента с помощью чекбокса «Снять защиту контента».

Не показывать ошибку при получении больших файлов — пользователь не получит уведомление об ошибке, если пришлет файл превышающий по размеру 20 МБ или 50 МБ в зависимости от способа отправки файла.

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

Текст ошибки при превышении размера лимитов файла — текст который придет пользователю, если он пришлет файл размер которого превышает 20 МБ или 50 МБ в зависимости от способа отправки файла.

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

Как изменить имя бота

1. Откройте в Telegram бота @BotFather и отправьте ему команду /setname.

2. Выберите бота, имя которого вы хотите изменить.

3. Введите новое имя вашего бота и отправьте его.

Как добавить описание бота

Описание бота — это короткий текст, который пользователи увидят еще не написав боту, под заголовком «Что умеет этот робот?».

1. Откройте в Telegram бота @BotFather и отправьте ему команду /setdescription.

2. Выберите бота, описание которого вы хотите изменить.

3. Введите новое описание вашего бота (максимум 512 символов) и отправьте его.

Как указать информацию о боте

Информация о боте — это ещё более короткий текст, отображающийся в профиле бота. Ещё, если кто-то поделится вашим ботом, то вместе со ссылкой на него отправится этот текст.

1. Откройте в Telegram бота @BotFather и отправьте ему команду /setabouttext.

2. Выберите бота, информацию о котором вы хотите изменить.

3. Введите новую информацию о вашем боте (максимум 120 символов) и отправьте ее.

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

1. Откройте в Telegram бота @BotFather и отправьте ему команду /setuserpic.

2. Выберите бота, аватарку которого вы хотите изменить.

3. Отправьте боту фото как картинку. Если отправите как файл, @BotFather пришлет ошибку.

Как сделать меню в Telegram

Если вы хотите сделать меню бота для Telegram, вам нужно настроить его через бота @BotFather.

1. Откройте в Telegram бота @BotFather и отправьте ему команду /setcommands.

2. Выберите бота, для которого делаете меню.

3. Отправьте боту команды в виде:

command1 - Команда1

command2 - Команда2

Где command — название команды латиницей (максимум 32 символа), Команда — название команды в конструкторе.

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

4. Перейдите к своему боту в Telegram и наберите, не отправляя, «/».

Как добавить картинку в описание бота

Картинка в описании бота — это фотография или гифка, которую пользователи увидят еще не написав боту, под заголовком «Что может делать этот бот?».

1. Откройте в Telegram бота @BotFather , командой /mybots выберите бота, которому хотите добавить картинку в описание.

2. Нажмите Edit Bot, затем Edit Description Picture.

3. Отправьте боту картинку (размером 640x360 пикселей) или гифку (размером 320x180 пикселей). Команда /empty удалит текущее изображение.

Как добавить web app в меню бота

Web app в меню бота используется для быстрого перехода на страничку web app в любом месте бота, независимо от его сценария.

1. Откройте в Telegram бота @BotFather, командой /mybots выберите бота, которому хотите добавить web app в главное меню.

2. Нажмите Bot Settings, затем Menu Button и Configure menu button.

3. Отправьте боту URL, который будет открываться при нажатии на кнопку меню. Команда /empty удалит web app из меню.

4. Отправьте боту заголовок, который будет отображаться на кнопке. Команда /empty удалит заголовок.

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

Например, для сервиса Сhatra ссылка будет примерно такой:

https://chat.chatra.io/?isModern=true#hostId=12345&mode=widget&langOverride=ru&lang=ru

Такой метод поможет и с виджетами других аналогичных сервисов.

Как cделать ссылку «‎Поделиться с контактами‎»

Ссылку «‎Поделиться с контактами‎» в Телеграм можно сделать так:

https://telegram.me/share/url?url=ссылка&text=описание

Где ссылка — ссылка на вашего бота.

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

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

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

Как добавить к сообщению от бота анимированный эффект

Анимированные эффекты поддерживаются в следующих компонентах:

Для того чтобы добавить анимированый эффект, выберите его из выпадающего списка в поле Уникальный идентификатор эффекта сообщения.

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

Список ID для анимированных эффектов:

  • 🔥: 5104841245755180586
  • 👍️: 5107584321108051014
  • 👎️: 5104858069142078462
  • ❤️: 5159385139981059251
  • 🎉: 5046509860389126442
  • 💩: 5046589136895476101

В начало ↑