Актуальная версия приложения: 1.0.121

1. Установка

1. Скачайте butmsg-setup.exe со страницы загрузки и запустите.
2. SmartScreen может предупредить «Windows защитила ваш компьютер» → «Подробнее» → «Выполнить всё равно» (приложение без подписи издателя).
3. Установка идёт без прав администратора; в мастере можно включить автозапуск при входе в Windows и ярлык на рабочем столе.

Windows 10/11. Нужен компонент Microsoft Edge WebView2 (обычно уже установлен; если нет — установщик подскажет ссылку).

2. Регистрация и вход

Откройте приложение — внутри загружается butmsg. «Зарегистрироваться» → email, никнейм, пароль → код с почты (при включённом одобрении — подтверждает администратор). Вход по email и паролю; сессия сохраняется между запусками.

3. Окно и трей

• Основное окно — список бесед слева и переписка. Работа как в веб-версии.
• Закрытие окна сворачивает в трей (значок у часов), а не завершает приложение — чтобы доходили звонки и сообщения. Открыть снова — двойной клик по значку в трее.
• Меню значка в трее: Открыть, Автозапуск при входе в Windows, Выход.

4. Переписка, медиа, группы

• Личные и групповые чаты; отправка текста, файлов, фото/видео и голосовых.
• Ответы, редактирование, удаление (у себя / у всех), пересылка, копирование.
• Поиск по чатам и по сообщениям внутри чата; превью ссылок; просмотр медиа.
• Группы создаются и управляются как в вебе.

5. Звонки, микрофон и камера

Аудио- и видеозвонки работают прямо в приложении. Доступ к микрофону и камере выдаётся автоматически — отдельные запросы не появляются. Если Windows всё же запросит доступ к устройствам для приложения — разрешите.

6. Уведомления

О новых сообщениях приходит системное уведомление Windows, когда окно свёрнуто в трей. Убедитесь, что уведомления для приложения не отключены в параметрах Windows.

7. Обновление

Когда выйдет новая версия (актуальная — 1.0.121), скачайте свежий butmsg-setup.exe со страницы загрузки и запустите — он обновит установленную версию. Аккаунт и переписка на сервере, ничего не теряется.

🤖 Боты

Через служебного бота botmother вы создаёте своих ботов, которые могут отправлять сообщения пользователям программно (например, уведомления с вашего сервера). Работает одинаково в приложении и в вебе.

1. Найдите в поиске пользователя botmother и откройте с ним чат.
2. Отправьте команду /newbot имя_бота (имя латиницей, 3–32 символа: буквы, цифры, . _ -). В ответ botmother пришлёт ID бота и секретный токен.
3. Готово — бот создан как отдельный аккаунт. Токен держите в секрете.

Команды botmother:

Команда	Действие
/newbot <имя>	Создать бота
/mybots	Список ваших ботов
/token <id>	Показать токен бота
/revoke <id>	Сменить токен (старый перестанет работать)
/delbot <id>	Отключить бота

Как бот отправляет сообщение — HTTP-запрос с сервера/скрипта (токен в заголовке):

POST https://butmsg.ru/api/bot/send
заголовок X-Api-Key: <токен бота>
тело (JSON): {"user_id": <id получателя>, "body": "привет"}

Вместо user_id можно указать conversation_id — тогда бот пишет в группу, где он состоит. Отправка файла — POST /api/bot/send_file (multipart: поле file + user_id). Чтобы бот вам написал, он должен знать ваш user_id; узнать чужой id можно у самого пользователя или у бота при первом входящем сообщении.