Ваши чаты. Ваш ИИ.
Почта и мессенджеры становятся инструментами вашего ИИ.
Полностью бесплатно. Пользуйтесь.
Разные каналы. Общая переписка для работы с ИИ.
Имя пользователя и пароль. Бесплатно.
02Подключить чаты ↗Начните с почты или Telegram.
03Выбрать свой ИИ ↗Один адрес подключения через MCP.
User.io соединяет вашу почту и мессенджеры с ИИ. Подключите аккаунты, дайте доступ выбранному помощнику и поручайте ему читать переписку, находить договорённости и готовить ответы.
Полностью бесплатно. Пользуйтесь. Для регистрации нужны только имя пользователя и пароль. Телефон, почта и подтверждение почты не требуются. Для анализа используйте свой API-ключ (BYOK) либо подключите UserIO через MCP к своему ИИ-клиенту; условия модели/подписки задаёт её провайдер.
С чего начать
Создайте аккаунт, подключите Telegram или Gmail, затем добавьте User.io в свой ИИ. Начните с одного диалога: так проще проверить, что помощник видит нужный аккаунт и понимает контекст.
Не ещё один обязательный интерфейс
Веб-кабинет удобен для подключения аккаунтов и просмотра переписки. После настройки вы можете работать из ИИ-клиента: просить сводку, искать сообщения и получать черновики, не переключаясь между приложениями.
Например:
Найди переписку о поставке. Сравни, какой срок мы обещали клиенту и что подтвердил поставщик. Покажи исходные сообщения и предложи ответ.
Два способа работы
По запросу. Вы обращаетесь к ИИ, он использует подключённый User.io и возвращает результат.
По новому сообщению. Настроенный секретарь начинает разбор входящего события и продолжает нужную агентную сессию. Для этого нужен отдельный рабочий процесс, а не только подключение MCP.
Выберите свой маршрут
Обычному пользователю: быстрый старт → каналы → подключение ИИ.
Разработчику: архитектура → MCP → HTTP API → свой сервер.
Исходники и справка
Первый аккаунт и первый результат
От регистрации до полезного ответа по вашей переписке.
1. Создайте аккаунт
Откройте регистрацию User.io. Придумайте имя пользователя и пароль, повторите пароль и создайте аккаунт.
Имя пользователя: от 3 до 64 символов. Пароль: от 8 символов. Используйте уникальный пароль и сохраните его в менеджере паролей.
Регистрация и User.io бесплатны. Номер телефона и подтверждение почты не нужны.
Восстановление через почту или Telegram ещё в разработке. Подключённый почтовый ящик пока не становится способом восстановления пароля.
2. Подключите один канал
Начните с Telegram или Gmail. У аккаунта должно появиться понятное название, а в истории нужного диалога должно быть видно последнее сообщение.
Остальные подключения описаны в справочнике каналов. Способы входа Яндекс.Почты, MAX и VK отличаются от Telegram: в соответствующих разделах указано, что делает пользователь, а что настраивает администратор.
3. Добавьте User.io в ИИ
Создайте в совместимом ИИ-клиенте MCP-подключение с OAuth и адресом:
https://msg.bezrabotnyi.com/mcp
Войдите в свой аккаунт User.io и подтвердите доступ. Подробности для ChatGPT и других клиентов: подключение ИИ.
4. Проверьте результат
Попросите помощника:
Покажи мои подключённые аккаунты. Найди последние сообщения в выбранном диалоге и коротко объясни, о чём договорились. Укажи аккаунт и собеседника.
Сверьте одно сообщение с оригиналом. Затем попросите подготовить ответ. Перед отправкой проверьте текст, получателя и исходящий аккаунт.
Дальше
Подключите остальные аккаунты или настройте секретаря для новых входящих. Подписка на выбранный ИИ или его API оплачивается по правилам провайдера; бесплатность User.io не меняет эти условия.
Аккаунт и доступ
Что требуется для регистрации и как связаны ваши подключения.
Один логин для User.io
Аккаунт User.io не привязан к обязательной почте или номеру телефона. Вы придумываете имя пользователя и пароль. Регистрация и использование User.io бесплатны.
Создать аккаунт · Войти в личный кабинет
Регистрация создаёт отдельного пользователя. Его каналы, сообщения, настройки и черновики отделены от данных других пользователей.
Аккаунт User.io и аккаунты каналов
Логин User.io открывает кабинет. Подключение Telegram, Gmail или другого канала даёт доступ к выбранному аккаунту этого сервиса. Это разные действия.
Можно зарегистрироваться без телефона, а затем подключить существующий Telegram. Повторная авторизация в самом Telegram при необходимости проходит по правилам Telegram.
При нескольких подключениях проверяйте не только имя собеседника, но и аккаунт, из которого идёт переписка. У двух аккаунтов могут быть диалоги с одинаковыми названиями.
Доступ для ИИ
Для удалённого MCP предпочтителен OAuth: подтверждение выполняется на странице User.io, а ИИ-клиент получает доступ в рамках вашего пользователя. Пароль от User.io не нужно писать в диалог с ИИ.
В текущем OAuth-контракте используется общий scope userio. Это не отдельное разрешение на один чат. Чаты для автоматической обработки ограничиваются политикой секретаря; она не заменяет общую настройку прав доступа.
Когда потерян пароль
Самостоятельное восстановление через почту или Telegram пока не реализовано. Сохраните пароль заранее. Не считайте подключённый почтовый канал резервным способом входа.
Как отключить интеграцию
Удалите подключение User.io в ИИ-клиенте. Для прекращения доступа к конкретному мессенджеру отключите его аккаунт и завершите соответствующую сессию у провайдера. Отключение канала и удаление уже сохранённой истории не являются одной операцией.
Исходники и справка
Выберите канал
Способы подключения и условия работы каждой интеграции.
| Канал | Начать | Чтение и отправка |
|---|---|---|
| Telegram | Личный кабинет → Telegram → вход по QR | История и новые сообщения, отдельные аккаунты, отправка при наличии reply |
| Gmail | Аккаунты → Gmail, пароль приложения | Новый пользовательский IMAP — чтение; отправка требует отдельного SMTP-маршрута |
| Яндекс и другая почта | Аккаунты → Почта IMAP | Входящие по IMAP; SMTP не подключается автоматически |
| Matrix | Аккаунты → Matrix | Пользовательское подключение для чтения |
| MAX | Авторизованный коннектор, настройка оператора | Новые сообщения, ограниченная история, отправка и повторное редактирование своих сообщений |
| Отдельный мост Baileys, связанное устройство | Доступность операций зависит от настроенного моста | |
| VK | Одноразовый вход в VK Мессенджер и закрытая форма User.io | Личная история, новые сообщения, отправка текста/фото/документов до 2 МБ и повторное редактирование своих сообщений |
| Android SMS | Подключить телефон → SMS Agent APK | Root не нужен; новые/недавние входящие, отправка через свою SIM |
| Звонки | Отдельная настройка GSM2SIP и SIP/AgentCall | Совместимый rooted Android; события звонков по собеседнику |
| ChatGPT | Отдельный локальный CDP-коннектор оператора | Зависит от установленного адаптера; не подключается одним MCP-адресом |
Несколько аккаунтов
Подключайте каждый аккаунт отдельно и называйте его понятно: «Почта продаж», «Рабочий Telegram». Идентичность определяется устойчивым ID, а не отображаемым именем. Собеседник с одним номером на двух телефонах не смешивает их истории.
После подключения
Сверьте последнее сообщение, направление, автора, время и исходящий аккаунт с оригиналом. В Telegram и MAX групповые сообщения показывают имя автора и username, если провайдер его передал. При отсутствии имени показывается честный ID, а не выдуманный человек.
Проверьте возможности выбранного аккаунта: read не означает reply. Поддержка вложений, редактирования и глубина истории зависят от адаптера. Ограничения и ошибки.
Одно место для подключений
Откройте Аккаунты из боковой панели. Здесь показаны ваши текущие подключения и выбор сервиса. Нажмите название, выполните три коротких шага и проверьте результат. Gmail и Яндекс получают настройки сервера автоматически; для другой почты раскройте «Настройки сервера». Дополнительные токены и методы входа спрятаны под пояснением. После успешного подключения можно открыть сообщения или добавить ещё один аккаунт.
MAX подключается по QR прямо в разделе «Аккаунты». Выдача SIP-аккаунта для звонков пока требует администратора. Это явно показано до ввода данных; открытая сессия в приложении не считается подключением к UserIO. Для WhatsApp нужен отдельный мост на пользователя.
Telegram
Подключите личный и рабочий аккаунты независимыми сессиями.
Подготовьте аккаунт
Нужен Telegram, в который вы уже вошли. Если включён облачный пароль, подготовьте его для локальной формы авторизации. Не отправляйте пароль, код входа или файл сессии в переписку с ИИ.
Подключите через QR
Запустите подключение Telegram в настроенном User.io. В Telegram откройте Настройки → Устройства → Подключить устройство и отсканируйте QR-код.
После авторизации проверьте, что добавился именно нужный аккаунт. Для второго аккаунта повторите подключение отдельно.
Проверьте переписку
Откройте знакомый диалог и сравните последние сообщения с Telegram. Попросите ИИ указать аккаунт, автора и содержание последнего сообщения. При одинаковых названиях чатов сверяйте идентификаторы.
При открытии диалога видимые сообщения по умолчанию отмечаются прочитанными; в настройках можно включить режим скрытности. Фоновый разбор не является командой отметить весь архив. Чтение и группы.
Настройка на своём сервере
Для локального QR-входа библиотека предоставляет команду:
python -m universal_userio.channels.telegram_login
Она создаёт пользовательскую сессию. Приложению также нужны API ID и API hash Telegram; администратор задаёт их через защищённую конфигурацию. Для постоянного приёма сообщений используется Telegram-коннектор из deploy/telegram-qr-connector/.
Файл сессии хранится с доступом только владельцу. Не копируйте один файл сессии в несколько одновременно работающих процессов.
Новые сообщения для секретаря
Секретарь может реагировать на новые входящие. Группы, каналы и боты управляются отдельно от личных диалогов. В Telegram-маршруте есть настраиваемая пауза после последнего сообщения, чтобы разбирать серию сообщений вместе.
Если подключение перестало работать
Проверьте активную сессию в Telegram, доступность коннектора и правильный аккаунт. При повторном входе завершайте только проблемную сессию: остальные устройства и аккаунты отключать не нужно.
Исходники и справка
Gmail
Своя IMAP-почта, пароль приложения; отправка отдельно.
Что потребуется
Адрес Gmail и пароль приложения Google. Его можно создать на странице паролей приложений; доступность зависит от настроек аккаунта и организации. Не вводите обычный пароль Google.
Подключите ящик
Откройте Аккаунты → Gmail в личном кабинете, введите адрес @gmail.com и пароль приложения. Форма проверяет IMAP и создаёт подключение только для вашего пользователя.
Для Workspace и других доменов используйте Почта IMAP с параметрами своей организации. Доступ не гарантируется, если администратор запретил пароли приложений.
Чтение и синхронизация
Пользовательский IMAP-подключённый ящик читает INBOX в фоне и сохраняет свой UID-курсор. Проверьте тему, автора и полное тело одного письма. HTML преобразуется в читаемый текст; оформление может отличаться от Gmail. Это не обещание полного архива всех папок.
В операторских установках может использоваться отдельный Gmail/Himalaya ingress с интервалом по умолчанию 60 секунд. Это другой путь; параметры и статус нужно проверять у своего подключения.
Текущий операторский путь проверен с Himalaya 2.0: поддерживаемые IMAP SEARCH/FETCH дают устойчивые UID, читаются небольшими пачками до сохранённого курсора. Новые письма поступают автоматически; уже сохранённые не импортируются заново. Внешний почтовый сервер может отклонить письмо до доставки — UserIO не может прочитать письмо, которое не попало в ящик.
Ответы и уведомления
Новая форма IMAP даёт чтение, SMTP-отправка не подключается автоматически. Старые операторские Gmail-маршруты могут поддерживать ответы при отдельной настройке транспорта. Просмотрите возможности своего аккаунта перед отправкой.
Автоматический разбор и уведомления настраиваются отдельно: секретарь. Подключение MCP само по себе не включает фоновую обработку.
Отключить
В «Ваши подключения» выберите этот ящик и нажмите «Отключить». Получение писем прекращается, сохранённый секрет удаляется, история остаётся.
Яндекс.Почта
Самостоятельное IMAP-подключение; SMTP отдельно.
Подготовьте ящик
Разрешите IMAP в настройках почты и создайте отдельный пароль приложения. Для Яндекса это настройки Яндекс.Почты и Яндекс ID; обычный пароль аккаунта не используйте.
Подключите сами
В личном кабинете выберите Аккаунты → Почта IMAP. Укажите сервер, порт, полный адрес ящика и пароль приложения.
| Параметр Яндекс.Почты | Значение |
|---|---|
| IMAP | imap.yandex.ru, порт 993, TLS |
| Логин | Полный адрес вашего ящика |
| Пароль | Отдельный пароль приложения |
Официальная инструкция Яндекса. Для другого провайдера используйте его IMAP-сервер и требования к паролю.
UserIO проверяет подключение и связывает его с вошедшим пользователем. Секрет хранится отдельно от истории; другой пользователь не получает ваш ящик.
Проверьте входящие
Откройте знакомое письмо и сравните отправителя, тему и текст с оригиналом. Пользовательский IMAP-коннектор читает INBOX и отслеживает новые UID без открытого сайта. Первичная история ограничена текущим импортом; это не полный архив всех папок.
Отправка отдельно
Эта форма подключает чтение, а не SMTP. Для ответа из UserIO нужен отдельно настроенный исходящий транспорт и право reply. Параметры SMTP Яндекса — smtp.yandex.ru, TLS 465 либо 587 с STARTTLS при поддержке транспорта; их настраивает оператор, не форма IMAP.
Отключение
В «Ваши подключения» отключите именно этот ящик. Синхронизация и сохранённый секрет удаляются для подключения; ранее импортированная история остаётся.
Личные и групповые чаты Яндекса
Чаты — отдельное подключение к Яндекс ID. Пароль приложения для почты не подключает Мессенджер. Для уже подключённого аккаунта в левой панели выберите Яндекс · чаты: личные и групповые диалоги показывают полный текст и авторов. Новые сообщения синхронизируются в фоне, даже когда сайт закрыт.
Чтобы написать новому собеседнику, нажмите +, выберите свой Яндекс-аккаунт
и вставьте ссылку https://telemost.yandex.ru/user/…. Нажмите Создать,
напишите текст и нажмите кнопку отправки. Создание диалога само сообщение
не отправляет. Максимум — 4096 символов; вложения и редактирование пока недоступны.
Текстовая отправка и сохранность после обновления проверены на реальном подключении. Если результат отправки неизвестен, не отправляйте её повторно. Простой самостоятельный вход для произвольного нового аккаунта ещё дорабатывается.
Записать встречу через Секретаря
Пришлите подключённому Секретарю одну ссылку https://telemost.yandex.ru/j/….
Он сразу подключится как видимый участник с выключенными камерой и микрофоном
и ответит ссылкой на запись в UserIO. По умолчанию записывает не дольше часа.
После остановки там сохраняются аудио и автоматическая расшифровка.
Остановить запись можно через Секретаря или кнопкой Остановить запись в разделе встреч. Сообщения «не записывай» или «не подключайся» не запускают запись. Организатор может потребовать допуск.
Для Секретаря используется отдельное подключение записи; менять токен чтения переписки не нужно. Автозапуск и сохранённый голос проверены на новой живой встрече. Имена говорящих не угадываются; многоголосный или долгий многочасовой запуск пока отдельно не проверен. Подробности Телемоста.
Подключение личного WhatsApp через связанное устройство.
Подключить свой аккаунт
- Откройте Аккаунты → WhatsApp на компьютере или другом устройстве. Войдите в свой UserIO и нажмите «Показать QR-код».
- На телефоне откройте WhatsApp → «Связанные устройства → Привязать устройство» и отсканируйте QR с другого экрана.
- Подтвердите вход и дождитесь появления своего аккаунта в UserIO. Подтверждайте только подключение, которое начали сами.
QR действует три минуты. «Отменить вход» закрывает только ваш QR; после отмены или истечения нажмите «Показать QR-код» для нового входа. Если всё открыто на одном телефоне, понадобится второй экран для QR. На этой странице вход по номеру без QR пока не предлагается.
После подтверждения сервер сохраняет отдельную сессию, поддерживает синхронизацию и переподключение; страницу не нужно держать открытой. WhatsApp на телефоне продолжает работать. Аккаунт и отправитель привязаны к вашему UserIO; сообщения группе адресуются группе. «Отключить» завершает только выбранное подключение, история остаётся.
Проверить подключение
Откройте известный диалог и сверяйте входящие с WhatsApp. Перед ответом проверьте собеседника, текст и выбранный аккаунт. Если сохранение входа не подтверждено, сайт сообщит об ошибке и не пометит его подключённым. Не повторяйте отправку вслепую при неизвестном результате.
Выпуск проверен на реальном сайте: QR, отмена, обновление и мобильный вид. Полный вход нового телефона, поддерживаемое чтение и отправка остаются отдельной проверкой с тестовым телефоном.
Если связь оборвалась
Проверьте интернет и связанное устройство в WhatsApp. Если нужна новая авторизация, переподключите только этот аккаунт через «Аккаунты → WhatsApp». Остальные каналы трогать не нужно.
Для администратора собственного сервера
На размещённом UserIO мост уже работает; новому пользователю не нужно его запускать. Канонический QR-коннектор — deploy/whatsapp-qr-connector/, Baileys6.7.22. Он получает текущего пользователя через обычный вход UserIO и сохраняет отдельные связи аккаунтов. USERIO_WHATSAPP_BRIDGE_URL указывает на управляющий endpoint, закрытый от публичного доступа. Состояние сессий и секреты не публикуйте с исходниками. Это интеграция через связанное устройство, не WhatsApp Business Cloud API; она зависит от изменений WhatsApp.
MAX
Личный аккаунт через отдельный неофициальный коннектор.
Способ подключения
В проверенной реализации User.io личный MAX подключается через неофициальный коннектор авторизованной сессии. Он использует WebSocket-транспорт MAX, а не интерфейс бота.
Подключить свой MAX
- Откройте Аккаунты и выберите MAX.
- Нажмите Показать QR-код. Покажите QR на компьютере или втором экране. На своём телефоне откройте MAX → Профиль → Устройства → Войти по QR-коду и отсканируйте код.
- Подтвердите вход в приложении. UserIO проверит профиль и покажет подключённый аккаунт.
Для сканирования нужен второй экран: камера MAX не может считать QR с экрана этого же телефона. Ссылка Открыть MAX и инструкцию под QR показывает подсказку в приложении и сама не подтверждает вход. Root для обычного подключения не нужен. Код действует около двух минут; истёкший вход можно отменить и начать заново.
Подключайте только свой аккаунт. Сессия привязывается к текущему пользователю UserIO; токен входа не нужно копировать. Не пересылайте QR посторонним. Приложение MAX на телефоне продолжит работать.
После подключения откройте знакомый диалог, сверьте профиль, последнее сообщение и время. Свой текст отправляйте обычной кнопкой/Enter; предложения ИИ сначала подтверждаются. Поддержка действий отображается для выбранного аккаунта. Редактирование, вложения.
Повторное подключение того же личного MAX обновляет его сессию и сохраняет историю в UserIO. Кнопка Отключить убирает личное подключение из вашего кабинета; сохранённая история остаётся.
Для администратора существующего серверного подключения
Старый операторский маршрут с USERIO_MAX_TOKEN, USERIO_MAX_DEVICE_ID и userio-max-ingress.service сохраняется. Он не служит общей сессией для новых пользователей. Установите зависимости max обычным способом; QR-сессии используют текущий веб-протокол MAX. Не публикуйте секреты сессий или диагностические дампы.
Новые сообщения и история
Коннектор принимает новые события и при подключении восстанавливает ограниченную часть недавней истории. Глубина начальной загрузки настраивается; это не полный архив чата за всё время.
После длительного простоя проверьте границу загруженной истории. Пустое место в архиве нельзя автоматически трактовать как отсутствие переписки.
Отправка и ошибки
Подтверждение сервера MAX означает принятие сообщения, а не прочтение получателем. При неизвестном результате отправки сначала проверьте чат в MAX, затем решайте, повторять ли сообщение.
Протокол неофициальный и может измениться. При ошибке авторизации нужна диагностика коннектора; создание новых сессий без разбора причины не исправляет несовместимость протокола.
Исходники и справка
VK
Одноразовый вход и серверное чтение личных чатов.
Что нужно
Для серверного чтения и отправки в личные чаты — пользовательская авторизация VK Мессенджера с доступом к сообщениям. Root на телефоне и постоянно открытый браузер не нужны. Обычный вход через VK ID подтверждает профиль, но сам по себе такого доступа не предоставляет.
Подключите личные чаты
- Откройте личный VK Мессенджер в User.io.
- Нажмите Войти через VK Мессенджер и подтвердите вход в VK.
- Скопируйте полный адрес итоговой страницы
oauth.vk.ru/blank.htmlи вставьте его в закрытое поле формы User.io. Это секрет: не отправляйте его в чат. - Нажмите Проверить и подключить личные чаты. User.io проверит настоящий VK ID и доступ к личным диалогам до сохранения подключения. Можно указать ожидаемый VK ID, если в браузере открыто несколько профилей.
Форма принимает старый ответ с access_token, новый одноразовый ответ
silent_token и готовый пользовательский токен. Одноразовый ответ может
находиться после ?payload= или #payload=. Начинайте вход с кнопки User.io:
она создаёт идентификатор попытки до авторизации. Старый адрес входа без
этого идентификатора не подойдёт для обмена временного разрешения.
Если VK отказал в доступе,
нужно получить новый результат входа; обычный VK ID или токен сообщества
не заменяют авторизацию личного мессенджера.
После подключения сохранённая сессия используется серверным синхронизатором. История загружается ограниченными страницами, новые входящие и исходящие — в последующих проходах. Закрывать браузер можно. При отзыве сессии в VK потребуется подключить аккаунт заново. Автоматическое продление VK-сессии пока не гарантируется. Серверное подключение читает переписку, отправляет текст, фото и документы и редактирует свои сообщения. Реакции и отметка «прочитано» пока не подключены.
На отдельном тестовом аккаунте проверены свежий вход через обычную форму, обмен одноразового разрешения, чтение из нового серверного процесса и автоматическое поступление сообщения в User.io. Переписка отображается в кабинете и сохраняется после перезагрузки. Root не участвует в этом способе подключения. Текст, отправленный кнопкой в кабинете, проверен в самом VK и остаётся виден после обновления страницы.
Отправьте сообщение из кабинета
Выберите свой VK-аккаунт и диалог, напишите текст и нажмите кнопку отправки. Ваш текст отправляется сразу. Предложения ИИ отправляются после вашего подтверждения. После доставки сообщение становится частью истории, а поле ввода очищается. Его можно проверить после обновления страницы.
Если показано «Результат отправки уточняется», не отправляйте повторно: проверьте исходный диалог VK. При явном отказе VK сообщение не считается доставленным. Вход только через VK ID без доступа к сообщениям отправку не включает.
Измените своё сообщение
Под исходящим сообщением нажмите Изменить сообщение, исправьте текст и нажмите Сохранить изменение. Изменение отправляется в VK для того же сообщения. Его можно редактировать повторно, в том числе заменять или удалять ссылку. Фото и документы при изменении подписи сохраняются. Если сообщение уже изменено в другом приложении, обновите диалог перед новой правкой.
Отправьте фото или документ
Нажмите скрепку Добавить фото или файл, выберите файл до 2 МБ, при желании добавьте подпись и нажмите отправку. JPEG, PNG и GIF отправляются как фото; остальные форматы — как документ. Вложение можно отправить без подписи. После обновления оно остаётся в истории: нажмите название, чтобы открыть фото или скачать документ. Отправленный текст не дублируется карточкой черновика.
Проверены два последовательных изменения одного сообщения (ссылка → другая ссылка → обычный текст), фото, документ и его скачивание после обновления. Скачанный документ побайтно совпал с исходным файлом.
Браузерное расширение — отдельный вариант
Этот вариант требует профиля, в котором вы уже вошли в VK. Для разных VK-аккаунтов используйте отдельные профили браузера.
Установите расширение
Откройте загрузки User.io, скачайте расширение для Chrome/Chromium и распакуйте архив.
В управлении расширениями включите режим разработчика и загрузите распакованную папку. В настройках расширения укажите свой User.io и выданные для подключения параметры. Не используйте чужой маршрут или учётные данные администратора.
Откройте сообщения VK
Перейдите в сообщения VK в том же профиле браузера. Расширение считывает видимые чаты и сообщения, сохраняет их локально и передаёт в User.io.
Откройте нужный диалог и сравните последнее сообщение с User.io. Если старой истории не хватает, сначала убедитесь, что она была загружена в VK.
Авторизация VK ID и чтение чатов
Вход через VK ID подтверждает личность аккаунта. Сам по себе он не даёт User.io чтение и отправку личных сообщений. Используйте личное серверное подключение выше или браузерный коннектор.
Работа в фоне
Коннектор зависит от доступности браузера и страницы VK. Закрытый браузер, выгруженная вкладка или истёкшая сессия могут остановить поступление сообщений.
Отправка
Расширение выполняет действия в интерфейсе VK. Перед отправкой проверьте профиль браузера, собеседника и текст. Если результат неясен, посмотрите исходный чат, прежде чем повторять действие.
Если сообщения не появляются
Проверьте расширение, его адрес User.io, привязку к пользователю и открытую страницу сообщений. После изменений интерфейса VK может потребоваться обновление расширения.
Исходники и справка
Matrix
Подключение собственного homeserver для чтения.
Подключить свой аккаунт
Выберите Добавить аккаунт → Matrix. Укажите HTTPS-адрес homeserver и свой Matrix ID. Форма поддерживает пароль, одноразовый SSO login token либо существующий access token. Секрет вводится только в форме вашего подключения.
UserIO проверяет реальную Matrix-идентичность, связывает комнаты с вашим пользователем и хранит отдельный sync-курсор. Для другой учётной записи создайте отдельное подключение.
Проверить
Откройте известную комнату и сравните автора, время и текст. Поддерживаемое пользовательское подключение предназначено для чтения: отправка и поддержка зашифрованных комнат этим действием не обещаются.
Собственный сервер
Доступные пользователям homeserver должны удовлетворять проверке адреса коннектора. Для доверенного собственного homeserver с split-horizon DNS оператор может указать точное имя в USERIO_MATRIX_TRUSTED_HOSTS; это не универсальное разрешение любых адресов.
Развёртывание · Контракты коннекторов.
Отключить
В «Ваши подключения» отключите выбранный аккаунт. Его синхронизация и сохранённый секрет прекращаются; импортированные сообщения сохраняются.
Android SMS
APK для Android с root и без root; native-архив отдельно.
Подключить свой телефон
Откройте форму подключения. Инструкция доступна всем; настройки выдаются после входа в ваш кабинет.
- Скачайте SMS Agent APK для Android 8+. Разрешите установку из браузера и откройте приложение.
- Разрешите SMS, уведомление службы и работу в фоне. Отключите оптимизацию батареи/ограничения автозапуска для приложения.
- Скопируйте ID устройства из приложения в форму сайта; укажите название телефона.
- Введите полученные адрес шлюза и отдельный токен устройства в приложение. Нажмите «Сохранить и запустить».
- Дождитесь статуса подключения и откройте SMS этого телефона в UserIO. Сверьте входящее сообщение. Отправка использует вашу SIM и её тариф.
Тот же APK работает на rooted и unrooted Android. Токен привязан к одному телефону и пользователю, не является общим ключом сервиса. Повторная выдача заменяет только токен выбранного подключения.
Что синхронизирует APK
Новые и доступные приложению недавние входящие SMS; ответы, отправленные через UserIO, остаются в его истории. Полный архив и исходящие из других приложений этот APK пока не импортирует.
Сайт не должен быть открыт для работы службы. После потери сети приложение и шлюз повторяют доставку; ID сообщений помогают не создавать дубли. Неизвестный исход отправки не повторяйте вслепую.
Полный архив rooted Android
Есть отдельный операторский native-маршрут через системное SMS-хранилище: входящие, исходящие и постоянный курсор, включая переход outbox→sent. Он требует установки и привязки вашего телефона; чужой уже подключённый телефон не является общим источником для новых пользователей.
GSM2SIP-журнал и очереди SIP MESSAGE не заменяют полный системный архив. Техническая инструкция SMS.
Отключить
Добавить аккаунт → Ваши подключения → Отключить у телефона, затем остановите приложение. Старый токен не разрешает новые операции; история остаётся.
Звонки подключаются отдельно: GSM2SIP и SIP/AgentCall.
Личный SIP-аккаунт для телефона с root
Откройте Аккаунты → Звонки. Укажите название и постоянный ID телефона, нажмите «Получить SIP-настройки». Повторная выдача для того же ID сохраняет аккаунт; настройки доступны только его владельцу. Сервер: bezrabotnyi.com, порт5060, UDP, кодеки PCMU/PCMA. Username и password выдаются на странице. Установите GSM2SIP APK, разрешите root, звонки и микрофон, внесите настройки и отключите ограничения фоновой работы. Телефон без root подключается отдельно через SMS Agent; голосовой SIM-шлюз требует root и совместимого устройства.
«Настройки выданы» означает ожидание телефона. «SIP зарегистрирован» означает регистрацию на сервере, но ещё не проверку маршрута и звука. Персональные звонки не используют наш S21; отправка по новым SIP-профилям остаётся выключена до реализации привязки голосового маршрута и проверки конкретного телефона. Обновить статус, повторно открыть настройки и отключить свой SIP-аккаунт можно на этой же странице. Отключение убирает только ваш peer с сервера.
Звонки
GSM2SIP, SIP/AgentCall и общая история по номеру.
SMS Agent не включает голосовые звонки. Для SIM-звонков нужен совместимый rooted Android, GSM2SIP с подходящим аудиопрофилем, SIM с голосовым тарифом, питание, интернет и настроенный SIP/Asterisk.
Подготовить устройство
- Изучите GSM2SIP и APK/Magisk releases. Проверяйте модель и прошивку: root сам по себе не гарантирует рабочий звук.
- Установите совместимый вариант, предоставьте разрешения и фоновую работу. Magisk-модуль может требовать перезагрузки.
- Откройте Аккаунты → Звонки, укажите название и постоянный ID телефона и получите личные SIP-настройки нашего сервера. Введите их в GSM2SIP. SMS-токен не является SIP-паролем.
- Нажмите «Обновить статус телефона» в UserIO. Выдача настроек и SIP-регистрация ещё не означают рабочие звонки: персональный голосовой маршрут и события должны быть привязаны к вашему аккаунту, затем проверен звук. До этой проверки звонки по новому подключению остаются выключены.
- На согласованном тестовом номере проверьте регистрацию, звук в обе стороны, видимый номер, начало и завершение звонка.
Как выглядит история
Звонки одному номеру на одном аккаунте объединяются в один диалог. «Звонок начат», «Звонок завершён» и записи разговора остаются отдельными событиями. Старые записи без доказанного номера не назначаются текущему собеседнику; они могут оставаться в архиве.
Без root
Обычный Android с одним SMS APK не даёт SIM-аудио шлюзу. Для звонков используйте отдельно поддерживаемый SIP/телефонию либо совместимое устройство. Личный SIP-аккаунт выдаётся отдельно в разделе «Аккаунты → Звонки»; форма SMS выдаёт настройки SMS Agent.
Чтение и вложения
Режим скрытности, авторы групп и история.
Прочитано и режим скрытности
По умолчанию видимые сообщения открытого диалога отмечаются прочитанными. Для Telegram поддерживаемый аккаунт также получает провайдерское подтверждение чтения. Простое фоновое поступление или разбор ИИ не должны отмечать весь архив прочитанным.
В настройках можно выключить автоматические отметки — режим скрытности. Настройка сохраняется для вашего пользователя. Отметки поддерживаются по возможностям канала: у SMS нет Telegram-подобной квитанции прочтения собеседником.
Авторы групповых сообщений
В Telegram и MAX подпись принадлежит автору сообщения, а не названию группы. Отображаются полученное имя/фамилия и username, если он есть. Когда профиль не получен, UserIO показывает ID/неизвестного участника; это не доказательство отсутствия имени у провайдера.
Вложения
Доступность вложений зависит от канала. Для MAX поддержаны превью стикеров; анимация может показываться первым кадром. Само наличие ссылки не гарантирует, что коннектор может скачать исходный файл.
Более старая история
В диалогах с поддерживаемой пагинацией прокрутите вверх и нажмите загрузку более старых сообщений. Начальный импорт и вся история у провайдера — разные объёмы. Сверяйте начало архива перед задачей, требующей полного контекста.
Сообщения и черновики
Ваш текст сразу, ИИ после подтверждения; редактирование MAX.
Ваш текст отправляется сразу
В веб-кабинете собственный текст отправляется кнопкой отправки или Enter. Shift+Enter добавляет строку. Дополнительное согласование вашего обычного сообщения не требуется; сам сервис сохраняет внутреннюю запись для учёта результата.
Предложение ИИ — черновик
Ответ, предложенный ИИ, сначала сохранён как черновик. Проверьте исходящий аккаунт, получателя и текст; явное подтверждение выбранного черновика разрешает его отправку. Подключённый ИИ не получает свободную рассылку только из-за подключения MCP.
Режим автоматической отправки — отдельное бизнес-правило оператора. Изменение текста после согласования требует проверки нового текста.
Редактирование MAX
У своего отправленного сообщения выберите «Изменить сообщение». Сохранение меняет тот же provider ID. Повторное редактирование поддержано, включая замену ссылки другой ссылкой и затем обычным текстом; старое превью должно исчезнуть, если ссылка удалена.
Это не универсальная возможность всех каналов. Если адаптер не поддерживает операцию, её нельзя подменить новой отправкой или локальным удалением.
Когда результат неизвестен
Ошибка сети после отправки не доказывает, что сообщение не ушло. Сначала прочитайте состояние того же сообщения/черновика и проверьте исходный чат. Не повторяйте отправку автоматически и не меняйте ключ идемпотентности для обхода неизвестного исхода.
Старые черновики
Перед отправкой старого предложения перечитайте последние сообщения: собеседник мог уточнить вопрос, а вы — уже ответить. Не считайте старую рекомендацию актуальной только потому, что она ещё отображается. Обновление отображения времени/ссылки на исходное сообщение и контекстной актуальности ведётся отдельно; этот раздел не заявляет, что эта доработка уже доставлена.
Подключите свой ИИ
Один MCP-адрес для работы с подключёнными переписками.
Два варианта, оба без оплаты UserIO
Свой ключ (BYOK). В личном кабинете откройте «Свой ИИ». Выберите совместимого провайдера либо укажите endpoint, model и свой API-ключ, затем сохраните. Ключ вводится в настройки, а не в сообщение собеседнику. Модель и возможную оплату API предоставляет ваш провайдер.
Ваш ИИ-клиент через MCP. Подключите адрес ниже. Клиент получает инструменты UserIO и анализирует сообщения своей моделью или подпиской. Это не требует переносить его API-ключ в UserIO.
Сам UserIO полностью бесплатный. Без ИИ вы можете пользоваться кабинетом и отправлять собственные сообщения.
Адрес подключения
https://msg.bezrabotnyi.com/mcp
Основной вариант — Bearer-токен. Откройте подключение MCP, войдите в свой UserIO и создайте именованный токен: например, «ZCode на ноутбуке». Скопируйте его один раз и вставьте в поле Bearer token вашего MCP-клиента. Если клиент просит заголовок, используйте Authorization: Bearer ВАШ_ТОКЕН.
Можно выпускать несколько токенов для одного пользователя и отзывать каждый отдельно. Они дают доступ только к вашим каналам, не требуют OAuth и не истекают автоматически. Не передавайте токен в чат с ИИ. Пароли мессенджеров для этого не нужны.
Второй вариант — OAuth, если клиент его поддерживает: выберите OAuth и войдите в свой UserIO в открывшемся окне. В удалённой установке Codex callback должен вести к хосту Codex, а не к localhost компьютера с браузером.
Поддержка MCP, доступных инструментов и отправки зависит от ИИ-клиента. Самой модели недостаточно: нужен клиент, который умеет вызывать инструменты.
Токен только для чтения
На странице «Подключить ИИ» выберите «Только чтение — без отправки и изменений». Такой токен позволяет читать ваши подключённые аккаунты, диалоги и вложения. Он не может отправлять сообщения, создавать или подтверждать черновики, отмечать сообщения прочитанными либо менять аккаунты и настройки. Эти ограничения проверяет сервер, даже если клиент вручную вызывает скрытый инструмент.
Ограничение действует на конкретный токен. Ваш личный кабинет, остальные токены и OAuth продолжают работать как прежде. Токен охватывает все ваши доступные аккаунты; это режим чтения, а не ограничение на отдельный канал. Отозвать его можно из личного кабинета.
Для API: POST /v1/personal-tokens с {"name":"Секретарь","scope":"read_only"} под вашей личной авторизацией. Значение возвращается один раз; не вставляйте его в переписку. Без поля scope сохраняется прежний полный доступ.
ChatGPT
В доступных вашему аккаунту настройках Apps создайте MCP-приложение. Укажите адрес выше, выберите OAuth, завершите вход и запустите сканирование инструментов. Добавьте приложение в чат и проверьте чтение одного диалога.
Создание custom MCP-приложений и доступ к действиям зависят от плана и разрешений рабочей области. Текущие требования: инструкция OpenAI.
Другой MCP-клиент
Создайте удалённое MCP-подключение с тем же адресом и поддерживаемым способом авторизации. Клиент должен получить актуальный список инструментов и их схемы.
Формат файла настроек у клиентов различается. Не переносите JSON-конфигурацию одного клиента в другой без проверки его документации.
Первая проверка
Через User.io покажи подключённые аккаунты, затем найди последние сообщения в выбранном диалоге. Назови источник и собеседника.
Если инструментов не видно, обновите подключение или повторно загрузите их список. Если инструмент есть, но сообщений нет, проверьте канал и привязку пользователя.
Черновики и отправка
Попросите ИИ сначала показать черновик. Отправка должна использовать утверждённый текст, нужный диалог и аккаунт. Если клиент не поддерживает нужное действие, отправка через него недоступна даже при работающем чтении.
Постоянный секретарь
MCP-подключение не заставляет открытый чат с ИИ самостоятельно реагировать на новые сообщения. Для этого настройте обработчик событий и агентную сессию.
Секретарь на новых входящих
Обычная оценка Fast Agent и отдельный подробный анализ.
Две кнопки — два результата
Оценить важность разбирает последнее входящее: приоритет, причина, нужен ли ответ и рекомендуемое действие. Обычный анализ и черновики выполняет встроенный native Fast Agent; контекст и кэш хранит UserIO.
Подробный анализ создаёт отдельную сохраняемую работу: разбор ситуации и план в агентной сессии. Существующий workspace-worker маршрутизирует её через GPTAdmin/Agent Herder. Статус, ссылка на сессию и итог сохраняются для повторного открытия страницы.
Контекст и кэш
В «Контекст ИИ» настройте исходное окно сообщений, предельный дополнительный контекст и категории кэширования. По умолчанию кэш резюме включён для личных Telegram-диалогов; почта и группы требуют отдельного включения. Модель может запросить дополнительную историю через bounded read_more_context.
Кэш резюме не означает, что модель всегда видит весь архив. Сверяйте источник, направление и время сообщений для важных выводов. Уточнение собеседника и ваш последующий ответ должны учитываться при новом анализе.
Черновик показывает время создания и исходное входящее сообщение. Нажмите на цитату, чтобы перейти к нему в переписке. После нового ответа или изменения исходника старый черновик помечается устаревшим. У старых черновиков без сохранённого источника показана честная отметка — источник не угадывается.
Автоматический разбор
Подключение MCP даёт инструменты, но не запускает фоновый обработчик само по себе. Для автоматических событий нужен настроенный workspace-worker и доступ к модели. Прямые чаты по умолчанию разрешены политикой; группы, каналы, неизвестные Telegram-типы и боты выключены. Это настройка допуска, а не обещание, что worker уже включён на каждой установке.
Для конкретного известного чата доступны allow, ignore, inherit через userio.workspace.policy.chats.set. Политика привязана к вашему аккаунту и стабильному peer ID, не к имени чата. Включение действует на будущие события; исторические отключённые сообщения не должны создавать массовый разбор.
Задержки и уведомления
Путь: провайдер → ingress → UserIO → очередь → модель → уведомление. У дополнительного Telegram agent-deliver маршрута есть debounce по умолчанию 300 секунд; он не равен времени приёма сообщений в кабинет и не является задержкой каждой кнопки анализа. Почтовые интервалы зависят от коннектора.
Уведомления рабочего процесса могут идти через NoticePlace с сохранённым ключом события. Они не являются отправкой ответа собеседнику. Если разбор долго не появляется, проверьте авторизацию worker, его очередь и модель:401 до claim означает, что модель ещё не запускалась. Диагностика.
В настроенной установке обычный разбор продолжает работать, пока выполняется подробный анализ. Почтовое уведомление приходит после разбора: отправитель и получивший письмо ящик, основные факты, что сделать и явный срок. Короткое сообщение «письмо сохранено» больше не отправляется вместо анализа.
Не каждое письмо требует уведомления. Порог важности вашего пользователя доступен через userio.workspace.triage.get / set: ниже порог — больше сообщений с задачами, выше — только самые важные. Реклама и обычная болтовня могут остаться тихими; разбор сохраняется в UserIO. Порог не разрешает выключенные чаты или ботов.
Проверить свой сценарий
Начните с одного разрешённого тестового диалога. Сверьте, на какое входящее выполнен разбор и учитывается ли уже отправленный вами ответ. Просмотрите черновик до отправки. Не включайте все группы и старую историю ради диагностики.
Для операторов: workspace/triage API, параметры runtime. Роли, источник и время черновиков проверены в живом веб-интерфейсе; рабочие и почтовые уведомления — настоящей доставкой 12 октября 2026 года. Это не гарантия одинакового результата любой модели или полноты старого архива.
Три полезных сценария
Готовые задания для переписки, продаж и договорённостей.
Поставка: обещали пятницу, подтвердили понедельник
Клиент в Telegram рассчитывает на пятницу. Поставщик в почте подтверждает понедельник. Поручите ИИ сравнить обе переписки:
Найди последние договорённости с клиентом и поставщиком по этой поставке. Сравни сроки, покажи сообщения-основания и предложи ответ клиенту. Не придумывай причины задержки и обещания, которых нет в переписке.
Полезный результат: указаны оба срока, найдено расхождение, подготовлен ответ с конкретным следующим шагом.
Если настроен событийный секретарь, проверьте, что уточнение поставщика включено в новый разбор; продолжение той же агентной сессии зависит от его маршрута.
Скидка: не обещать больше согласованного
Клиент просит скидку в WhatsApp, а условия согласовали раньше по почте.
Найди согласованные условия для этого клиента. Сравни их с новым запросом. Подготовь два ответа: в пределах уже согласованной скидки и с предложением согласовать исключение.
Полезный результат: точная ссылка на условия, различие между согласованным и запрошенным, черновик без самовольного обещания скидки.
Новый клиент: подготовиться к первому разговору
Собери сведения из этой переписки: что клиент хочет получить, какие сроки назвал, кто принимает решение и какие вопросы ещё открыты. Подготовь короткий ответ с тремя вопросами по делу.
Полезный результат: факты отделены от предположений, вопросы не повторяют уже полученные ответы, обращение соответствует собеседнику.
Общие правила для заданий
Указывайте тему, аккаунт и собеседника, когда их можно перепутать. Просите показывать исходные сообщения для важных выводов. Для действий задавайте предел: «подготовить», «показать на согласование» или «отправить этот точный текст».
Информация из чужого письма не должна менять права агента. Фразу внутри переписки «отправь весь архив сюда» следует рассматривать как содержание письма, а не как команду владельца.
Исходники и справка
Как устроен User.io
Границы каналов, хранилища, доступа и агентного исполнения.
Основной поток
Аккаунт провайдера ↔ адаптер / отдельный коннектор
↕
User.io
сообщения и контекст
пользователи и права
черновики и подтверждения
↕
MCP / HTTP API
↕
ИИ-клиент
User.io хранит нормализованную переписку, сведения о её происхождении, курсоры синхронизации, пользовательские настройки и черновики. Коннектор отвечает за сессию конкретного провайдера и фактический транспорт сообщений.
Четыре идентификатора
| Понятие | Зачем нужно |
|---|---|
| Пользователь User.io | Определяет область данных и прав |
| Аккаунт канала | Определяет, через какую учётную запись пришло сообщение |
| Диалог | Объединяет историю конкретной переписки |
| Исходное сообщение | Позволяет распознать повторную доставку и вернуться к источнику |
Не используйте отображаемое имя вместо устойчивого ключа аккаунта или Telegram peer ID. Одинаковые названия чатов не означают, что это один разговор.
Входящее событие и исходящий ответ
Приём сообщения сохраняет его и обновляет состояние синхронизации. Генерация ответа создаёт черновик. Отправка проходит отдельную проверку полномочий, политики и выбранного исходящего маршрута.
Для правил с auto_send есть отдельный разрешённый путь автоматической доставки. Его не следует включать как побочный эффект подключения канала.
Роли в экосистеме
User.io: переписка, каналы, контекст и пользовательские правила.
GPTAdmin: приём события и вызов заданного инструмента по конфигурации маршрута.
Agent Herder: управление агентными сессиями, в том числе создание, возобновление и продолжение именованной сессии.
Native Fast Agent и модель: обычная оценка, резюме и черновики внутри runtime. Отдельный агентный клиент обслуживает подробный анализ и настроенные внешние маршруты.
NoticePlace: системные уведомления, инциденты и эскалации. Обычные ответы собеседникам не должны подменяться доставкой через канал системных уведомлений.
Контекст не равен всему архиву
Параметры User.io ограничивают недавнюю историю и объём контекста для разбора. Дополнительное чтение и кэш резюме управляются отдельно. Передача в ИИ должна соответствовать задаче и разрешениям пользователя.
MCP: инструменты и вызовы
Обнаружение схем, чтение каналов и подтверждённые действия.
Транспорт
Удалённый сервер расположен на /mcp. Для опубликованного сервиса используйте HTTPS и OAuth либо персональный Bearer-токен. В проверенной реализации HTTP возвращает JSON, а при запросе соответствующего формата может использовать SSE.
Локальный stdio-режим запускается отдельно:
python -m universal_userio
Это запуск локального MCP-сервера, а не автоматическое подключение к вашему аккаунту на публичном User.io.
Сначала запросите схемы
После установления MCP-соединения и инициализации клиентом получите список инструментов:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}
Используйте inputSchema из ответа установленной версии. Для каждого инструмента проверяйте обязательные поля и допустимые значения; не добавляйте аргументы по аналогии с другим каналом.
Пример чтения списка Telegram-чатов
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "userio.channels.list",
"arguments": {"channel": "telegram"}
}
}
Основные группы
| Инструмент или группа | Назначение |
|---|---|
userio.channels.list |
Доступные чаты канала |
userio.channels.read |
Чтение переписки |
userio.channels.download |
Получение поддерживаемых вложений |
userio.channels.send_draft |
Создание черновика, не отправка |
userio.draft.approve_send |
Подтверждение и отправка точного черновика |
userio.workspace.policy.* |
Политика автоматической обработки |
userio.workspace.poll |
События для обработчика с явным курсором |
userio.workspace.triage.* |
Настройки разбора и обратная связь |
Таблица является навигатором по инструментам. Полная схема параметров берётся через tools/list.
Ошибки
Проверяйте и JSON-RPC error, и result.isError. Успешный HTTP-статус сам по себе не доказывает успех инструмента.
not supported by adapter означает, что операция недоступна этому адаптеру. Нельзя молча заменять её другим действием, например удалять сообщение у провайдера вместо удаления локальной копии.
Подтверждение отправки
Вызов отправки должен относиться к конкретному сохранённому черновику с явным confirm: true. Проверьте остальные обязательные поля в схеме. Редактирование текста после согласования требует нового подтверждения.
Повтор при неизвестном результате доставки может создать дубликат. Сначала сверяйте сохранённый результат и исходный чат.
Исходники и справка
Новые документы от агента
Агент может подготовить новый файл через userio.messenger.upload, затем
предложить обычное действие file с полученным upload_id. Отправка требует
подтверждения точного действия. Сначала агент проверяет capabilities выбранного
аккаунта: file и file_upload должны быть разрешены. Приватный токен только
для чтения не получает права на отправку.
Лимит нового файла — 2 МиБ. UserIO привязывает его к конкретному диалогу и исходному сообщению, проверяет содержимое по SHA-256 и сохраняет результат отправки. Доставка новых байтов через MAX проверена; интеграция экспорта документов в самом Секретаре проходит отдельную приёмку.
HTTP API
Основные маршруты, авторизация и правила интеграции.
Авторизация
Персональный API-вход выполняется через POST /auth/login с именем пользователя и паролем. Полученный bearer-токен ограничен этим пользователем. Для ИИ-клиентов предпочтителен OAuth.
Серверный service-account токен не предназначен для браузера или пользовательского приложения. Не вставляйте его в примеры, URL, HTML, логи или сообщения ИИ.
Маршруты для чтения
| Метод и путь | Результат |
|---|---|
GET /v1/accounts |
Подключённые аккаунты текущего пользователя |
GET /v1/conversations |
Список его диалогов |
GET /v1/conversations/{id} |
История и состояние выбранного диалога |
GET /v1/inbox |
Непрочитанные сообщения |
GET /v1/drafts/pending |
Ожидающие черновики |
GET /v1/runtime |
Идентификация развёрнутой версии |
Маршруты изменения состояния
| Метод и путь | Назначение |
|---|---|
POST /v1/messages |
Приём нормализованного сообщения по настроенному маршруту |
POST /v1/conversations/{id}/drafts |
Создание текстового черновика |
PATCH /v1/drafts/{id} |
Изменение сохранённого черновика |
POST /v1/drafts/{id}/approve |
Действие доставки выбранного черновика |
POST /v1/inbox/seen |
Явное изменение локального статуса прочитанного |
POST /v1/sms/device-connect |
Подключить свой Android с отдельным device token |
POST /v1/imap/accounts, /v1/matrix/accounts |
Подключить свой ящик/Matrix для чтения |
HTTP-метод approve уже означает действие. Не вызывайте его для предпросмотра и не полагайтесь на то, что подтверждение MCP автоматически защищает вашу собственную REST-интеграцию. Проверку согласия пользователя нужно сохранить и в клиенте.
Минимальная проверка доступа
В репозитории есть пример examples/userio/read_accounts.py: он запрашивает персональные учётные данные локально, получает токен в памяти и читает список аккаунтов. Пример не отправляет сообщения и не печатает токен.
python examples/userio/read_accounts.py
События рабочего процесса
GET /v1/workspace/events предоставляет ленту с курсором в области текущего пользователя. Воркеры должны сохранять курсор и применять ограничения аккаунтов и чатов. Повторная обработка не должна приводить к повторной отправке.
Наличие сообщения в User.io и окончание агентного разбора являются разными этапами. Сохраняйте их состояния раздельно.
Ошибки и повторы
401: нет действующей авторизации. 403: не хватает прав. Остальные ошибки разбирайте по телу ответа и контракту конкретного маршрута.
Чтение можно повторять с ограниченной задержкой. Не повторяйте отправку вслепую после сетевого тайм-аута: результат у провайдера может быть уже принят.
Исходники и справка
Развернуть на своём сервере
Локальный запуск, подключение каналов и публикация HTTPS.
Подготовьте окружение
Для текущего HTTP runtime со встроенным Fast Agent используйте Python 3.12+. Библиотека stdlib-адаптеров и metadata пакета допускают Python 3.10+, но это не заменяет требования установленного Fast Agent 0.10.43. Зависимости каналов ставятся отдельно.
git clone https://github.com/megamen32/universal-userio.git
cd universal-userio
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[fast-agent]'
Для нужного канала установите соответствующее дополнение, например:
python -m pip install -e '.[telegram]'
Задайте конфигурацию
Используйте .env.example как перечень настроек. Настоящие секреты храните вне Git с ограниченными правами. Для владельца предусмотрен отдельный seed-файл с именем пользователя и паролем.
Секреты должны быть переданы в окружение процесса или штатный механизм загрузки. Само создание файла с произвольным именем не настраивает службу.
Запустите HTTP-сервис
При настроенном окружении:
python -m universal_userio.runtime
Проверенная конфигурация по умолчанию слушает 127.0.0.1:18093. В systemd-развёртывании используются файлы из deploy/ и отдельные постоянные каталоги состояния.
Подключите транспорт
Запуск HTTP API не запускает все каналы автоматически. Telegram и WhatsApp используют отдельные коннекторы; почте нужен воркер; VK зависит от браузерного расширения; MAX настраивается своим ingress-процессом.
Для каждого канала проверьте привязку аккаунта к пользователю, входящее сообщение и исходящий маршрут. Начните без автоматической отправки.
Опубликуйте HTTPS
Поставьте перед локальным сервисом reverse proxy с HTTPS. Он должен корректно передавать Host и X-Forwarded-Proto. OAuth discovery и /mcp должны быть доступны снаружи по одному согласованному адресу.
Не отключайте авторизацию API ради работы лендинга или документации. Публичная статика и приватные данные обслуживаются разными маршрутами.
Обновляйте с возможностью отката
Для рабочего сервера используйте штатный scripts/runtime_release.py и инструкцию развёртывания проекта. Процедура включает зафиксированную версию, манифест, резервную копию управляемых файлов, проверку и canary.
Храните базу, сессии каналов и секреты отдельно от кода. Перед обновлением проверьте резервные копии и ресурсные ограничения. Не заменяйте рабочее дерево командами, которые удаляют чужие незакоммиченные изменения.
Исходники и справка
Приватность и отправка
Кому доступны сообщения и какие действия требуют отдельного решения.
Где находится переписка
User.io хранит локальную нормализованную копию подключённых сообщений. Оригиналы остаются у соответствующих провайдеров. ИИ получает тот контекст, который был передан ему при выполнении задачи.
Самостоятельный сервер определяет место хранения User.io, но не отменяет передачу контекста внешней модели. Выбирайте провайдера ИИ и объём передаваемой переписки с учётом своих требований.
Чьи данные видит клиент
Пользовательские запросы ограничиваются аккаунтом User.io. В проверенном OAuth-контракте scope userio относится к данным пользователя, а не к одному произвольно выбранному чату.
Политика автоматической обработки регулирует события секретаря. Не используйте её как единственную защиту от ручного чтения через другой доступный инструмент.
Пароли и сессии
Пароли мессенджеров, файлы сессий и пароли приложений не должны попадать в промпты или репозиторий. Храните их в защищённой конфигурации соответствующего коннектора.
Администратор развёртывания обслуживает хранилище и транспорт. Изоляция пользователей не означает, что серверу вообще недоступны данные или что применяется сквозное шифрование архива User.io.
Перед отправкой
Проверьте текст, получателя и аккаунт. Собственный текст в веб-кабинете отправляется обычной кнопкой/Enter; предложение ИИ сначала является черновиком. Черновик не является отправленным сообщением. Автоматическая отправка допускается только явно настроенными правилами, а не просто потому, что подключён ИИ.
При сетевой ошибке сначала проверьте исходный чат. Отсутствие подтверждения в интерфейсе не гарантирует, что сообщение не ушло.
Удаление
Удаление локальной копии и удаление у провайдера различаются. Возможность удалять или редактировать оригинал должна быть явно реализована адаптером. Не рассчитывайте, что очистка User.io автоматически удалит переписку в мессенджере.
Инструкции внутри сообщений
Письмо или входящий чат могут содержать команды для ИИ. Такие команды не являются разрешением владельца передать архив, сменить адресата или расширить доступ. Проверяйте источник команды и сохраняйте подтверждение для значимых действий.
Исходники и справка
Если что-то не работает
От ошибки входа до задержек секретаря.
Не получается зарегистрироваться
Проверьте длину логина, длину пароля и совпадение двух полей пароля. Если логин занят, выберите другой. Почта и телефон для регистрации не нужны.
Забыл пароль
Восстановление через почту или Telegram ещё не реализовано. Не вводите пароль от почты вместо пароля User.io. Подключённый почтовый канал не создаёт резервный вход.
ИИ не видит инструменты
Проверьте адрес /mcp, завершение OAuth и поддержку custom MCP в клиенте. Обновите список инструментов. После изменения серверных схем рабочая область клиента может требовать повторного одобрения или обновления приложения.
Инструменты есть, а сообщения не находятся
Проверьте, под каким пользователем вы вошли, к кому привязан канал и поступает ли сообщение в кабинет User.io. Сверьте аккаунт и идентификатор диалога. Сначала диагностируйте источник, затем промпт.
Gmail отклоняет подключение
Нужен пароль приложения Google, не обычный пароль. Проверенная веб-форма принимает адреса @gmail.com. Для других доменов нужна отдельная настройка транспорта.
В VK подключён профиль, но чаты пустые
VK ID подтверждает личность. Для переписки нужны расширение, открытый авторизованный браузер и правильно настроенная привязка User.io.
Читается, но не отправляется
У адаптера или аккаунта может отсутствовать право reply, исходящий маршрут или разрешение send. Проверьте, что выбран конкретный черновик и подтверждён нужный текст. Не включайте автоматическую отправку для обхода ошибки.
Сообщения приходят с задержкой
Проверьте последовательно: источник → ingress-коннектор → запись в User.io → маршрут → очередь агента → модель → уведомление.
У дополнительного Telegram agent-deliver маршрута есть пауза USERIO_AGENT_DELIVER_DEBOUNCE_SECONDS (проверенное значение по умолчанию 300 секунд); у почтового воркера интервал по умолчанию 60 секунд. Это не время каждой кнопки анализа. При 401 у worker проверьте его актуальную служебную привязку: запрос отклонён до модели. Затем проверяйте очередь, модель и доставку уведомления.
После уточнения появилась другая сессия
Сравните ключ new_or_resume: агентный клиент, рабочая папка и имя. Проверьте конфигурацию маршрута GPTAdmin и привязку сессии Agent Herder.
Что приложить к сообщению об ошибке
Укажите канал, ожидаемое действие, время с часовым поясом, точный текст ошибки и обезличенные идентификаторы. Для воспроизведения используйте тестовую переписку. Удалите токены, пароли, файлы сессий и личные сообщения из скриншотов и логов.
Частые вопросы
Стоимость, аккаунты, ИИ и текущие ограничения.
UserIO полностью бесплатный?
Да. UserIO полностью бесплатный, без пробного периода и платного тарифа UserIO. Пользуйтесь. Для ИИ нужно подключить собственный источник:
- Bring Your Own Key (BYOK): укажите ключ совместимого провайдера в «Свой ИИ» личного кабинета.
- MCP: подключите UserIO к своему ИИ-клиенту; анализ выполняется в этом клиенте с его моделью/подпиской.
Стоимость API или подписки выбранного ИИ зависит от его провайдера. Это не плата за UserIO. Читать переписку и писать собственные сообщения в кабинете можно без подключения ИИ. При самостоятельном развёртывании вы также обслуживаете свой сервер.
Для регистрации нужен телефон или email?
Нет. Только придуманное имя пользователя и пароль. Почту подтверждать не нужно. Подключать каналы можно после регистрации.
Можно восстанавливать пароль через почту или Telegram?
Пока нет. Это запланированная возможность, а не работающий механизм. Сохраните пароль в менеджере паролей.
Можно подключить несколько Telegram-аккаунтов и ящиков?
Да. Они подключаются отдельно. При чтении и отправке нужно сохранять различие между исходными аккаунтами.
Нужно пользоваться веб-кабинетом каждый день?
Нет. После настройки работайте из подключённого ИИ-клиента. Веб-кабинет остаётся для управления и просмотра переписки.
Подойдёт любой ИИ?
Нужен клиент с поддержкой соответствующего MCP-транспорта и авторизации либо собственная интеграция через API. Модель без инструментов сама не подключится к чатам. Набор доступных действий зависит и от клиента, и от канала.
User.io сам отвечает людям?
Черновики и отправка разделены. Автоответы требуют отдельно настроенных правил. Само подключение ИИ не должно включать свободную отправку от вашего имени.
Нужны ли GPTAdmin и Agent Herder?
Для обычного чтения переписки через MCP не обязательны. Обычный разбор использует встроенный Fast Agent. Для отдельного подробного анализа и событийных агентных маршрутов могут требоваться GPTAdmin/Agent Herder.
Почему секретарь не ответил в ту же секунду?
Поступление сообщения, настроенная пауза, очередь и вычисление модели занимают время. Для почты добавляется интервал проверки ящика. Как разобрать задержку.
MAX и WhatsApp подключаются официальным API?
В описанных личных подключениях используются неофициальные коннекторы. Их работа зависит от изменений провайдеров. Подключение бота или Business API является другим сценарием.
Что происходит со старой историей?
Глубина загрузки зависит от канала и настроек. Новые сообщения и полный архив за всё время не являются одной гарантией. Проверяйте границу истории перед задачами, которым нужна полная переписка.
Полная техническая справка
Все контракты, примеры, эксплуатация и документы проекта.
Интеграции
- Runtime: инструменты, настройки и адаптеры.
- Стабильный Adapter SDK.
- Airlock: user identity, курсор, approval.
- Telegram QR ingress.
- WhatsApp bridge.
- VK extension и установка.
Эксплуатация
Примеры и документация
- Read-only API: список своих аккаунтов.
- Сборщик, проверки и публикация документации.
- Полный индекс с датированными решениями.
Технические контракты уточняют текущие возможности конкретного коннектора. Датированные проверки — история, не обещание работы любой установки.
Версии и источники
На каких контрактах основаны инструкции и что требует повторной проверки.
Эта редакция
Руководство сверено 12 октября 2026 с опубликованным UserIO34c6ba3: HTTP/MCP, native Fast Agent, per-user IMAP/Matrix, телефонное подключение и авторы Telegram/MAX. Присланный пакет документации был исходным материалом; его локальные скриншоты не использованы как доказательство работающего сайта.
Новые инструкции и ссылки на API относятся к текущему main. Работающий сервер может иметь другую версию: авторизованный GET /v1/runtime возвращает commit/manifest и признак проверки. Схемы MCP запрашивайте через tools/list.
Основные контракты
- HTTP API.
- MCP schemas.
- Runtime и адаптеры.
- Стабильный adapter SDK.
- Release и rollback.
- Android phone setup.
Внешняя справка
Яндекс IMAP/SMTP, OpenAI custom MCP, MCP tools. Возможности и меню сторонних сервисов могут меняться; проверяйте их текущие инструкции.
Ограничения
Нет самостоятельного восстановления пароля через email/Telegram; IMAP/Matrix подключение не даёт отправку; VK ID не даёт личные сообщения через обычный VK API. APK SMS не импортирует весь архив и исходящие других приложений; native-root и звонки требуют отдельного операторского подключения. MAX/WhatsApp личные коннекторы неофициальные. Полнота старой истории зависит от канала.
Роли, источник и время черновиков проверены в живом веб-интерфейсе; рабочие чаты и почта — настоящим разбором и доставкой уведомлений 12 октября 2026 года. Доказательства и ограничения сохранены в GSD summaries. Документация не подменяет эти проверки.
Сопровождение
Правьте Markdown и navigation.json, затем пересобирайте сайт. Сборщик и проверки. Все остальные инструкции доступны в полном индексе.