Настройка Telegram-бота для уведомлений из 1С: Пошаговый гайд

1.1. Найдите BotFather

Откройте Telegram и в строке поиска введите @BotFather. Выберите официального бота (у него будет синяя галочка).

1.2. Запустите создание нового бота

Нажмите кнопку ‘Start’ или отправьте команду /start. Затем отправьте команду /newbot.

1.3. Придумайте имя и username для бота

• Имя бота (Name): Это будет отображаемое имя вашего бота в чатах. Например, ‘1С Уведомления’. Вы можете использовать пробелы и кириллицу.
• Username бота: Это уникальное имя, по которому пользователи смогут найти вашего бота. Оно должно заканчиваться на bot (например, My1CNotifier_bot). Допускаются только латинские буквы, цифры и нижние подчеркивания.

После ввода корректного username, BotFather пришлет сообщение с токеном вашего бота. Обязательно сохраните этот токен! Он выглядит примерно так: 123456789:ABCDEFGHIKLMNOPQRSTUVWXYZ1234567890.

2.1. Начните диалог с вашим ботом

Найдите вашего только что созданного бота в Telegram по его username (например, @My1CNotifier_bot) и отправьте ему любое сообщение (например, ‘Привет’). Это необходимо, чтобы бот ‘увидел’ ваш чат.

2.2. Получите Chat ID

Есть несколько способов получить Chat ID:

• Через браузер: Откройте в браузере ссылку, заменив [YOUR_BOT_TOKEN] на токен вашего бота:

  https://api.telegram.org/bot[YOUR_BOT_TOKEN]/getUpdates

  В открывшемся JSON-ответе найдите поле 'id' внутри объекта 'chat'. Это и будет ваш Chat ID. Если вы отправляли сообщения боту, вы увидите что-то вроде "chat":{"id":123456789,"first_name":"ВашеИмя"...}. Число 123456789 — это ваш Chat ID.

• Через специального бота: Найдите в Telegram бота @userinfobot или @get_id_bot. Отправьте ему команду /start, и он покажет ваш личный Chat ID. Если вы хотите получить Chat ID группы, добавьте этого бота в группу и отправьте ему команду /getid.

3.1. Создайте общую функцию для отправки сообщений

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

// Общий модуль: УведомленияTelegram
// Функция для отправки сообщения в Telegram
Функция ОтправитьСообщениеВTelegram(ТекстСообщения) Экспорт

    Перем Результат;

    // --- Настройки бота --- 
    // ВАЖНО: Замените на ваш реальный токен бота
    Конст ТокенБота = "ВАШ_ТОКЕН_БОТА"; 
    // ВАЖНО: Замените на ваш реальный Chat ID
    Конст ChatID = "ВАШ_CHAT_ID"; 
    // --- Конец настроек бота ---

    Если ПустаяСтрока(ТокенБота) Или ПустаяСтрока(ChatID) Тогда
        ЗаписатьЖурналРегистрации(
            "УведомленияTelegram",
            УровеньЖурналаРегистрации.Ошибка,
            ,,,
            "Не указан токен бота или Chat ID для Telegram."
        );
        Возврат Ложь;
    КонецЕсли;

    Попытка
        // URL для отправки сообщения через Telegram Bot API
        // parse_mode=HTML позволяет использовать HTML-разметку в сообщении
        Конст URL = "https://api.telegram.org/bot" + ТокенБота + "/sendMessage";

        // Создаем объект HTTPЗапрос
        HTTPЗапрос = Новый HTTPЗапрос(URL);
        HTTPЗапрос.УстановитьЗаголовок("Content-Type", "application/json");

        // Формируем тело запроса в формате JSON
        ТелоЗапроса = Новый Структура();
        ТелоЗапроса.Вставить("chat_id", ChatID);
        ТелоЗапроса.Вставить("text", ТекстСообщения);
        ТелоЗапроса.Вставить("parse_mode", "HTML"); // Можно использовать MarkdownV2 или оставить пустым для обычного текста

        JSONСтрока = СериализаторJSON.Записать(ТелоЗапроса);
        HTTPЗапрос.УстановитьТелоИзСтроки(JSONСтрока, КодировкаТекста.UTF8);

        // Создаем объект HTTPСоединение
        Соединение = Новый HTTPСоединение();

        // Отправляем запрос
        HTTPОтвет = Соединение.Отправить(HTTPЗапрос);

        // Проверяем статус ответа
        Если HTTPОтвет.КодСостояния = 200 Тогда
            Результат = Истина;
            ЗаписатьЖурналРегистрации(
                "УведомленияTelegram",
                УровеньЖурналаРегистрации.Информация,
                ,,,
                "Сообщение в Telegram успешно отправлено."
            );
        Иначе
            Результат = Ложь;
            ЗаписатьЖурналРегистрации(
                "УведомленияTelegram",
                УровеньЖурналаРегистрации.Ошибка,
                ,,,
                "Ошибка отправки сообщения в Telegram. Код: " + HTTPОтвет.КодСостояния + ", Ответ: " + HTTPОтвет.ПолучитьТелоКакСтроку()
            );
        КонецЕсли;

    Исключение
        Результат = Ложь;
        ЗаписатьЖурналРегистрации(
            "УведомленияTelegram",
            УровеньЖурналаРегистрации.Ошибка,
            ,,,
            "Исключение при отправке сообщения в Telegram: " + ОписаниеОшибки()
        );
    КонецПопытки;

    Возврат Результат;

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

4.1. Примеры использования

• При записи нового документа:

  // В модуле объекта документа "ЗаказПокупателя" при событии "ПриЗаписи"
  Процедура ПриЗаписи(Отказ)
      Если ЭтоНовый() Тогда
          ТекстУведомления = "📄 Новый заказ!
  Номер: " + Номер + "
  От: " + Контрагент + "
  Сумма: " + СуммаДокумента;
          УведомленияTelegram.ОтправитьСообщениеВTelegram(ТекстУведомления);
      КонецЕсли;
  КонецПроцедуры

• При возникновении критической ошибки:

  // В обработчике исключений или в месте потенциальной ошибки
  Попытка
      // Ваш код, который может вызвать ошибку
  Исключение
      ТекстОшибки = ОписаниеОшибки();
      ТекстУведомления = "❗️ Критическая ошибка в 1С!
  " + ТекстОшибки;
      УведомленияTelegram.ОтправитьСообщениеВTelegram(ТекстУведомления);
  КонецПопытки;

• По расписанию (регламентные задания):

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

  // В модуле регламентного задания
  Процедура ВыполнитьПроверкуОстатков()
      // ... логика проверки остатков ...
      Если ЕстьТоварыСНизкимОстатком Тогда
          ТекстУведомления = "📈 Низкие остатки!
  Проверьте склад по позициям: " + СписокТоваров;
          УведомленияTelegram.ОтправитьСообщениеВTelegram(ТекстУведомления);
      КонецЕсли;
  КонецПроцедуры

1. Бот не отвечает / Сообщения не приходят

• Проверьте токен бота: Убедитесь, что токен в коде 1С точно соответствует токену, выданному BotFather. Скопируйте его еще раз, используя Ctrl + C и Ctrl + V.
• Проверьте Chat ID: Убедитесь, что Chat ID правильный. Если это группа, убедитесь, что бот добавлен в группу и является администратором.
• Начали ли вы диалог с ботом? Бот не сможет отправить вам сообщение, пока вы не напишете ему первое сообщение.
• Доступ к интернету: Убедитесь, что сервер 1С имеет доступ к api.telegram.org. Проверьте настройки фаервола, прокси-сервера. Попробуйте выполнить команду ping api.telegram.org из командной строки сервера 1С.
• Логи 1С: Проверьте журнал регистрации 1С. Функция ОтправитьСообщениеВTelegram записывает информацию об ошибках.

2. Ошибка HTTP-запроса (например, 400 Bad Request, 401 Unauthorized)

• 401 Unauthorized: Почти всегда означает неверный токен бота. Перепроверьте его.
• 400 Bad Request: Может указывать на неверный Chat ID или некорректный формат JSON-тела запроса. Убедитесь, что Chat ID начинается с -100 для групп. Проверьте, что parse_mode указан правильно, если вы используете HTML или Markdown.
• Проверьте URL: Убедитесь, что URL https://api.telegram.org/bot[YOUR_BOT_TOKEN]/sendMessage сформирован корректно.

3. Сообщения приходят, но без форматирования

• Убедитесь, что в вашем JSON-запросе присутствует параметр "parse_mode": "HTML" (или "MarkdownV2"), и что ваш текст сообщения содержит корректные HTML-теги (например, <b> для жирного, <i> для курсива).

4. Проблемы с производительностью 1С при отправке уведомлений

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

5. Ошибка «Не удалось установить соединение»

• Это часто указывает на проблемы с сетевым доступом с сервера 1С до серверов Telegram. Проверьте настройки прокси-сервера, фаервола, антивируса. Возможно, требуется добавить api.telegram.org в список исключений.
• Иногда помогает перезапуск службы сервера 1С, если были изменения в сетевых настройках.