User Guide
Руководство пользователя

Everything you need
to know.

Всё, что нужно
знать.

Get set up in minutes. Reference commands, alerts, settings and billing — all in one place.

Настройка за несколько минут. Команды, уведомления, настройки и биллинг — всё здесь.

01 / Setup

Getting Started

From Telegram to live alerts in about two minutes.

1

Open the bot

Search for @WattsonEVBot in Telegram or open t.me/WattsonEVBot. Tap Start.

2

Choose a plan

Select Solo ($5/mo) for full access to all commands, stats and alerts.

3

Complete payment

You'll receive a secure checkout link. After payment your bot is provisioned automatically — takes about 1 minute.

4

Connect your Tesla

Send your Tesla refresh token when prompted. Get one with tesla_auth. This credential lets the bot read car data only — it cannot control the car.

5

You're live

The bot sends a first status message and alerts begin automatically. Use the keyboard or type commands to query your car anytime.

01 / Настройка

Начало работы

От Telegram до живых уведомлений — около двух минут.

1

Откройте бота

Найдите @WattsonEVBot в Telegram или откройте t.me/WattsonEVBot. Нажмите Старт.

2

Выберите план

Выберите Solo ($5/мес) — полный доступ ко всем командам, статистике и уведомлениям.

3

Завершите оплату

Вы получите защищённую ссылку для оплаты. После оплаты бот создаётся автоматически — около 1 минуты.

4

Подключите Tesla

Отправьте Tesla refresh token. Получите с помощью tesla_auth. Токен только читает данные — управление машиной невозможно.

5

Готово

Бот пришлёт первое статусное сообщение. Уведомления начнутся автоматически. Используйте клавиатуру или команды, чтобы запросить данные в любой момент.

02 / Reference

Commands

All commands are available via the persistent keyboard or by typing them with a / prefix.

CommandWhat it shows
🔋 /batteryCharge %, usable range, charging state, inside/outside temperature
🛞 /tpmsTyre pressure per wheel with alert indicator when below threshold
📍 /locationCurrent position with reverse-geocoded address and geofence name
🚗 /tripLast completed drive: distance, duration, efficiency, cost
⚡ /chargingActive charging session: power, kWh added, cost, time to full
🕐 /historyRecent trips with filter buttons (today / week / month / all)
📊 /statsDriving statistics for today, this week, and this month
📅 /monthFull monthly report: total km, kWh, charging sessions, cost
🌡 /climateInterior and exterior temperatures, climate on/off state
🗃️ /alldataComplete snapshot of all available data in one message
📈 /chartsThree charts: battery level (7d), daily mileage (7d), efficiency vs EPA (8w)
🔔 /alertsToggle individual notification types on or off
⚙️ /settingsConfigure language, currency, tariff, battery threshold, tyre pressure
ℹ️ /statusBot and MQTT connectivity status
🔄 /reconnectForce MQTT reconnect if live data has stopped updating
💳 /billingCurrent plan, expiry date, and link to manage subscription
02 / Справочник

Команды

Все команды доступны через клавиатуру или вводом с префиксом /.

КомандаЧто показывает
🔋 /batteryЗаряд %, запас хода, состояние зарядки, температуры
🛞 /tpmsДавление в каждой шине с индикатором тревоги
📍 /locationТекущее положение с адресом и геозоной
🚗 /tripПоследняя поездка: км, время, эффективность, стоимость
⚡ /chargingТекущая зарядка: мощность, добавлено кВт·ч, стоимость, время
🕐 /historyИстория поездок с фильтрами (сегодня / неделя / месяц / все)
📊 /statsСтатистика вождения за сегодня, неделю и месяц
📅 /monthПолный месячный отчёт: км, кВт·ч, сессии зарядки, стоимость
🌡 /climateВнутренняя и внешняя температуры, состояние климата
🗃️ /alldataПолный снимок всех данных в одном сообщении
📈 /chartsТри графика: заряд (7 дней), пробег (7 дней), расход vs EPA (8 нед)
🔔 /alertsВключение/отключение отдельных типов уведомлений
⚙️ /settingsЯзык, валюта, тариф, порог заряда, давление шин
ℹ️ /statusСостояние бота и MQTT-соединения
🔄 /reconnectПринудительный реконнект MQTT
💳 /billingТекущий план, срок, ссылка на управление подпиской
03 / Push notifications

Automatic Alerts

Sent automatically — no action needed. Toggle each individually via 🔔 /alerts.

🚗

Drive started

Sent when the car begins moving (displacement >300 m or speed >30 km/h).

🏁

Drive ended

Sent when parked and locked. Includes distance, duration, efficiency, and cost.

Charging started

Sent ~35 seconds after plug is connected and charging begins. Delay filters false triggers.

Charge complete

Sent when charging finishes or reaches the configured limit. Includes kWh added and cost.

⚠️

Charge interrupted

Sent when charging stops before the limit without the cable being manually unplugged.

🔋

Low battery

Sent when battery drops below your configured threshold (default 20%). Cooldown: 1 hour.

🛞

TPMS alert

Sent when any tyre pressure drops below your configured minimum. Cooldown: 30 minutes.

🛡️

Sentry Mode

Sent when Sentry Mode is enabled or disabled on the car. Useful to confirm it activated at your destination.

🔓

Left unlocked

Sent when the car has been unlocked for 5 minutes while not driving. Repeats every 15 minutes until locked again.

03 / Push-уведомления

Автоматические уведомления

Отправляются автоматически. Каждое можно отключить в 🔔 /alerts.

🚗

Поездка началась

Когда машина начинает движение (смещение >300 м или скорость >30 км/ч).

🏁

Поездка завершена

После парковки и блокировки. Включает км, время, расход и стоимость.

Зарядка началась

Через ~35 сек после подключения кабеля. Задержка исключает ложные срабатывания.

Зарядка завершена

При достижении лимита или полного заряда. Включает кВт·ч и стоимость.

⚠️

Зарядка прервана

Зарядка остановлена до лимита без ручного отключения кабеля.

🔋

Низкий заряд

Ниже настроенного порога (по умолчанию 20%). Кулдаун: 1 час.

🛞

TPMS тревога

Давление в шине ниже минимума. Кулдаун: 30 минут.

🛡️

Sentry Mode

При включении или отключении режима охраны. Удобно для подтверждения активации на парковке.

🔓

Машина не заперта

Отправляется через 5 минут после разблокировки, если машина не едет. Повторяется каждые 15 минут до блокировки.

04 / Configuration

Settings

Open ⚙️ /settings from the keyboard to configure these options.

🌐 Language

Switch between Russian 🇷🇺 and English 🇬🇧. All bot messages update immediately.

💱 Currency

Charging cost calculations use your selected currency: AZN, USD, EUR, RUB, GEL, GBP, TRY, or KZT.

⚡ Electricity tariff

Flat — single price per kWh. Tap the price button to adjust.
Day/Night (TOU) — different prices for daytime and night hours. Set day price, night price, and start hours separately.

🔌 AC / DC charging prices

Optional separate prices for home (AC) and fast (DC) charging. When set, these override the main tariff for those session types.

🔋 Low battery threshold

The charge level (5–50%) below which you receive a low battery alert. Default: 20%.

🛞 Minimum tyre pressure

TPMS alert fires when any tyre drops below this value (1.5–4.0 bar). Default: 2.55 bar.

🌍 Timezone

Set your local timezone so that daily/weekly/monthly reports and Day/Night tariff hours match your clock. Open ⚙️ /settings and tap the timezone button to pick from a list.

Entering values via text

Use the ▲/▼ buttons in the settings menu, or type commands directly:

price 0.13 — flat tariff
price day 0.18 — day tariff
price night 0.08 — night tariff
price ac 0.15 — AC charging price
price dc 0.35 — DC fast charging price
threshold 15 — low battery threshold (%)
tires 2.5 — min tyre pressure (bar)
dayhour 7 — day zone start (hour)
nighthour 23 — night zone start (hour)

04 / Конфигурация

Настройки

Откройте ⚙️ /settings с клавиатуры для изменения параметров.

🌐 Язык

Переключение между Русским 🇷🇺 и Английским 🇬🇧. Все сообщения бота обновляются сразу.

💱 Валюта

Расчёты стоимости зарядки используют выбранную валюту: AZN, USD, EUR, RUB, GEL, GBP, TRY, KZT.

⚡ Тариф на электричество

Единый — одна цена за кВт·ч. Нажмите кнопку с ценой для изменения.
День/Ночь (TOU) — разные цены для дневного и ночного времени. Задайте дневную/ночную цену и часы начала периодов.

🔌 AC / DC цены зарядки

Отдельные цены для домашней (AC) и быстрой (DC) зарядки. Когда заданы, используются вместо основного тарифа для этих типов сессий.

🔋 Порог низкого заряда

Уровень заряда (5–50%), при достижении которого приходит уведомление. По умолчанию: 20%.

🛞 Минимальное давление шин

TPMS-уведомление при давлении ниже этого значения (1.5–4.0 бар). По умолчанию: 2.55 бар.

🌍 Часовой пояс

Часовой пояс для суточной/недельной/месячной статистики и часов тарифа День/Ночь. Откройте ⚙️ /settings и нажмите кнопку часового пояса для выбора из списка.

Ввод значений текстом

Кнопки ▲/▼ в меню настроек, или команды текстом:

price 0.13 — единый тариф
price day 0.18 — дневной тариф
price night 0.08 — ночной тариф
price ac 0.15 — цена AC зарядки
price dc 0.35 — цена DC быстрой зарядки
threshold 15 — порог низкого заряда (%)
tires 2.5 — минимальное давление (бар)
dayhour 7 — начало дневного тарифа (час)
nighthour 23 — начало ночного тарифа (час)

05 / Subscription

Billing

One plan, everything included.

Free
$0
  • ✅ Automatic alerts
  • ❌ Commands
  • ❌ Stats & charts
Trial
Free
time-limited
  • ✅ Solo features
  • ⏳ Limited period

Managing your subscription

View plan & expiry

Use 💳 /billing to see your current plan and expiry date.

Cancel

Use the billing portal link in the /billing message. Cancellation takes effect at the end of the current billing period — you keep access until then.

05 / Подписка

Биллинг

Один план, всё включено.

Free
$0
  • ✅ Автоматические уведомления
  • ❌ Команды
  • ❌ Статистика и графики
Trial
Бесплатно
ограничено
  • ✅ Solo-функции
  • ⏳ Ограничено по времени

Управление подпиской

Просмотр плана и срока

Используйте 💳 /billing для просмотра текущего плана и даты окончания.

Отмена

Перейдите по ссылке биллинг-портала в сообщении /billing. Отмена вступает в силу в конце текущего периода — доступ сохраняется до его завершения.

06 / Help

FAQ

Why isn't the bot responding to commands?

Check ℹ️ /status to see if MQTT is connected. If not, tap 🔄 /reconnect. If it persists, contact support.

What is a Tesla refresh token?

A long-lived credential that lets the bot read your car's data without your password. It cannot control the car. Get one with tesla_auth.

How do I change my plan?

Use 💳 /billing to get a billing portal link where you can upgrade, downgrade, or cancel.

Why did I get a false drive alert?

Short moves under 300 m are filtered out. If false alerts continue, contact support.

My data seems stale.

Tap 🔄 /reconnect. If the car is asleep, data only updates when it wakes — try opening the Tesla app or starting a drive.

Is my Tesla password stored?

No. WattsonBot only uses your refresh token. Your password is never sent to us. The token can be revoked at any time from your Tesla account.

06 / Помощь

FAQ

Почему бот не отвечает на команды?

Проверьте ℹ️ /status — подключён ли MQTT. Если нет, нажмите 🔄 /reconnect. Если не помогает — напишите в поддержку.

Что такое Tesla refresh token?

Долгосрочный ключ доступа к данным без пароля. Не позволяет управлять машиной. Получите с помощью tesla_auth.

Как изменить план?

Используйте 💳 /billing — ссылка на биллинг-портал для смены или отмены подписки.

Почему пришло ложное уведомление о поездке?

Перемещения менее 300 м отфильтровываются. Если ложные уведомления продолжаются — напишите нам.

Данные не обновляются.

Нажмите 🔄 /reconnect. Если машина спит, данные обновятся только при пробуждении — попробуйте открыть приложение Tesla.

Хранится ли мой пароль Tesla?

Нет. WattsonBot использует только refresh-токен. Пароль нам никогда не передаётся. Токен можно отозвать в любой момент из аккаунта Tesla.