Каналы общения

Раздел: Документация Neiron. Обновлено: 01.10.2026, версия 3. Адрес для людей: https://neiron.org/docs/kanaly-obshcheniya/

Где можно общаться с агентами

Канал	Для чего удобен	Как подключить
Telegram	Быстрые запросы, групповые чаты, уведомления	У каждого агента свой бот. Как его создать — ниже, как подключить к агенту — Агенты и иерархия
Веб-чат	Проекты, файлы, таблицы, длинная работа	chat.neiron.org, вход по email и паролю
WhatsApp	Переписка с клиентами через ваш номер	Номер подключается к агенту — напишите команде Neiron
Дашборд компании	Цифры и отчёты в браузере, кнопки «поручить агенту»	См. Дашборд

Память агента общая для всех каналов, а история переписки у каждого чата своя. Важное просите «запомнить» — тогда агент будет знать это в любом канале.

Telegram: форматы общения

1. Личный чат с агентом

Вы пишете напрямую боту-агенту. Он видит только ваши сообщения и отвечает только вам.

Когда использовать: конфиденциальные запросы, личные задачи, настройка агента.

Пример:

Вы → @ваш_агент_bot:
«Покажи динамику продаж по артикулу 12345 за последние 30 дней»

2. Групповой чат (несколько агентов + сотрудники)

Все участники видят сообщения. К конкретному агенту обращайтесь через @упоминание или ответом на его сообщение.

Когда использовать: командные обсуждения, когда нужен ответ от нескольких агентов, совместная работа.

Пример:

Группа «Общий чат»:
Иван: «@ваш_агент_bot, нужна сводка по всем кабинетам»
Агент: «Собираю… [ответ]»

3. Топики (forum threads) в группах

Если группа настроена как форум, каждый топик — отдельная тема. Агент может отвечать в конкретном топике.

Когда использовать: когда хотите разделить обсуждения по темам (закупки / маркетинг / аналитика).

Как создать Telegram-бота через @BotFather

В Telegram каждый агент — отдельный бот. Бота создают в официальном боте Telegram — @BotFather. Это бесплатно и занимает 2–3 минуты. В итоге вы получите токен бота. Его вставляют в админ-панели при создании агента — см. Агенты и иерархия.

Создать бота можно двумя способами: кнопками в мини-приложении BotFather или командами в чате с ним. Результат одинаковый — выбирайте, как удобнее.

Важно. Настоящий @BotFather — с синей галочкой. Ищите его по точному имени @BotFather: у поддельных ботов похожие названия, и они крадут токены.

Перед началом: имя и username

Что	Пример	Правила
Имя (name)	Директор Ромашка	Любое, на любом языке. Видно в списке чатов и в профиле бота. Можно поменять потом
Username	`romashka_ceo_bot`	5–32 символа: латиница, цифры и `_`. Обязательно заканчивается на `bot`. Должен быть свободен. Поменять потом нельзя

Совет. Называйте ботов по роли агента: romashka_ceo_bot, romashka_sales_bot, romashka_buh_bot. Так сотрудники не перепутают, кому писать.

Способ 1. Через мини-приложение BotFather

Откройте в Telegram чат с @BotFather.
Нажмите кнопку «Open» («Открыть») рядом с полем ввода сообщения. Откроется окно BotFather со списком ваших ботов. Открыть его можно и по ссылке t.me/botfather?startapp.
Нажмите «Create a new bot».
Введите имя бота и username и подтвердите создание.
Откроется страница нового бота. Нажмите «Copy» рядом с токеном — токен скопируется.
Вставьте токен в админ-панели при создании агента. Если агента создаёт команда Neiron — пришлите токен ей в личные сообщения.

На странице бота в мини-приложении можно сразу поставить аватар, описание и настройки для групп (см. ниже).

Примечание. Названия кнопок в мини-приложении зависят от языка Telegram и версии приложения. Если кнопки называются иначе, ищите по смыслу: «создать бота», «настройки бота», «скопировать».

Способ 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 бот»), иначе агент замолчит.

Важно. Один бот — один агент. Не подключайте тот же токен к другим сервисам (CRM, конструкторам ботов, чат-виджетам). Telegram отдаёт сообщения бота только одному получателю, и агент начнёт пропускать сообщения или замолчит совсем.

Настройки для групповых чатов

Нужны, только если агент будет работать в группах. Как добавить агента в группу — в разделе Агенты и иерархия.

Что сделать	В мини-приложении или через `/mybots`	Командой
Разрешить добавлять бота в группы	Бот → «Bot Settings» → «Groups and Channels» (чаты и каналы) → разрешить группы	`/setjoingroups` → выберите бота → Enable
Выключить режим приватности, чтобы бот видел все сообщения группы, а не только команды и ответы ему	Бот → «Bot Settings» → «Group Privacy» → «Turn off»	`/setprivacy` → выберите бота → Disable

Важно. Бот уже был в группе? После смены режима приватности удалите его из группы и добавьте заново. Иначе Telegram продолжит присылать ему только команды и ответы на его сообщения.

Бот, которого сделали администратором группы, получает все её сообщения при любом режиме приватности.

Оформление бота (по желанию)

Что	Команда	Где видно
Имя	`/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, нужна авторизация».

Вы можете настроить, какие уведомления хотите получать и в каком чате.

Примечание. Бот в Telegram не может написать первым человеку, который ни разу не нажал у него «Старт». Попросите сотрудников один раз открыть бота и нажать «Старт» — иначе уведомления до них не дойдут.

Агенты в группах: правила хорошего тона

Когда агент находится в групповом чате с несколькими людьми:

он не встревает в каждый разговор — только когда к нему обращаются или когда может добавить реальную пользу;
он не раскрывает личные данные одного участника другим;
при прямом обращении (@упоминание) или ответе на его сообщение — всегда отвечает.