Каналы общения
Где можно общаться с агентами
| Канал | Для чего удобен | Как подключить |
|---|---|---|
| Telegram | Быстрые запросы, групповые чаты, уведомления | У каждого агента свой бот. Как его создать — ниже, как подключить к агенту — Агенты и иерархия |
| Веб-чат | Проекты, файлы, таблицы, длинная работа | chat.neiron.org, вход по email и паролю |
| Переписка с клиентами через ваш номер | Номер подключается к агенту — напишите команде Neiron | |
| Дашборд компании | Цифры и отчёты в браузере, кнопки «поручить агенту» | См. Дашборд |
Память агента общая для всех каналов, а история переписки у каждого чата своя. Важное просите «запомнить» — тогда агент будет знать это в любом канале.
Telegram: форматы общения
1. Личный чат с агентом
Вы пишете напрямую боту-агенту. Он видит только ваши сообщения и отвечает только вам.
Когда использовать: конфиденциальные запросы, личные задачи, настройка агента.
Пример:
Вы → @ваш_агент_bot:
«Покажи динамику продаж по артикулу 12345 за последние 30 дней»
2. Групповой чат (несколько агентов + сотрудники)
Все участники видят сообщения. К конкретному агенту обращайтесь через @упоминание или ответом на его сообщение.
Когда использовать: командные обсуждения, когда нужен ответ от нескольких агентов, совместная работа.
Пример:
Группа «Общий чат»:
Иван: «@ваш_агент_bot, нужна сводка по всем кабинетам»
Агент: «Собираю… [ответ]»
3. Топики (forum threads) в группах
Если группа настроена как форум, каждый топик — отдельная тема. Агент может отвечать в конкретном топике.
Когда использовать: когда хотите разделить обсуждения по темам (закупки / маркетинг / аналитика).
Как создать Telegram-бота через @BotFather
В Telegram каждый агент — отдельный бот. Бота создают в официальном боте Telegram — @BotFather. Это бесплатно и занимает 2–3 минуты. В итоге вы получите токен бота. Его вставляют в админ-панели при создании агента — см. Агенты и иерархия.
Создать бота можно двумя способами: кнопками в мини-приложении BotFather или командами в чате с ним. Результат одинаковый — выбирайте, как удобнее.
Перед началом: имя и username
| Что | Пример | Правила |
|---|---|---|
| Имя (name) | Директор Ромашка | Любое, на любом языке. Видно в списке чатов и в профиле бота. Можно поменять потом |
| Username | romashka_ceo_bot | 5–32 символа: латиница, цифры и _. Обязательно заканчивается на bot. Должен быть свободен. Поменять потом нельзя |
Способ 1. Через мини-приложение BotFather
- Откройте в Telegram чат с @BotFather.
- Нажмите кнопку «Open» («Открыть») рядом с полем ввода сообщения. Откроется окно BotFather со списком ваших ботов. Открыть его можно и по ссылке t.me/botfather?startapp.
- Нажмите «Create a new bot».
- Введите имя бота и username и подтвердите создание.
- Откроется страница нового бота. Нажмите «Copy» рядом с токеном — токен скопируется.
- Вставьте токен в админ-панели при создании агента. Если агента создаёт команда Neiron — пришлите токен ей в личные сообщения.
На странице бота в мини-приложении можно сразу поставить аватар, описание и настройки для групп (см. ниже).
Способ 2. Через команды в чате
- Откройте чат с @BotFather. Если открываете впервые, нажмите «Старт» (Start).
- Отправьте команду
/newbot. - BotFather попросит имя бота («Please choose a name for your bot»). Отправьте имя, например:
Директор Ромашка. - Затем он попросит username («Now let's choose a username for your bot. It must end in
bot»). Отправьте username, например:romashka_ceo_bot. Если BotFather ответит, что username занят или не подходит, придумайте другой и отправьте снова. - BotFather пришлёт сообщение «Done! Congratulations on your new bot» со ссылкой на бота. Токен стоит после строки «Use this token to access the HTTP API». Он выглядит так:
123456789:AAF...— цифры, двоеточие и длинная строка из букв и цифр. Нажмите на токен — он скопируется. - Вставьте токен в админ-панели при создании агента или пришлите его команде Neiron в личные сообщения.
Передумали на любом шаге — отправьте /cancel.
Токен: как хранить и что делать, если он утёк
- Токен — полный ключ к боту. Кто его знает, может писать от имени бота и читать сообщения, которые ему присылают. Храните токен как пароль: не пересылайте в группы, не публикуйте на скриншотах.
- Где он нужен. Админ-панель → агент → настройки → «Telegram бот». Бота можно заменить там же: агент и его память останутся.
- Посмотреть токен ещё раз: @BotFather →
/mybots→ ваш бот → «API Token». Или откройте страницу бота в мини-приложении. - Токен утёк: @BotFather →
/mybots→ ваш бот → «API Token» → «Revoke current token». Старый токен сразу перестанет работать. Новый вставьте в админ-панели в настройках агента («Telegram бот»), иначе агент замолчит.
Настройки для групповых чатов
Нужны, только если агент будет работать в группах. Как добавить агента в группу — в разделе Агенты и иерархия.
| Что сделать | В мини-приложении или через /mybots | Командой |
|---|---|---|
| Разрешить добавлять бота в группы | Бот → «Bot Settings» → «Groups and Channels» (чаты и каналы) → разрешить группы | /setjoingroups → выберите бота → Enable |
| Выключить режим приватности, чтобы бот видел все сообщения группы, а не только команды и ответы ему | Бот → «Bot Settings» → «Group Privacy» → «Turn off» | /setprivacy → выберите бота → Disable |
Бот, которого сделали администратором группы, получает все её сообщения при любом режиме приватности.
Оформление бота (по желанию)
| Что | Команда | Где видно |
|---|---|---|
| Имя | /setname | Список чатов, профиль бота |
| Описание (до 512 символов) | /setdescription | Пустой чат с ботом, блок «Что умеет этот бот?» |
| О боте (до 120 символов) | /setabouttext | Профиль бота |
| Аватар | /setuserpic | Список чатов, профиль бота |
| Меню команд | /setcommands | Кнопка «Меню» в чате с ботом |
Всё это можно сделать и в мини-приложении на странице бота. Меню команд агенту не обязательно: он понимает обычный текст (см. раздел «Управление через текст» ниже).
Шпаргалка команд @BotFather
| Команда | Что делает |
|---|---|
/newbot | Создать бота |
/mybots | Список ваших ботов и все их настройки кнопками: токен, настройки, передача, удаление |
/setname | Сменить имя бота |
/setdescription | Описание в пустом чате с ботом |
/setabouttext | Текст в профиле бота |
/setuserpic | Аватар бота |
/setcommands | Меню команд бота |
/setjoingroups | Разрешить или запретить добавлять бота в группы |
/setprivacy | Режим приватности в группах |
/deletebot | Удалить бота навсегда. Username освободится, вернуть бота нельзя |
/cancel | Отменить текущую команду |
Полный список команд — отправьте BotFather /help.
Передать бота другому владельцу
Бота создал сотрудник или команда Neiron, а владеть им должна компания? Бота можно передать:
- Новый владелец открывает @BotFather и нажимает «Старт».
- Нынешний владелец: @BotFather →
/mybots→ бот → «Transfer Ownership» → выбирает нового владельца и подтверждает облачным паролем Telegram.
Передача необратима: вернуть бота сможет только новый владелец. Для передачи у владельца должен быть включён облачный пароль (двухэтапная аутентификация). Если его включили недавно, Telegram может разрешить передачу только через несколько дней. После передачи напишите агенту и проверьте, что он отвечает.
Если что-то не получается
| Проблема | Что сделать |
|---|---|
| BotFather пишет, что username занят или не подходит | Придумайте другой: латиница, цифры и _, в конце bot |
| Бота нельзя добавить в группу | Разрешите группы: /setjoingroups → Enable |
| В группе бот не видит обычные сообщения, только команды и ответы ему | Выключите режим приватности (/setprivacy → Disable), удалите бота из группы и добавьте заново |
| Бот не пишет сотруднику | Сотрудник должен один раз открыть бота и нажать «Старт» |
| BotFather не даёт создать ещё одного бота | У Telegram есть лимит ботов на один аккаунт. Удалите ненужного (/deletebot) или создайте бота с другого аккаунта |
| Агент молчит | Проверьте, что токен вставлен в настройках агента («Telegram бот») и подключена подписка ИИ. Токен перевыпускали — вставьте новый |
Веб-чат
Веб-чат — работа с агентами в браузере: chat.neiron.org. Сотрудник входит по email и паролю и видит только тех агентов, которых ему назначил администратор.
- Сессии и проекты. В проекте можно объединить нужных агентов и общие файлы.
- Видно больше, чем в Telegram: действия агентов, расписания, результаты в виде таблиц.
- Как приложение. В Chrome веб-чат можно установить на компьютер и открывать отдельным окном, как обычную программу.
Новая сессия не переносит историю предыдущей автоматически. Чтобы продолжать работу с контекстом, используйте файлы проекта, сохранённые планы и другие материалы проекта.
Агента можно подключить к номеру WhatsApp — например, чтобы публичный агент принимал заявки клиентов. Чтобы подключить номер, напишите команде Neiron.
- Агент отвечает в личных чатах этого номера. Сообщения, которые вы сами пишете с телефона, тоже попадают в историю.
- В WhatsApp агент отвечает только текстом. Файлы и отчёты он присылает в Telegram или веб-чат.
- Если у агента есть навыки, написанные под Telegram (например, «сообщить менеджеру о новом лиде»), проверьте их на заявке из WhatsApp.
Дашборд
В дашборде компании агенты показывают цифры и отчёты. Под виджетами бывают кнопки, которые отправляют агенту готовое сообщение или ставят ему задачу. А законченную работу агент присылает карточкой результата: что сделано, что проверено. Подробнее — в разделе Дашборд.
Как правильно писать агенту
Будьте конкретны
| Плохо | Хорошо |
|---|---|
| «Как дела?» | «Покажи топ-10 артикулов по выручке за апрель» |
| «Что-нибудь по остаткам» | «Какие артикулы в красной зоне по остаткам на WB? Сколько дней осталось?» |
Давайте контекст
«Акция на WB заканчивается послезавтра. Какие артикулы стоит повысить в цене и на сколько?»
Просите конкретный формат
«Дай сводку в виде таблицы: артикул, текущий остаток, рекомендация»
Уточняйте действие
| Что написать | Когда |
|---|---|
| «Только проанализируй» | Нужны данные, без действий |
| «Выполни» | Агент должен что-то сделать: выгрузить файл, отправить заявку |
| «Предложи варианты» | Нужна помощь с решением |
Управление через текст
Агент понимает обычный язык, команды знать не нужно:
| Что вы пишете | Что делает агент |
|---|---|
| «Запомни, что наш приоритет — маржинальность, а не оборот» | Записывает в память |
| «Каждый понедельник в 9:00 присылай мне сводку продаж» | Создаёт задачу по расписанию |
| «Отправь это Ивану» | Пересылает указанному сотруднику |
| «Сохрани это в базу знаний» | Добавляет в wiki |
| «Научись делать X» | Создаёт новый навык (только агент-директор) |
Файлы и вложения
Через Telegram и веб-чат можно:
- отправить агенту файл (Excel, PDF, CSV) — он его прочитает и обработает;
- получить от агента файл — отчёт, выгрузку, результат работы;
- отправить фото — агент его проанализирует (карточка товара, скриншот кабинета). Несколько фото в одном сообщении обрабатываются одним запросом.
Пример:
Вы → [прикрепляете файл прайса поставщика]
«Сравни с нашими текущими ценами закупки и покажи, где можем сэкономить»
Голосовые сообщения
Агенту можно отправлять голосовые сообщения. Голосовые расшифровывает модель OpenAI по API, поэтому в настройках компании нужен ключ OpenAI API с балансом. Без ключа агент попросит написать текстом. Как выпустить ключ, привязать карту и вставить ключ в настройки компании — на странице Распознавание голосовых сообщений.
Вопросы с вариантами ответа
Если для задачи агенту не хватает вашего решения, в личном чате или в веб-чате он может задать до четырёх вопросов с готовыми вариантами ответа. Нажмите кнопку или напишите свой вариант — агент продолжит работу, когда получит все ответы.
Уведомления от агентов
Агенты могут сами вам писать, а не только отвечать:
- по расписанию — «Доброе утро, вот сводка на сегодня»;
- по триггеру — «Внимание: артикул 12345 вышел в красную зону по остаткам»;
- по результату задачи — «Заявка поставщикам отправлена, жду ответов»;
- по ошибке — «Не смог подключиться к кабинету WB, нужна авторизация».
Вы можете настроить, какие уведомления хотите получать и в каком чате.
Агенты в группах: правила хорошего тона
Когда агент находится в групповом чате с несколькими людьми:
- он не встревает в каждый разговор — только когда к нему обращаются или когда может добавить реальную пользу;
- он не раскрывает личные данные одного участника другим;
- при прямом обращении (@упоминание) или ответе на его сообщение — всегда отвечает.
Обновлено 01.10.2026 · версия 3 · версия для ИИ-агентов