Короткий гайд по Botkin

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

Что это

Telegram-бот, в который ты пишешь что ел, что принял и как себя чувствуешь. Часы, тонометр и весы шлют данные сами. Бот ведёт твою историю и отвечает на вопросы про неё.

Начать

1. Открой @Botkin_md_bot в Telegram.
2. Нажми /start. Ответь на 10 вопросов про возраст, рост, пол, цель. Это считает твою норму калорий.
3. Залогируй первый приём пищи — фотом, голосом или текстом. Дальше — по ситуации.

Логирование еды

Три способа:

• Фото — сфотографируй тарелку, отправь боту. LLM распознает что на фото, прикинет порцию, посчитает КБЖУ.
• Голосовое — «съел овсянку 80 грамм и яблоко».
• Текст — «обед: гречка 200 г, курица 150 г».

Если бот промахнулся — поправь текстом и он перезапишет.

Готовишь заранее? Напиши с приставкой «план:» — например, «план: гречка 200 г, курица 150 г». Вечером бот спросит, доел ли ты всё, и сам сведёт план с фактом.

Добавки и АД

Тоже просто текстом:

• «принял креатин 5 г», «выпил омегу», «магний на ночь» — запишет в дневник добавок.
• «АД 128/72», «давление 135 на 85 пульс 62» — запишет с временем.

Подключение устройств

Apple Watch / iPhone: поставь приложение Health Auto Export (платное, $25). В нём настрой автоматический REST API экспорт на https://botkin.health/apple_health_v2 с твоим Bearer-токеном. Раз в сутки само сольёт шаги, пульс, сон, HRV, давление, вес.

Android: через Google Health Connect подтягиваются Samsung Health, Huawei Health, Mi Health и другие приложения здоровья — подключается один раз, дальше само.

Garmin: в боте напиши «подключи гармин», пришлёт инструкцию.

Тонометр Omron: через Apple Health в iPhone → дальше через HAE как выше.

Весы Mi / Withings: через Apple Health.

Глюкометр FreeStyle Libre: напиши боту /connect_cgm — подключится через LibreLinkUp, дальше глюкоза приходит сама, без ручного ввода.

Анализы крови: сфотографируй бланк или пришли PDF — Боткин извлечёт показатели в твою базу.

Спросить Боткина

Свободным текстом, как другу. Примеры:

• «что я ел вчера», «сколько белка за неделю»
• «какой у меня HRV последние дни», «сон за месяц»
• «какой витамин D в последних анализах», «как менялся холестерин»
• «самая длинная пробежка в этом году»
• «поставь цель веса 72 кг», «измени мой целевой дефицит на -10%»

Бот сам решит куда смотреть и что считать. На простые вопросы отвечает в 1–2 предложениях, на сложные раскладывает.

Команды

• /day — что было сегодня (еда, добавки, шаги, сон)
• /week — то же за неделю
• /sync — обновить данные из устройств вручную (обычно идёт ночью сам)
• /menu — открыть мини-апп с дневником питания и чек-листом добавок
• /share — получить ссылку на свой большой дашборд в браузере

Дашборд в браузере

/share в боте даёт ссылку вида https://botkin.health/mc/... — это твоя личная страница с биомаркерами, графиками веса, тренировок и трендов за месяцы. Открывается без логина (доступ только по знанию URL), удобно открыть на большом экране и обсуждать с врачом.

Приватность

Каждый видит только свои данные. RLS-изоляция в БД — нельзя случайно получить чужую запись. Анализы крови по умолчанию доступны AI-помощнику; если не хочешь — напиши «сделай мою KB приватной», бот отключит доступ.

Owner проекта (Александр) видит в админке только агрегаты (сколько юзеров, сколько вызовов LLM, размер БД) — без личных данных.

Если что-то не работает

• Бот молчит дольше минуты — попробуй ещё раз, возможно LLM-провайдер тормозит.
• Распознал еду неверно — поправь текстом, новая запись перезапишет.
• Данные с часов не приходят — открой Health Auto Export, проверь что автоматизация включена.
• Что-то совсем сломалось — напиши [email protected].