Подробнее о создании ботов Телеграм с помощью расширения Боцман

07.12.22

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

Интеграция программного комплекса 1С с популярным мессенджером Телеграм. Расширение Боцман. Подробное описание настроек и функций.

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

Наименование Файл Версия Размер
Расширение Боцман и пример бота
.zip 89,75Kb
19
.zip 2022120701 89,75Kb 19 Скачать
update: Информацию о последних обновлениях смотрите в конце статьи.

Немного лирики

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

До этого я долгое время занимался разработкой чат-ботов на php, но поскольку на 1С сижу тоже достаточно плотно - возникла идея, почему бы не написать небольшое расширение для интеграции 1С с популярным, а нынче даже разрешенным и всячески поощряемым к использованию мессенджером Телеграм.

В прошлой статье я рассказал о том, как создать простого бота Телеграм с помощью расширения Боцман буквально за 10 минут. Настало время подробно описать предоставляемые расширением функции и нововведения, появившиеся с момента выхода статьи в свет. Благодаря замечанию rolin555, расширение теперь может устанавливать вебхук с самоподписанным сертификатом SSL (напомню, что Телеграм вызывает вебхуки только через HTTPS), а благодаря необходимости отладить и обновить бота @BarcodeMasterBot - возможность переводить ботов в режим профилактики. Но обо всем по порядку.

 

Настройки модуля

Для перехода в настройки выберите в меню Боцман пункт "Настройка ботов"

 

 

Здесь есть всего две настройки: Адрес публикации ИБ и Сертификат. Обратите внимание, что база должна быть опубликована на веб-сервере по протоколу https, т.к. Телеграм вызывает вебхук только через этот протокол.

Настройка веб-сервера выходит за рамки этой статьи. Скажу только, что при настройке вы можете использовать сертификат подписанные удостоверяющим центром (например я использую бесплатные сертификаты Let's Encrypt) или создать свой, самоподписанный сертификат. Во втором случае вам нужно будет дополнительно нажать кнопку "Сертификат..." и вставить в открывшееся окно открытый ключ вашего сертификата начиная с -----BEGIN CERTIFICATE----- и заканчивая -----END CERTIFICATE-----

 

 

На этом настройка модуля Боцман закончена и можно переходить к созданию ботов

 

Добавление бота

Добавление ботов происходит также в обработке "Настройка ботов" или через справочник "Боты Телеграм" в меню Боцман. Для добавления нового бота нажмите кнопку "Создать":

 

 

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

 
Закладка "Основное"

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

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

Обработка - элемент справочника Внешние отчеты и обработки, содержащий обработку, обеспечивающую функционирование логики вашего бота. Будет рассмотрено подробнее в разделе "Программирование логики бота".

Режим отладки - при установленном флаге бот отправляет ошибки в чат из которого был вызван или пользователю, установленному как администратор бота (см. далее, поле Администратор)

Режим профилактики - при установленном флаге бот обрабатывает только команды в чате с администратором (см. далее), а остальным пользователям выдает стандартный ответ указанный в поле "Текст профилактики".

Текст профилактики - Текс, который бот будет выдавать пользователям не являющимся администратором при попытке взаимодействия с ботом, если бот находится в режиме профилактики. В тексте можно использовать символы замены {{переменная_сессии}}, которые будут заменены их значениями.

 
Закладка "Параметры"

Эта закладка содержит таблицу параметров вашего бота, необходимых вам для удобной настройки логики работы вашего бота. Имена параметров должны удовлетворять правилам именования полей структур 1С, а значения могут иметь типы Число(квалификаторы: 20.3), Строка(максимальная длина: 1024), Булево и Дата(состав даты: Дата и время). Все параметры из этой таблицы доступны во время выполнения через структуру Сессия (Сессия.ИмяПараметра). Параметры могут использоваться в сообщениях бота как символы замены {{ИмяПараметра}}.

 

 
Закладка "Словарь"

В некотором роде значения в этой таблице аналогичны закладке Параметры, но есть отличия. Значения используются при вызове функции __(Строка) в модуле Боцман. Могут использоваться для перевода или изменения строк, прописанных в коде. Если Строка не найдена в колонке "Строка", то функция __(Строка) вернет саму строку. Если найдена - вернет значение из колонки Перевод. Подробнее см. раздел "Методы модуля".

Закладка "Дополнительно", "Запрос контакта"

Просить контакт - если флаг установлен, при первом контакте с пользователем бот будет требовать отправить контакт нажатием соответствующей кнопки.

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

Текст кнопки отправки контакта - текст, который будет отображаться на кнопке отправки контакта. Например: "Регистрация".

Благодарность за контакт - текст, который будет отправлен пользователю, после успешного получения контакта. Например: "Спасибо, теперь вы можете начать пользоваться нашим замечательным ботом". Рекомендация: Лишний раз не просить у пользователей контакт. Чаще всего это бывает нужно, если вы хотите связать работу вашего бота с каким-либо другим сервисом и иметь возможность объединить данные о пользователях с одним номером телефона в Телеграм и стороннем сервисе.

Кнопки начала работы - Кнопки, которые будут отображены после сообщения благодарности за контакт. Это могут быть кнопки основного меню вашего бота. Текст кнопок разделяется запятыми. Например: "Делать то,Делать другое".

 
Закладка "Дополнительно", "Команда /name"

Обрабатывать команду /name автоматически - бот может автоматически обрабатывать команду /name в чатах с пользователями. Эта команда позволяет пользователю изменить имя регистрации (по умолчанию пользователь регистрируется с именем и фамилией указанными в настройках его мессенджера). 

Запрос нового имени - текст отправляемый пользователю в ответ на команду /name. Например: "Введите новые имя и фамилию".

Ответ на изменение имени- текст отправляемый пользователю после изменения имени. Например: "Регистрация изменена. Вы зарегистрированы под именем {{НовоеИмя}} {{НоваяФамилия}}

 
Закладка "Дополнительно", "Работа в группах"

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

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

 

 
Закладка "Дополнительно", "Прочие настройки"

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

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

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

Сообщать об изменении статуса - если флаг установлен бот будет сообщать администратору об изменении статуса в группах. Подключен, отключен, заблокирован и т.д.

Максимальная ширина строк - бот имеет возможность генерации клавиатур для ответов пользователей из строки разделенной запятыми. При этом кнопки клавиатуры группируются в строки и эти параметры позволяют задать максимальную совокупную длину текста кнопок в одной строке.

Инлайн клавиатура - максимальная ширина строки для инлайн клавиатуры (кнопки под сообщением).

Кастомная клавиатуры - максимальная ширина строки для кастомной клавиатуры (выводится вместо стандартной буквенно-цифровой).

Кнопки

Установить вебхук - устанавливает вебхук Телеграм. После установки все сообщения в чате с ботом будут передаваться для обработки в расширение Боцман и затем в вашу обработку.

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

 

Методы модуля

Методы описаны начиная с самых необходимых для быстрого старта и первый - это конечно:

ОтправитьСообщение - отправляет сообщение в текущий чат Телеграм. Параметры:

  • Сессия (обязательный) - содержит структуру сесии;
  • Текст (обязательный) - текст для отправки. Последовательности вида {{имя_поля}} будут заменены на значения полей сессии;
  • Форматирование - вид форматирования сообщения. Может принимать значения Markdown, MarkdownV2 и HTML. По умолчанию Markdown
  • Сущности - сущности (например команды, упоминания и др.) содержащиеся в сообщении. По умолчанию Неопределено;
  • ОтключитьПредпросмотрСсылок - отключение предпросмотра ссылок в передаваемом сообщениии. По умолчанию Ложь;
  • ОтключитьУведомление - отключения уведомления пользователя при приходе сообщения. По умолчанию Ложь;
  • ОтветНаСообщение - идентификатор сообщения, в ответ на которое отправляется данное сообщение. По умолчанию Неопределено;
  • РазрешитьОтправкуБезОтвета - Если Истина - разрешает отправку сообщения, даже если сообщение, на которое отправляется ответ не доступно. По умолчанию Ложь;
  • РазметкаОтвета - Инлайн или кастомная клавиатура или отключение кастомной клавиатуры. Позволяет вывести кнопки для реакции пользователей. Подбробнее см. подраздел Клавиатуры;

Возвращает соответствие, содержащее ответ сервера Телеграм.

 

ОтладочноеСообщение - отправляет сообщение отладки в текущий чат или в чат Администратора в зависимости от настроек бота. Используется форматирование HTML, т.к. отладочная информация часто содержит символы форматирования Markdown ("_", "*" и др.), которые могут вызвать ошибку отправки сообщения. Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • Текст (обязательный) - текст отправляемого сообщения;

Возвращает соответствие, содержащее ответ сервера Телеграм.

 
Работа с файлами

90% потребностей вашего бота покрываются предыдущими двумя функциями, но раз уж мы работаем в 1С и вероятно будем использовать ботов для отправки отчетов вот еще несколько полезных функций для отправки и получения файлов:

ОтправитьДокументИзФайла - отправляет файл в виде документа (без сжатия). Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • ИмяФайла (обязательный) - путь к файлу, который необходимо отправить;
  • ИмяФайлаПревью - путь к файлу превью для документа. Файл должен содержать изображение, которое будет показано пользователю. По умолчанию Неопределено;
  • Заголовок - текст сообщения, поясняющего содержимое файла. По умолчанию Неопределено;
  • Форматирование - вид форматирования сообщения. Может принимать значения Markdown, MarkdownV2 и HTML. По умолчанию Markdown;
  • Сущности - сущности (например команды, упоминания и др.) содержащиеся в сообщении. По умолчанию Неопределено;
  • ОтключитьУведомление - отключения уведомления пользователя при приходе сообщения. По умолчанию Ложь;
  • ОтветНаСообщение - идентификатор сообщения, в ответ на которое отправляется данное сообщение. По умолчанию Неопределено;
  • РазрешитьОтправкуБезОтвета - Если Истина - разрешает отправку сообщения, даже если сообщение, на которое отправляется ответ не доступно. По умолчанию Ложь;
  • РазметкаОтвета - Инлайн или кастомная клавиатура или отключение кастомной клавиатуры. Позволяет вывести кнопки для реакции пользователей. Подбробнее см. подраздел Клавиатуры;

Возвращает соответствие, содержащее ответ сервера Телеграм.

 

ОтправитьФотоИзФайла - отправляет файл в виде документа (без сжатия). Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • ИмяФайла (обязательный) - путь к файлу, который необходимо отправить;
  • Заголовок - текст сообщения, поясняющего содержимое фото. По умолчанию Неопределено;
  • Форматирование - вид форматирования сообщения. Может принимать значения Markdown, MarkdownV2 и HTML. По умолчанию Markdown;
  • Сущности - сущности (например команды, упоминания и др.) содержащиеся в сообщении. По умолчанию Неопределено;
  • ОтключитьУведомление - отключения уведомления пользователя при приходе сообщения. По умолчанию Ложь;
  • ОтветНаСообщение - идентификатор сообщения, в ответ на которое отправляется данное сообщение. По умолчанию Неопределено;
  • РазрешитьОтправкуБезОтвета - Если Истина - разрешает отправку сообщения, даже если сообщение, на которое отправляется ответ не доступно. По умолчанию Ложь;
  • РазметкаОтвета - Инлайн или кастомная клавиатура или отключение кастомной клавиатуры. Позволяет вывести кнопки для реакции пользователей. Подбробнее см. подраздел Клавиатуры;

Возвращает соответствие, содержащее ответ сервера Телеграм.

 

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

  • Сессия (обязательный) - содержит структуру сессии;
  • ИдФайла (обязательный) - идентификатор файла, который нужно получить с сервера Телеграм.

Возвращает имя временного файла, полученного с сервера Телеграм.

 

Клавиатуры

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

 

 

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

 

 

При нажатии кнопок инлайн-клавиатуры сообщение не передается. Вместо этого вызывается специальный callback метод, в который передаются данные о нажатой кнопке (не текст с кнопки. см. далее).

 

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

 

КлавиатураТелеграм - возвращает кастомную клавиатуру. Используется для быстрого создания простых клавиатур. Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • Кнопки (обязательный) - строка с текстом кнопок разделенных запятыми или массив элементов типа соответствие с полями:
    • text - текст отображаемый на кнопке;
    • request_contact - не обязательный. Истина, если нажатие указанной кнопки должно передавать боту контактные данные пользователя;
    • request_location - не обязательный. Истина, если нажатие указанной кнопки должно передавать боту местоположение пользователя.

Возвращает JSON-объект, который может быть передан в качестве параметра РазметкаОтвета в функции передачи сообщений и файлов.

 

КастомнаяКлавиатураИзКнопок - возвращает кастомную клавиатуру. Используется для более гибкого создания кастомных клавиатур. Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • Кнопки (обязательный) - основные кнопки клавиатуры. Могут быть автоматически отсортированы и будут расположены в строках по несколько кнопок, если общая длина текста не превышает заданную в настройках бота. Массив элементов типа соответствие с полями:
    • text - текст отображаемый на кнопке;
    • request_contact - не обязательный. Истина, если нажатие указанной кнопки должно передавать боту контактные данные пользователя;
    • request_location - не обязательный. Истина, если нажатие указанной кнопки должно передавать боту местоположение пользователя.
  • КнопкиДо - массив элементов типа соответствие, аналогичный параметру Кнопки. Кнопки из этого массива будут расположены перед основными кнопками в одну строку. По умолчанию: Неопределено;
  • КнопкиПосле - аналогичен параметру КнопкиДо, за исключением того, что эти кнопки будут расположены после основных кнопок. По умолчанию: Неопределено;
  • Сортировка - если Истина, кнопки будут автоматически отсортированы по возрастанию длины текста. Это будет выглядеть более красиво после автоматического расположения их по строкам. По умолчанию: Ложь;
  • МенятьРазмер - если Истина - клавиатура будет автоматически менять размер, подстраиваясь под количество кнопок. По умолчанию Истина;
  • Однократная - если Истина - клавиатура будет исчезать после нажатия на одну из кнопок. По умолчанию Истина;

Возвращает JSON-объект, который может быть передан в качестве параметра РазметкаОтвета в функции передачи сообщений и файлов.

 

УбратьКлавиатуруТелеграм - позволяет убрать кастомную клавиатуру на устройстве пользователя. Вызывается без параметров

Возвращает JSON-объект, который, при передаче в качестве параметра РазметкаОтвета в функции передачи сообщений и файлов вызовет удаление текущей кастомной клавиатуры (в том числе и скрытой после нажатия кнопки) на устройстве пользователя.

 

ИнлайнКлавиатураИзКнопок - Возвращает инлайн-клавиатуру. Значение может быть использовано для передачи в качестве параметра РазметкаОтвета в функции отправки сообщений и файлов. Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • Кнопки (обязательный) - основные кнопки клавиатуры. Могут быть автоматически отсортированы и будут расположены в строках по несколько кнопок, если общая длина текста не превышает заданную в настройках бота. Масси элементов типа соответствие с полями:
    • text - текст отображаемый на кнопке;
    • callback_data - данные, которые будут переданы в качестве параметра в вызов вашего бота при нажатии кнопки. Максимально 64 байта;
  • КнопкиДо - массив элементов типа соответствие, аналогичный параметру Кнопки. Кнопки из этого массива будут расположены перед основными кнопками в одну строку. По умолчанию: Неопределено;
  • КнопкиПосле - аналогичен параметру КнопкиДо, за исключением того, что эти кнопки будут расположены после основных кнопок. По умолчанию: Неопределено;
  • Сортировка - если Истина, кнопки будут автоматически отсортированы по возрастанию длины текста. Это будет выглядеть более красиво после автоматического расположения их по строкам. По умолчанию: Ложь;

Возвращает JSON-объект, который может быть передан в качестве параметра РазметкаОтвета в функции передачи сообщений и файлов.

 

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

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

Возвращает соответствие, которое можно использовать в качестве элемента массива кнопок при создании кастомной клавиатуры.

 

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

  • Текст (обязательный) - текст кнопки, который будет установлен в качестве поля text кнопки инлайн-клавиатуры;
  • Данные (обязательный) - текст или двоичные данные, которые будут установлены в качестве поля callback_data кнопки инлайн-клавиатуры. Маскимально 64 байта;

Возвращает соответствие, которое можно использовать в качестве элемента массива кнопок при создании инлайн-клавиатуры.

 

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

  • Сессия (обязательный) - содержит структуру сессии;
  • КолбэкИд (обязательный) - идентификатор вызова, который передается во входных параметрах вызова;
  • Текст - текст, который может быть показан пользователю во всплывающем окне или строке уведомлений;
  • ПоказыватьУведомление - если Истина - текст будет показан пользователю в строке уведомлений. В противном случае в виде всплывающего окна. По умолчанию: Ложь;
  • АдресПерехода - можно указать адрес вида: t.me/your_bot?start=XXXX, позволяющий вызвать вашего бота с параметром. По умолчанию: Неопределено;
  • ВремяКэширования - можно указать максимальное время в секундах, в течение которого результат запроса может быть кэширован на стороне пользователя. По умолчанию: 0;

Возвращает соответствие, содержащее ответ сервера Телеграм.

 

Функции для работы с сессией

Для хранения значений между вызовами вы можете использовать сессию, которая представляет из себя структуру 1С. Значения добавленные в сессию с помощью Сессия.Вставить() не сохраняются между вызовами. Сессия.Удалить() также имеет эффект только в течение текущего вызова. Для сохранения и удаления значений между вызовами используйте следующие функции:

 

ЗаписатьЗначениеВСессию - сохраняет переданное значение в сессии. Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • ИмяПараметра (обязательный) - имя добавляемого или изменяемого параметра;
  • Значение (обязательный) - сохраняемое значение.

Возвращает записанное значение.

 

УдалитьЗначениеИзСессии - удаляет значение из сессии. Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • ИмяПараметра (обязательный) - имя удаляемого параметра;

Возвращает Истина;

 

УстановитьТекущуюКоманду - при обработке вам вероятно потребуется сохранять данные о текущей обрабатываемой команде или статусе вашего скрипта обработки. Это можно сделать и с помощью функции ЗаписатьЗначениеВСессию, но использование УстановитьТекущуюКоманду немного удобнее. Параметры:

  • Сессия (обязательный) - содержит структуру сессии;
  • Команда (обязательный) - имя команды;

Вызов этой функции полностью аналогичен вызову: ЗаписатьЗначениеВСессию(Сессия, "ТекущаяКоманда", Команда);

 

КомандаВыполнена - полностью аналогичен вызову: УдалитьЗначениеИзСессии(Сессия, "ТекущаяКоманда"). Парамеры:

  • Сессия (обязательный) - содержит структуру сессии;

 

Заключение

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

Расширение Боцман покрывает основные потребности и сильно упрощает разработку и интеграцию чат-ботов в систему 1С:Предприятие. 

Любые вопросы и предложения по доработке пишите в комментарии.

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

При необходимости осуществить интеграцию расширения в ваше решение, создать бота или по другим вопросам - обращайтесь в комментарии или в ЛС.

 

Обновления

07.12.2022
  • Для удобства работы с инлайн-клавиатурой добавлен третий параметр в функцию КнопкаКолбэка(Текст, Данные, БольшеДанных), позволяющий передавать данные любой длины (Стандартное ограничение Телеграм - 64 байта). Для обработки колбэка можно использовать функцию ПолучитьДанныеКолбэка(Данные), которая на вход получает данные пришедшие от кнопки, а на выходе выдает структуру с полями Данные, Префикс, БольшеДанных
  • Добавлена функция ВводЗначения, автоматически формирующая инлайн клавиатуры для ввода Даты, Справочника (с интересным и удобным способом выбора) или Числа по Списку значений или Булево. После ввода пользователя функция вызывает функцию оповещения, которая передается в виде структуры:
    • Метод - имя экспортируемой функции из обработки бота. Должна иметь два параметра;
    • ДополнительныеПараметры - любые данные, которые будут переданы в качестве второго параметра в Метод
  • Добавлен тип форматирования сообщений Plain, который не поддерживается API Telegram, но часто бывает необходим при выводе отладочных сообщений или текста с неизвестным на момент написания кода форматированием. Этот тип форматирования теперь принят по умолчанию для всех функций отправки сообщений в чат.
  • Исправлены мелкие ошибки.
29.11.2022
  • По настоятельным просьбам клиентов, не желающих публиковать http-сервисы реализована работа через getUpdates без публикации http-сервиса. Для включения getUpdates в боте должен быть установлен флаг Использовать getUpdates и далее запущен цикл опроса серверов Telegram с помощью внешней обработки ЗапускЛонгпулингаДляБотов (входит в комплект поставки). Для обеспечения работы ботов после перезагрузки сервера 1С реокмендуется установить расписание вызова команды Запусить/Остановить getUpdates этой обработки. 
  • Внесены исправления в функцию ОтладочноеСообщение() теперь первым параметром может быть не только Сессия, но и ссылка на элемент справочника БоцманБоты, что позволяет отправлять отладочные сообщения администратору даже в случае, когда сессия не смогла инициализироваться.

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

См. также

SALE! 25%

Конструктор ботов Телеграм, редакция 2

Мессенджеры и боты Платформа 1С v8.3 Платные (руб)

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

15000 11250 руб.

18.06.2021    59439    295    255    

349

SALE! 25%

Что нам стоит бота построить? Нарисуем - будет жить! Графический конструктор телеграм-ботов/Telegram

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

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

13200 9900 руб.

27.12.2021    33809    82    159    

177

Легкий документооборот (+чат-бот для Telegram)

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

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

14900 руб.

15.11.2018    28016    26    48    

58

Email, SMS, Telegram рассылки из 1С - Директ Маркетинг

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

Полный набор инструментов для качественных транзакционных и маркетинговых Email, SMS, Telegram рассылок из 1С. Даже простые уведомления об оплате счетов способны существенно упростить сбор дебиторской задолженности. Применение всех возможностей прямого маркетинга выводит коммуникацию с клиентами, уровень сервиса и лояльность на новый уровень.

7788 руб.

07.04.2014    83877    41    191    

127

Интеграция 1С с телефонией и чатами WhatsApp и Telegram

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

Интеграция 1С с телефонией и чатами WhatsApp и Telegram автоматизирует работу оператора со звонками и чатами и добавит вашей 1С элементы CRM системы. Храните всю историю взаимоотношений в 1С, не теряйте звонки, скачивайте, прослушивайте в любое время из карточки клиента или журнала звонков, держите руку на пульсе, используя блок отчетов по звонкам. Интегрируйте вашу 1С и чатами WhatsApp и Telegram, общайтесь с клиентами с единого номера и в одном окне. Теперь чаты с клиентами хранятся в карточке партнера в 1С, а не в личных мобильных ваших менеджеров.

4100 руб.

28.04.2022    14079    11    8    

36

Отправка в Telegram отчетов, печатных форм, присоединённых файлов и произвольных вложений. Загрузка получателей. Хранение истории отправок.

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

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

4800 руб.

26.12.2023    2353    2    0    

7
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. arman1997 19 09.12.22 13:27 Сейчас в теме
Здравствуйте. У вас на скрине есть окно со сканером штрихода. Этот бот можно адаптировать под распознавание штрихкода? Если да в расширении есть пример?
2. DrWeb3 72 09.12.22 13:55 Сейчас в теме
(1) Есть демо бот @BarcodeMasterBot который распознаёт ШК. Он тоже написан с помощью этого расширения, но использует внешнюю программу для распознавания установленную на сервере. Сервер у меня на Linux. Использую zbarimg:

СтрокаЗапуска = "sh -c ""zbarimg --xml \""%1\"" > \""%2\""""";

Обработку могу скинуть, но без расширения она работать не будет
3. arman1997 19 12.12.22 10:47 Сейчас в теме
(2) Да, можно обработку. Расширение скачиваю
4. DrWeb3 72 12.12.22 14:25 Сейчас в теме
(3) Обработка в прикрепленном файле. Будут вопросы - обращайтесь.
Прикрепленные файлы:
Бот_СканерШтрихкода.epf
5. arman1997 19 12.12.22 14:43 Сейчас в теме
Оставьте свое сообщение