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

Бот — это собеседник в телеграм, который отвечает по определенным алгоритмам вам в телеграм.

Вы пишете ему «привет», он обрабатывает эту команду по своим внутренним алгоритмам и выдает ответ в виде сообщения, картинки, документа и т.д.

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

Для бизнеса боты можно применять следующим образом:

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

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

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

ЧАТ-БОТ в Телеграм для дублирования контента. Создаём сами — быстро, просто и легко.

Наш случай — это создание бота с управлением через процедуру SQL (на базе платформы Falcon Space). Т.е. процедура SQL определяет как обработать команды и что выдать человеку.

Как настроить бота Telegram на базе Falcon Space

Создаем Бота в Telegram на базе веб-платформы Falcon Space.

Falcon Space — это платформа для создания веб-решений с управлением через SQL. Все создается и управляется на SQL. Телеграм бот управляется полностью 1 хранимой процедурой на SQL!

На основе Falcon Space вы можете создать систему личных кабинетов на сайте со встроенным телеграм ботом.

1. Находим бота BotFather -> команда /newbot -> даем ему описание, имя (заканчивается на Bot) и картинку . В итоге получаем token

2. В web.config / AppSettings настраиваем следующие параметры:

1. proxyUrl — указываем прокси для Телеграма в таком виде http://45.89.19.84:11498 (если прокси не нужен, то просто оставляем пустыми поля)
2. proxyUser, proxyPassword — указываем пользователя и пароль прокси.
3. telegramToken — указываем токен, который мы получили при создании бота в Телеграм (в botFather).
4. telegramOnlyTextMessages — если 1, то в обработку бота будут попадать только текстовые сообщения.

3. В таблице as_users добавляем 2 поля:

IF COL_LENGTH( ‘as_users’, ‘telegram’) IS NULL BEGIN ALTER TABLE as_users ADD telegram nvarchar ( 128 ) NULL END IF COL_LENGTH( ‘as_users’, ‘telegramChatID’) IS NULL BEGIN ALTER TABLE as_users ADD telegramChatID int NULL END

4. Создаем хранимую процедуру такого вида (в разделе Системный SQL / Telegram Bot):

• SELECT 1 — Result и Msg
• SELECT 2 — набор команд для telegram (актуально если SELECT1.Result=1). Type, Text, ChatID, replyMessageID, DisableNotification, Channel, ButtonsJSON, parseMode

• SELECT 3 — внешние действия, которые могут быть вызваны по команде от телеграм бота.

5. Проверяем, что работает бот. Подписываемся на него в telegram и выполняем /start (при этом мы получим отклик Привет. ). Если нет отклика, значит бот не запущен. Попробуйте его перезапустить в разделе Системный SQL (Старт телеграм бот).

6. Чтобы подписать пользователя на некие действия, необходимо сначала чтобы он указал свой телеграм в профиле (поле as_users.telegram). Затем он должен сделать любую команду в телеграме, отправив боту к примеру /start

Хранение привязки чата к пользователю системы

В as_users есть 2 поля: telegram и telegramChatID. При первом обращении, система через хранимую процедуру обновит поле telegramChatID для соответствующего пользователя с заданным telegram. После этого он сможет получать сообщения от telegram.

1. Для прокси можно использовать IPv4 и IPv6
2. Прокси можно купить здесь — https://proxy.market/
3. В as_users добавлены 2 поля telegram и telegramChatID, а также добавлена хранимая процедура [as_user_getUser] (проверьте, что они есть в вашей базе).
4. Чтобы работало внешнее действие типа telegram в системе должна быть хранимая процедура as_user_getUser

Использование бота

• В телеграм находим бота (например, наш бот FalconSpaceBot)
• Пишем ему /start для инициализации (осуществляется привязка вашего пользователя к чату).
• Выполняем различные команды, например /getupdates — если команда прописана в чате, то она будет обработана и выдан ответ.

Включение/выключение бота

Бот включается при запуске всего веб приложения (Global.asax/app_start).

Чтобы его выключить вручную, можно из-под админа использовать команду (перейти на URL) /Controls/Stuff/StopTelegramBot

Для включения — /Controls/Stuff/StartTelegramBot

Детали реализации бота

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

• Для перевода строки в сообщении бота используйте Char(10);

Howto по Telegram боту

Не работает бот Telegram. Что делать?

1. Проверьте что прокси прописан в web.config
2. Проверьте что прокси не просрочен
3. Проверьте что бот в целом отвечает на ваши команды в телеграм (если не отвечает)
4. Попробуйте запустить заново бота /Controls/Stuff/StartTelegramBot (либо перезапустите пул приложения в IIS)
5. Проверьте as_trace (коды TG и Exception). В нем пишутся ошибки и инициализация и завершение потока бота.
6. Сделать as_print в процедуре и посмотреть попадает ли туда бот.
7. Бот может остановиться если у вас запущена локальная отладка (в этом случае возникает конфликт обновлений, поэтому необходимо отключать бота при локальном запуске — в web.config убирать токен).
8. Бот может падать, если выключается автоматически пул IIS. Необходимо его настроить так, чтобы он не отключался при простое.
9. Если ничего не помогает, перезагрузите пул, сайт в IIS. Проверьте, что пингуется сервера API сервис Телеграма api.telegram.org .

Как отправить сообщение пользователю в Телеграм

Для этого используем Внешнее действие (в формах и других элементах) с кодом telegram.

select ‘telegram’ type, ‘admin’ [to], ‘Некий текст сообщения’ [text], » buttonsJSON, » parseMode

Также сообщение можно отправлять через уведомления (если включено Немедленное уведомление).

buttonsJSON задает настройки кнопок.

parseMode задает формат обработки сообщений (по умолчанию html. Возможные значения html, default, markdown, markdownv2).

ВАЖНО! Необходима реализация процедуры tg_getChatID:

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

Для этого используем символ «-» и chatID в параметре to

select ‘telegram’ type, ‘text 1’ text, ‘-340984421’ [to]

Передается chatID. Для групп это отрицательное число, которое можно получить либо экспортом сообщений группы в JSON (и там можно будет найти chat_id), либо через запрос вида:

https://api.telegram.org/bot11111111:22222222/getUpdates

Примечание: бот необязательно должен быть администратором группы.

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

Для этого используем символ «#» и chatID в параметре to

select ‘telegram’ type, ‘text 1’ text, ‘-340984421’ [to]

Как отправить сообщение в канал Телеграм

Для этого используем Внешнее действие (в формах и других элементах) с кодом telegram.

select ‘telegram’ type, » [to], ‘falconspace’ channel, ‘Некий текст сообщения’ [text]

Бот должен быть добавлен администратором в канал при этом.

ВАЖНО! Необходима реализация процедуры tg_getChatID

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

Указываем всех пользователей в SELECT 2 + связываем с настройками показа данного сообщения (т.е. показываем тем, кто разрешил отправку на этот тип уведомлений. Поля настроек могут меняться). Пример:

Как работать с кнопками Телеграм

Кнопки могут быть либо Inline (в чате при ответе), либо Reply(внизу под чатом).

Кнопки передаются в виде JSON в параметре SELECT 2 ButtonsJSON:

SELECT ‘ < «oneTimeKeyboard»: true, «resizeKeyboard»: true, «inlineButtons»: [ [ , , ], [ , , ] ], «replyButtons»: [ [ , , ], [ , , ] ] > ‘ ButtonsJSON

Для Inline кнопок указываем:

• Text — название кнопки.
• CallbackData — данные для передачи в процедуру
• Url — если указан, то кнопка будет открывать указанный адрес. ВАЖНО! Вводите корректный URL, иначе будет исключение и вся исходная команда не будет работать.

Для reply кнопок команда используется в поле text. Также для них есть 2 настройки:

• ResizeKeyboard — Requests clients to resize the keyboard.
• OneTimeKeyboard — Requests clients to hide the keyboard as soon as it’s been used.

В процедуру для онлайн кнопок будет передаваться как команда поле callbackData, а для reply кнопок — поле text.

Дополнительная информация о кнопках Телеграм:

Использование Эмоджи в сообщениях

Выбираем символ, на страницу символа берем его код UTF16 LE

В SQL используем этот код следующим образом:

CAST(0x3DD801DE AS NVARCHAR(MAX))

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

Указываем в начале процедуры action следующий код

В итоге бот ничего не будет отвечать клиенту.

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

Как выводить html теги в сообщениях

Для этого используется параметр paseMode=’html’ (это значение используется по умолчанию).

Есть альтернативные способы разметки — default, markdown, markdownv2.

ВАЖНО. В html режиме отправка сообщения в телеграм поддерживает только эти теги b, strong, i, em, u, ins, s, strike, a, code, pre. Если будут запрещенные теги, то сообщение не отправится. Детали — https://core.telegram.org/bots/api#html-style

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

Для этого даем ему ссылку вида: https://t.me/FalconSpaceBot?start=1, где FalconSpaceBot — это имя вашего бота.

Пользователь переходит на бота и нажимает там кнопку Запустить. При этом ваша команда /start должна учитывать что в этом случае придет она как /start 1

Т.е. используем left () для определения команды start, а не точное соответствие.

Логирование команд боту от пользователей

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

Многоступенчатые команды в боте

Для этого используются следующие поля в tg_settings:

1. currentCommand — текущая рабочая команда (в рамках которой пользователь вводит данные).
2. currentCommandStep — текущий шаг в команде (для определения какой текст вывести в рамках команды).
3. currentCommandData — здесь накапливаются данные по выполнению команды.

Пример кода такой команды:

В примере указан полный код процедуры бота с обработкой start, меню и бизнес-логикой ступенчатой команды. Также в коде есть пример как использовать Эмоджи в боте.

Ошибки при работе с ботом

Ошибка Error converting data type bigint to int. | command /start

В этом случае необходимо изменить тип данных для этих полей с int на bigint: tg_settings.chatID и as_users.telegramChatID

ALTER TABLE as_users ALTER COLUMN telegramChatID bigint NULL ALTER TABLE tg_settings ALTER COLUMN chatID bigint NULL

Не работают inline кнопки

Если они не отображаются, то проверьте, что не указаны reply кнопки (они вместе с inline кнопками не используются) и режим в команде IsReplyButtons=0

Если используются URL, то проверьте что указан корректный URL для кнопок.

Если кнопки есть, но при клике не реагируют, то проверьте, что в appsettings (в MVC версии — в web.config) установлен параметр telegramOnlyTextMessages = 0:

Falcon Space — функциональная веб-платформа разработки на узком стеке MS SQL/Bootstrap. Вводная по Falcon Space

Google поиск по нашей документации

• Руководства
• Основа Falcon Space
• Основные компоненты
• Возможности
• Коммуникация с пользователемНастройка уведомлений для личного кабинета на сайтеHOWTO. Как настроить чат помощи для пользователейВнедрение чата в личный кабинет пользователяРабота с комментариями к объектамТелеграм боты и отправка сообщений в Telegram в веб-платформе Falcon SpaceКак создать чат бот ВКонтакте. VK бот для обработки сообщений в группе.Как сделать push уведомлениеКак отправить Email, SMS или уведомление пользователюКак отправлять SMS с сайта через smsc.ruОтправка email с шаблоном письмаКак сделать ежедневную отправку отчета по проекту в групповой чат Telegram?Настройки почты для отправки сообщений с сайтаВидеочат. Интеграция с Vox ImplantБазовая интеграция с Jitsi Meet (звонки с видео)Отправка СМС через targetsms.ruКак сделать механизм отправки различных писем по шаблону с возможностью редактирования перед отправкой
• Дизайн, стилизация
• Лендинги
• Универсальный API
• Примеры интеграций
• Каталоги
• Навигация
• Документы
• Дополнительные компоненты
• Продвижение, SEO
• Системные моменты
• Системное администрирование
• HOWTO
• Таблицы
• Формы
• Загрузка файлов, картинок
• Работа с SQL
• HOWTO JS
• HOWTO Верстка
• Решение проблем

Источник: falconspace.ru

Как быстро и легко создать и настроить Telegram бота

Чтобы не терзать вас в неведении о моих успехах за 3 месяца работы, вот:

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

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

Процесс создания бота занимает не более одной минуты.

Бот создан, но его необходимо оформить и настроить.

Тут тоже все просто. Для этого необходимо 4 команды:

• /setuserpic — чтобы изменить аватарку бота;
• /setdescription — чтобы изменить текст, который пользователи видят перед тем как нажать на Start;
• /setabouttext — чтобы изменить текст внутри профиля бота;
• /setname — чтобы изменить имя бота;

Если все же возникли трудности то вотвидеоурок

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

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

Еще их можно вызвать через “слэш”.

1. Нажимаем в меню вашего бота на команду “Пользовательские команды”
2. Выбираем раздел “Создать команду”
3. Отправляем название команды, например “/photo” или “/sites”
4. Отправляем текст или/и фотографию (команду всегда можно изменить и удалить) и нажимаем сохранить. Или выбираем один из пунктов:

«Добавить вопрос” — иначе говоря форма. Форма — это команда, внутри которой есть вопросы.
Когда пользователь вызывает такую команду, то ему задаются вопросы по порядку, а ответы отправляются обратно администраторам.
Зачем нужны формы?
Формы расширяют возможности вашего бота, позволяя:

• 1) Cобирать обратную связь
• 2) Получать контент от пользователей
• 3) Принимать заказы

Подключается командой “/autoposting” в вашем боте. Она позволяет автоматически копировать посты с VK, YouTube, Twitter и RSS ленты.

P.S. Для продвижения бота использовал стикер пак

Источник: mipped.com

Пишем бота telegram на C#

Как я и обещал — пишу вторую статью по созданию ботов к известному мессенджеру telegram. В этот раз речь пойдет о языке C# и о создании полноценного бота на нем. И так, начнем, пожалуй.

Шаг первый. Создаем оформление бота через Botfather

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

BotFather — это такой бот(официальный), через которого регистрируют все остальные боты. Без него нам никак не обойтись, поэтому давайте откроем telegram и перейдем по ссылке — BotFather

Там все крайне просто, вбиваем /help и смотрим на список доступных команд:

Собственно сейчас нас интересует команда /newbot, пишем ее и создаем бота указывая его название. В данном случае я назову своего бота — Рев.ком.стих и будет он у нас выдавать стихи о Маяковского и Есенина (когда я его доделаю, однако весь процесс в эту статью я включать не буду).

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

Далее можно задать оформление для бота. Например картинку — логотип. Для этого используем команду /setuserpic после чего загружаем картинку. Так-же задаются описание бота и прочие вещи до которых вы допрете и без моего участия.

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

Теперь надо сделать боту доступ к сообщениям пользователей, то есть выключить нахер приватный режим. Если мы планируем добавлять бота в группы или конфы, назовите как хотите, в любом случае приватность нам нахер не нужна. Чтобы ее выключить вбиваем команду /setprivacy после чего выбираем пункт — disabled. Обязательно выполните этот шаг, если вы хотите сделать действительно интерактивного бота.

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

Шаг второй. Среда разрабтки

В случае с c# мы будем использовать кроссплатформенную и совершенно бесплатную ide — SharpDevelop в которую уже предустановлены все необходимые для нас плагины такие как nuget package manager. Это во первых экономит мне время, во вторых ресурсы. Тяжелая visual studio тащит за собой кучу уже давно неакутальных и ненужных вещей, да к тому-же платная. Выглядит она конечно приятнее, но для меня такие мелочи не самое главное, мне главное — результат (это нифига не мелочи, Visual Studio 2017 стоит 37 000 рублей).

Короче если у вас не стоит — установите, она весит не много. К тому-же проекты написанные в ней целиком совместимы с visual studio, то есть написанное можно будет потом перенести и туда тоже.

И выбираем тип, так как писать мы будем на C# то выбор очевиден:

И вот среда для разработки у нас готова:

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

Шаг третий. Установка компонент

В качестве обертки для работы с API мы будем использовать пакет под названием telegram.bot, его мы и будем устанавливать в наш проект. Идем в Project->Manage Packages

Перед нами появится менджер пакетов, который сам найдет нужный нам пакет из интернета, скачает его и установит в ваше приложение для использования. Ищем там наш компонент и тыкаем «Add»:

И вот наш пакет добавился, его видно в solution explorer’е

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

Шаг третий. Написание кода

Собственно для начала сделаем простейший интерфейс. Переключаемся на вкладку MainForm -> Design, после чего кидаем на форму одну кнопку и одно текстовое поле.

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

Для начала стоит вспомнить о главном преимуществе C# — асинхронности. Я буду писать код в двух потоках и в качестве второго потока буду использовать класс BackgroundWorker. Просто создаем переменную этого класса и среда сама предложит нам установить необходимые зависимости.

Да, это еще одна вещ за которую я просто обожаю C#. Мне достаточно знать имя класса, а где он находится система знает и без меня.

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

BackgroundWorker bw; public MainForm() < // // The InitializeComponent() call is required for Windows Forms designer support. // InitializeComponent(); // // TODO: Add constructor code after the InitializeComponent() call. // this.bw = new BackgroundWorker(); this.bw.DoWork += this.bw_DoWork; // метод bw_DoWork будет работать асинхронно >void bw_DoWork(object sender, DoWorkEventArgs e) < var worker = sender as BackgroundWorker; // получаем ссылку на класс вызвавший событие >void BtnRunClick(object sender, EventArgs e) // обработка клика кнопки < if (this.bw.IsBusy != true) // если не запущен < this.bw.RunWorkerAsync(); // запускаем >>

вот примерно так и должно быть у вас в начале. Теперь нам надо передать токен из текстового поля формы в обработчик воркера и там использовать. Звучит конечно писец как сложно но делается очень просто:

void bw_DoWork(object sender, DoWorkEventArgs e) < var worker = sender as BackgroundWorker; var key = e.Argument as String; // получаем ключ из аргументов >void BtnRunClick(object sender, EventArgs e) < var text = txtKey.Text; // получаем содержимое текстового поля txtKey в переменную text if (text this.bw.IsBusy != true) < this.bw.RunWorkerAsync(text); // передаем эту переменную в виде аргумента методу bw_DoWork >> >

Вообще тот кто кодил на C# по больше моего конечно смог бы реализовать это все элегантнее, наверное, но я не из таких. К тому-же далеко не всем известны примочки многопоточности встроенные в этот язык. Там еще есть классы Thread и ThreadPool, а еще полу-асинхронные async и await.

Теперь настало время получения данных из бота. То есть время работы с API телеграма. Собственно инициализация API выглядит так:

var Bot = new Telegram.Bot.Api(key);

Так как мы не используем WebHook то … будем получать обновления бота «вручную», я не знаю как это можно более корректно назвать. Короче раз в секунду телеграм предоставляет ботам информацию о всех сообщениях, которые за это время поступили в бота. Эту информацию можно получать автоматически на https домен, так мы делали на php, а можно получать в бесконечном цикле внутри потока, что мы сейчас и собираемся сделать. Поток у нас есть, осталось сделать цикл и получать обновления. Собственно последнее выполняется вызовом Bot.GetUpdatesAsync(offset) который возврщает массив обновлений начиная с отступа «offset».

async void bw_DoWork(object sender, DoWorkEventArgs e) < var worker = sender as BackgroundWorker; var key = e.Argument as String; // получаем ключ из аргументов try < var Bot = new Telegram.Bot.TelegramBotClient(key); // инициализируем API await Bot.SetWebhookAsync(«»); //Bot.SetWebhook(«»); // Обязательно! убираем старую привязку к вебхуку для бота int offset = 0; // отступ по сообщениям while (true) < var updates = await Bot.GetUpdatesAsync(offset); // получаем массив обновлений foreach(var update in updates) // Перебираем все обновления < Console.WriteLine(update.Type); offset = update.Id + 1; >> > catch (Telegram.Bot.Exceptions.ApiRequestException ex) < Console.WriteLine(ex.Message); // если ключ не подошел — пишем об этом в консоль отладки >>

И так, в цикле мы перебираем обновления, теперь надо взять обновления нужного нам типа, получить их содержимое и обработать. В данном случае давайте обработаем команду «/saysomething», для этого нам надо отловить обновление типа текстовое сообщение и если текст этого сообщения совпадает с «/saysomething» значит выдать в ответ в тот-же чат строчку «тест».

foreach(var update in updates) // Перебираем все обновления < var message = update.Message; if (message.Type == Telegram.Bot.Types.Enums.MessageType.TextMessage) < if (message.Text == «/saysomething») < // в ответ на команду /saysomething выводим сообщение await Bot.SendTextMessage(message.Chat.Id, «тест», replyToMessageId: message.MessageId); >> offset = update.Id + 1; >

Запустим теперь наше приложение, вставим токен и нажмем кнопку «поехали».

Отлично, а теперь в телеграм-боте вобьем нашу команду и посмотрим придет ли ответ:

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

Отправка картинок

Чтобы отправить картинку надо отправить ссылку на нее самому telegram’у, он сам все загрузит и сделает за нас. Заставим нашего бота по команде «/getimage» отсылать нам вот эту картинку.

if (message.Text == «/getimage») < // в ответ на команду /getimage выводим картинку await Bot.SendPhotoAsync(message.Chat.Id, «http://aftamat4ik.ru/wp-content/uploads/2017/03/photo_2016-12-13_23-21-07.jpg»,»Revolution!»); >

Запускаем, тыкаем кнопочку и тестируем:

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

Задаем список команд

Как это сделать я уже писал и не вижу ни малейшего смысла писать это снова. Просто прочитайте тут.

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

То-же самое можно написать и на nodejs, к примеру.

Надеюсь эта статья поможет вам.

Скачать исходники

Без исходников все мои слова были бы бесполезны. Как говорится можно десять раз прочитать и не понять, а можно один раз посмотреть код и все понять. Да, к стати, проект открывается в visual studio, я проверял.

Бот для Telegram на C#

Источник: pozi.pro