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

1. Установка

1. Откройте на телефоне страницу загрузки и нажмите «Скачать APK».
2. Откройте скачанный файл (шторка загрузок или «Файлы»).
3. Разрешите установку из «неизвестных источников» для браузера/файлов, если попросит.
4. Play Protect может показать «Неизвестное приложение» — «Установить всё равно».
5. Запустите butmsg и разрешите уведомления.

Требуется Android 7.0 и новее.

2. Вход

Пароля нет. Введите email → «Получить код» → 6 цифр из письма. Если аккаунта ещё нет, он заведётся тут же: приложение предложит никнейм из адреса (латиница, цифры, . _ -, от 3 симв.) — оставьте его или исправьте. Код действует 15 минут, новый можно запросить раз в минуту. Сессия сохраняется — повторно входить не нужно даже без интернета.

3. Главный экран

• Сверху — состояние подключения (зелёный «Подключен …» / красный «Отключен …») и поиск: по вашим чатам сразу, по людям — от 3 букв никнейма.
• Красная плашка появляется, если не выданы разрешения для фона.
• Тап по беседе — открыть; долгое нажатие — удалить чат (личный — у обоих).
• Меню ☰: Профиль, Новая группа, Подключения (журнал входов с IP), Разрешения и фон, Пригласить по email, Проверить обновления, Версия, Выйти. Если вышла новая версия — сверху появляется полоса «Доступно обновление».

4. Переписка

Внизу чата — поле ввода и кнопки:

Кнопка	Действие
📎	Прикрепить файл / фото / видео
😊	Эмодзи
🔍	Поиск по сообщениям этого чата
🎥	Записать видеоролик
🎤	Записать голосовое
➤	Отправить

Галочки: ✓ доставлено, ✓✓ прочитано. Под сообщением — «Ответить» и «Действия» (Изменить, Удалить у меня/у всех, Копировать текст, Переслать, Сохранить). Текст можно выделить долгим нажатием. Ссылки показываются с превью.

5. Медиа, группы, «Поделиться»

• Фото/видео — превью в чате; тап открывает полноэкранный просмотр, картинку можно увеличить щипком. Сохранение: Действия → Сохранить.
• Группы: ☰ → Новая группа. В группе над входящими виден автор. Удалить/выйти — в меню группы (⋮ в шапке).
• «Поделиться» из другого приложения → выберите butmsg и беседу.

6. Звонки

В шапке личного чата — 📞 (аудио) и 📹 (видео). Входящий показывается полноэкранно, в том числе поверх заблокированного экрана, и дублируется на часы. В группах звонков нет.

7. Уведомления и работа в фоне

Чтобы звонки и сообщения приходили в свёрнутом виде — ☰ → «Разрешения и фон» (видно, что включено, есть «Исправить»):

• Уведомления включены (каналы «Сообщения» и «Звонки»).
• Батарея → «Без ограничений» для butmsg.
• Android 14+: «Полноэкранные уведомления» (экран звонка).
• Xiaomi/Huawei/Oppo/Vivo и т.п.: включить «Автозапуск».

Справочник по прошивкам — dontkillmyapp.com.

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

Приложение обновляет себя само: нажмите полосу «Доступно обновление» сверху (или ☰ → Проверить обновления) — APK скачается прямо в butmsg и уйдёт на установку. Браузер и файловый менеджер не нужны. В первый раз Android попросит разрешить butmsg установку приложений — приложение само откроет нужный экран настроек; дальше обновления ставятся в одно нажатие, а на Android 12 и новее чаще всего вообще без вопросов. После установки butmsg открывается сам (если система не пустит — придёт уведомление «butmsg обновлён», нажмите его). Данные и вход сохраняются. Свежий APK по-прежнему лежит и на странице загрузки (текущая версия — 1.0.147).

🤖 Боты

Через служебного бота 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 можно у самого пользователя или у бота при первом входящем сообщении.