butmsg — инструкция

Мессенджер: переписка, файлы, голосовые, аудио- и видеозвонки, группы.

📱 Android 🖥 Windows 🌐 Веб
Веб-версия — обновляется автоматически

1. Открытие

Зайдите на butmsg.ru в браузере (Chrome, Edge, Safari, Firefox). Ничего устанавливать не нужно.

Как приложение: в браузере можно «Установить приложение» / «На экран Домой» — откроется в отдельном окне. На iPhone (Safari → Поделиться → «На экран Домой») это к тому же включает уведомления.

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

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

3. Интерфейс

4. Переписка

5. Звонки

В личном чате — кнопки аудио- и видеозвонка. Браузер спросит доступ к микрофону/камере — разрешите. Нужен современный браузер и разрешение на доступ к устройствам.

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

Разрешите уведомления в браузере, чтобы видеть новые сообщения при неактивной вкладке. Полноценные фоновые уведомления надёжнее в установленном приложении (Android/Windows) или в PWA на iPhone.

7. Другие платформы

Для телефона и компьютера есть отдельные приложения — см. вкладки 📱 Android и 🖥 Windows выше или страницу загрузки.

🤖 Боты

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