Боцман: Телеграм бот на 1С за 10 минут

15.12.22

Интеграция - Мессенджеры и боты

Краткая инструкция как быстро создать Телеграм бота с использованием расширения конфигурации Боцман.

Скачать файл

ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.

Наименование По подписке [?] Купить один файл
Боцман: Телеграм бот на 1С за 10 минут:
.zip 89,75Kb ver:2022120701
12
12 Скачать (5 SM) Купить за 3 050 руб.

Вся лирика и документация в следующей статье, а пока:

Быстрый старт

Системные требования:

  • Любая конфигурация с БСП (используется механизм дополнительных отчетов и обработок);
  • Возможность публикации HTTP-сервиса; (upd: не требуется в новых версиях)
  • Прямые руки v.1.0 и выше

Как начать:

  1. Создать нового бота Телеграм через бота BotFather и получить токен;
  2. Скачать расширение Боцман и подключить его к конфигурации;
  3. Опубликовать http-сервис с корневым URL "tgbot";
  4. Создать внешнюю обработку, реализующую экспортную функцию модуля Обработать(Сессия, Данные);
  5. Добавить обработку в справочник "Дополнительные отчеты и обработки";
  6. Перейти в настройку ботов и указать адрес публикации ИБ;
  7. Добавить элемент в справочник "Боты Телеграм", указав в качестве обработки вашу обработку, а в качестве токена - токен вашего бота и установить вебхук (кнопка с колокольчиком в элементе справочника);
  8. Наслаждаться.

Основные сложности

Создание бота в Телеграм

Если вы никогда не создавали ботов в телегам - этот абзац для вас. Для создания ботов в Телеграм используется бот BotFather. Найдите его в вашем Телеграм и отправьте команду /newbot. Вам будет предложено ввести название вашего бота (это то, как он будет виден в списке чатов пользователей) и имя пользователя - уникальное имя в Телеграм, заканчивающееся на bot. Например ExampleBot или example_bot. Для наглядного примера я использовал имя echo_1c_bot:

Создание внешней обработки

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

Функция СведенияОВнешнейОбработке() Экспорт
	
	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("1.0.0.1");
	ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительнаяОбработка();
	ПараметрыРегистрации.БезопасныйРежим = Ложь;
	Возврат ПараметрыРегистрации;

КонецФункции        

       
Для того, чтобы ваша обработка могла работать как обработка для бота Телеграм, она должна содержать функцию Обработать(Сессия, Данные). Пример:

Функция Обработать(Сессия, Данные) Экспорт
	Боцман.ОтправитьСообщение(Сессия, Боцман.Получить(Данные, "message.text"));
	Возврат Истина;
КонецФункции

Эта функция просто отправит полученный текст обратно пользователю. Итого, минимальный модуль обработки должен выглядеть так:

Добавление вашего бота в конфигурацию

Перед добавлением бота задайте адрес публикации ИБ. Это путь публикации именно самой базы без "hs" и корневого URL. Например у меня это https://web1c.losthost.online/telegram/. После этого нажмите кнопку "Создать":

Откроется форма добавления бота, где нужно будет обязательно задать Наименование вашего бота, токен, полученный при создании бота на шаге 1 и выбрать вашу обработку из справочника Внешние отчеты и обработки. После этого можно нажать кнопку "Установить вебхук":

Всё. Ваш бот готов и функционирует.

Заключение

Коллеги, если есть интерес к этой разработке - выложу более подробную документацию с описанием всех экспортируемых функций и примерами ботов. Описанный в статье бот доступен и работает: @echo_1c_bot. Также вы можете попробовать @BarcodeMasterBot, созданный тоже с помощью расширения Боцман.

 

Обновление от 07.12.2022

В файле последняя версия расширения и пример эхо-бота. Файл тот же, что и в расширенной статье: Подробнее о создании ботов Телеграм с помощью расширения Боцман

Боты Расширение Телеграм Интеграция

См. также

SALE! 25%

Мобильная разработка Мессенджеры и боты Платформа 1С v8.3 1С:Конвертация данных Платные (руб)

Теперь создать telegram-бота - элементарно. Достаточно просто нарисовать блок-схему телеграм-бота, и он сразу заработает. Это возможно при использовании Графического конструктора телеграм-ботов. Это единственный конструктор ботов для telegram, чье качество и функционал подтверждены фирмой 1С, есть сертификат 1С:Совместимо. Расширение в интерактивном режиме, с помощью блок-схем, позволяет с минимальными трудозатратами создать телеграм-ботов в любой конфигурации, работающей на платформе «1С:Предприятие 8.3».

13200 9900 руб.

27.12.2021    37808    106    161    

199

Мессенджеры и боты Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Платные (руб)

Интеграция мессенджера WhatsApp и 1С: УНФ, УТ, КА, ERP - отправка и получение сообщений, картинок, файлов и видео прямо в 1С. Расширение работает с сервисом GreenApi.

15600 руб.

23.06.2023    9135    55    11    

32

Мессенджеры и боты Системный администратор Программист Бизнес-аналитик Пользователь Руководитель проекта Платформа 1С v8.3 Платные (руб)

Развитие популярного решения для интеграции мессенджера Telegram с нашей любимой 1С - конструктор чат-ботов в Телеграм.

15000 руб.

18.06.2021    65169    310    272    

367

Документооборот и делопроизводство (СЭД) Мессенджеры и боты Учет документов Платформа 1С v8.3 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 Платные (руб)

Расширение для согласования справочников и документов в основных типовых конфигурациях. Ролевая адресация, условная маршрутизация, чат-бот telegram, интеграция с n8n, последовательное и параллельное согласование, уведомление о новых задачах на почту, блокировка объектов в зависимости от статуса, запрет проведения в зависимости от статуса, автозапуск процессов согласования, отчеты по исполнительской дисциплине. Не требуется снятие конфигурации с поддержки. Настройка без программирования. Версия для 1cfresh.com. Сертификат 1С-Совместимо.

14900 руб.

15.11.2018    30128    36    49    

71

Мессенджеры и боты Пользователь Платформа 1С v8.3 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 Управленческий учет Платные (руб)

Данное расширение представляет собой интерфейс взаимодействия 1С с сервисом Wazzup. Данный сервис позволяет вести беседу с использованием номера телефона, привязанного к Whatsapp. Почитать о сервисе и его условиях использования можно по ссылке https://wazzup24.com/. На данный момент расширение поддерживает почти все доступные через API функции. Обновление от 19.05.2023, версия 2.1!

14400 руб.

30.11.2020    13500    8    13    

15

Мессенджеры и боты SMS рассылки Платформа 1С v8.3 1С:Управление нашей фирмой 3.0 Россия Платные (руб)

Решение реализовано в виде расширения. Заменяет отправку смс на отправку в WhatsApp через Green-api. Отправка чека картинкой.

7800 руб.

15.05.2024    1487    3    6    

6

Мессенджеры и боты Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Россия Управленческий учет Платные (руб)

Универсальная система сообщений для конфигураций 1С: Предприятие 8.3. Позволяет пользователям обмениваться текстовой информацией и ссылками на объекты (документы, справочники и др.). Система универсальна, подойдет для любой организации. Реализовано на управляемых формах (тонкий клиент) по технологии расширений 1С. Конфигурация останется на поддержке (для автоматического обновления).

4800 руб.

29.03.2021    16927    3    10    

8
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. rolin555 52 30.08.21 11:18 Сейчас в теме
Вебхук заработает? А про сертификат для SSL где описано
2. DrWeb3 74 30.08.21 11:24 Сейчас в теме
(1) Вебхук заработает. Про сертификат для SSL не подумал. У меня везде стоят бесплатные сертификаты Let's Encrypt, но вопрос хороший. Телеграм позволяет работать с самоподписанными сертификатами, так что добавлю поле сертификата в настройки бота. Спасибо!
3. ValeriVP 1333 16.12.21 03:07 Сейчас в теме
как работает без вебхука? не нашел
Оставьте свое сообщение