АвтоФон Telegram Бот

Self-hosted Телеграм бот для отслеживания устройств АвтоФон.

Функции бота

• Отслеживание ваших устройств АвтоФон
• Отправка уведомление в Телеграм с информацией о новом состоянии, включая:
  • Наименование устройства (настраивается в личном кабинете АвтоФон)
  • Время обновления состояния
  • Текущую температуру
  • Напряжение батареи и количество затраченных мАч
  • Текущее местоположение устройства и точность определения
• Предупреждение о низком балансе на сим-картах
• Настраиваемый список устройств для отслеживания
• Формирование графиков на основе истории состояний устройств
• Получение сводной информации о сохраненных состояниях устройств

Графики

Температура с датчика устройства

Напряжение батареи

Затраченное мАч батареи

Запуск

Для запуска бота через docker compose необходимо:

1. Установить Docker и Docker Compose.
2. Создать вашего бота и получить токен у @BotFather.
3. Узнать свой chat_id у @userinfobot.
4. Заполнить docker-compose.yml файл обязательными переменными AUTOFON_TELEGRAM_TOKEN, AUTOFON_TELEGRAM_CHAT_ID, AUTOFON_API_KEY, AUTOFON_API_PASSWORD.

   autofon-telegram-bot/src/main/docker/docker-compose.yml

   Lines 1 to 12 in 7d83bf0

   	version: '2'
   	services:
   	autofon-bot-app:
   	image: trueromancha/autofon-telegram-bot:latest
   	volumes:
   	- /opt/autofon/:/autofon/
   	environment:
   	- _JAVA_OPTIONS=-Xmx256m -Xms256m
   	- AUTOFON_TELEGRAM_TOKEN=you-token
   	- AUTOFON_TELEGRAM_CHAT_ID=you-chat-id
   	- AUTOFON_API_KEY=you-autofon-api-key
   	- AUTOFON_API_PASSWORD=you-autofon-api-password

5. В volumes первый путь должен быть указан к папке на вашем устройстве, куда будет сохраняться файл с базой данных бота.
6. Выполнить команду для запуска docker-compose up -d.

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

Для добавления устройства в список отслеживаемых, нажмите на кнопку "Настройка отслеживания" в боте.

Доступные параметры

Параметр	Описание
AUTOFON_TELEGRAM_TOKEN	Токен телеграм бота, полученный у @BotFather
AUTOFON_TELEGRAM_CHAT_ID	Идентификатор чата, куда бот будет слать уведомления. Обычно это ваш чат с ботом, можно воспользоваться @userinfobot для получения id
AUTOFON_API_KEY	Api ключ АвтоФон, узнать можно в личном кабинете АвтоФон - API Key
AUTOFON_API_PASSWORD	Пароль от вашего аккуанта АвтоФон
AUTOFON_TIME_ZONE	Временная зона ZoneId, по умолчанию Europe/Moscow
AUTOFON_HEARTBEAT_ENABLED	Включить отправку уведомлений о состоянии бота, по умолчанию false
AUTOFON_HEARTBEAT_INTERVAL_SECONDS	Интервал отправки уведомлений о состоянии бота в секундах, по умолчанию 10800 (3 часа)
AUTOFON_CHECK_LAST_UPDATE_INTERVAL_SECONDS	Интервал проверки обновлений устройств в секундах, по умолчанию 600 (10 минут)
AUTOFON_SIM_BALANCE_ALARM_THRESHOLD	Лимит баланса сим карты для предупреждения о низком балансе, по умолчанию 30