Битрикс24 Модуль Telegram Bot для фиксации поступлений и выдачи товара в Битрикс24 v1.0.0

Возможности​

• Поиск сделок по ID, названию, контрагенту или сумме
• Оприходование товаров с фото и описанием
• Выдача товаров с фотофиксацией
• Автоматическое добавление комментариев в 1С-Битрикс24 от имени пользователя
• Загрузка фотографий на диск 1С-Битрикс24
• Поддержка нескольких пользователей с разными правами

Требования​

• Python 3.8 или выше
• Telegram Bot Token (получить через @BotFather)
• 1С-Битрикс24 портал с правами администратора
• Webhook URL от 1С-Битрикс24

Установка​

1. Клонировать или скачать проект​

git clone
cd warehouse_bot

### 2. Установить зависимости
```bash
pip install -r requirements.txt

Настройка​

1. Создать бота в Telegram​

1. Откройте Telegram и найдите @BotFather
2. Отправьте команду /newbot
3. Следуйте инструкциям и получите токен бота
4. Сохраните токен

2. Получить Webhook URL от 1С-Битрикс24​

1. Войдите в ваш портал 1С-Битрикс24
2. Перейдите в Приложения - Вебхуки
3. Создайте новый входящий вебхук
4. Выберите права доступа:
   • crm - чтение и запись
   • disk - загрузка файлов
   • user - информация о пользователях
5. Скопируйте полный URL вебхука

3. Получить ID пользователей 1С-Битрикс24​

1. В 1С-Битрикс24 перейдите в Компания - Сотрудники
2. Откройте профиль нужного сотрудника
3. В адресной строке найдите ID (например, /company/personal/user/7/ - ID = 7)

4. Получить Telegram ID пользователей​

1. Найдите в Telegram бота @userinfobot
2. Отправьте ему любое сообщение
3. Бот ответит с вашим Telegram ID

5. Настроить config.py​

# Токен Telegram бота
TELEGRAM_TOKEN = "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

# Webhook URL от Битрикс24
BITRIX_WEBHOOK = "https://your-portal.bitrix24.ru/rest/1/abcdefg123456/"

# Словарь пользователей
USERS = {
    123456789: {  # Telegram ID
        'name': 'Иван Иванов',
        'bitrix_id': '7'  # ID в Битрикс24
    },
    987654321: {
        'name': 'Петр Петров',
        'bitrix_id': '15'
    }
}

Запуск​

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

Команды бота​

• /start - Запуск бота и главное меню
• /help - Справка по использованию
• /reset - Сбросить текущую операцию
• /cancel - Отменить операцию и выйти
• /myid - Показать информацию об аккаунте

Рабочий процесс​

Вариант 1: Ввод ID сделки​

1. Нажмите "Новая операция"
2. Введите ID сделки из 1С-Битрикс24
3. Выберите действие: "Оприходовать" или "Выдать"
4. Отправьте фото и описание товара
5. Бот добавит комментарий в сделку

Вариант 2: Поиск сделки​

1. Нажмите "Найти сделку"
2. Выберите тип поиска: по названию, контрагенту или сумме
3. Выберите: только открытые или все сделки
4. Введите запрос для поиска
5. Выберите нужную сделку из списка
6. Выберите действие: "Оприходовать" или "Выдать"
7. Отправьте фото и описание товара

Отправка фото и описания​

1. Фото с подписью (все сразу)
2. Сначала текст, потом фото
3. Сначала фото, потом текст

Структура комментария в 1С-Битрикс24​

ОПРИХОДОВАНИЕ / ВЫДАЧА
━━━━━━━━━━━━━━━━
Дата: 18.02.2026 16:30
Сделка: Название сделки
Описание: Текст описания товара

Фото: https://link-to-photo.jpg
━━━━━━━━━━━━━━━━

Возможные проблемы​

Бот не отвечает​

• Проверьте правильность токена в config.py
• Убедитесь что бот запущен
• Проверьте что ваш Telegram ID добавлен в USERS

Ошибка "Сделка не найдена"​

• Проверьте правильность ID сделки
• Убедитесь что webhook имеет права на чтение CRM
• Проверьте что сделка существует в 1С-Битрикс24

Ошибка загрузки фото​

• Проверьте права webhook на доступ к диску (disk)
• Убедитесь что в 1С-Битрикс24 есть папка с ID = 3 или измените ID в bitrix.py

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

• Проверьте правильность bitrix_id в config.py
• Убедитесь что пользователь существует в 1С-Битрикс24

Безопасность​

• Храните config.py в безопасности
• Не публикуйте токены и webhook URL
• Добавьте config.py в .gitignore
• Регулярно обновляйте webhook URL при компрометации

Поддержка​

1. Логи бота в консоли
2. Права доступа webhook в 1С-Битрикс24
3. Правильность настроек в config.py
4. Актуальность версий библиотек