Главная Диалоги Боты-агенты

Боты-агенты

Обновлено Aug 24, 2026

Общая информация

Бот-агент — это внешняя программа, которая подключается к «Диалогам» и пишет клиентам от своего лица: с собственным именем, аватаром и описанием. Оператор в переписке видит, что ответил именно бот, а не сотрудник.

Бота используют, чтобы встретить клиента до прихода оператора: поздороваться, ответить на частый вопрос, уточнить детали обращения. Второй сценарий — подсказка оператору: бот получает сообщение клиента, сходит в вашу систему и оставит в диалоге приватную заметку («клиент из Москвы, три заказа, последний в возврате»). Заметку видят только сотрудники, клиенту она не уходит.

Саму программу-бота пишет разработчик — vlApp дает ей адрес, ключи и правила подключения. Ваша часть работы состоит из двух шагов: завести карточку бота в «Настройки › Диалоги › Боты» и назначить бота нужному источнику в его карточке.

Раздел доступен по праву администратора «Диалогов» — тому же, что и остальные вкладки настроек.

В списке видно имя бота с аватаром, описание, источники, которым он назначен, и статус — «Активен» или «Выключен». Поиск справа отбирает ботов по имени.

Как создать бота

  1. Откройте «Настройки › Диалоги › Боты» и нажмите «Создать».

  2. Нажмите на кружок аватара и загрузите изображение — JPG, PNG или WEBP до 1 МБ. Аватар необязателен: пока его нет, вместо картинки показывается первая буква имени.

  3. Заполните «Имя бота» — под ним бот подписывает свои сообщения в переписке.

  4. Заполните «Описание» — короткая подсказка сотрудникам, что этот бот делает.

  5. Укажите «URL вебхука» — адрес, на который vlApp будет присылать боту события: новые диалоги, сообщения, смену статуса. Поле обязательное, адрес дает разработчик бота и он должен начинаться с https://.

  6. Убедитесь, что включен переключатель «Бот активен».

  7. Нажмите «Создать бота».

После создания карточка останется открытой и в ней появится блок «Ключи доступа» — скопируйте оттуда оба ключа и передайте разработчику.

Только что созданный бот еще ничего не делает: он не привязан ни к одному источнику. Это следующий шаг.

Как назначить бота источнику

Бот работает в конкретном источнике — чате на сайте, Telegram, MAX или ВКонтакте. Назначение живет в карточке источника, а не в карточке бота.

  1. Откройте «Настройки › Диалоги › Источники» и нажмите на нужный источник.

  2. Найдите блок «Бот-агент».

  3. В выпадающем списке выберите бота. В списке только активные боты; у бота без адреса вебхука рядом с именем стоит пометка «(только отвечает)» — событий он не получит.

  4. Сохраните карточку источника.


Чтобы снять бота с источника, нажмите «Отключить бота» и сохраните карточку. Бот останется в справочнике со всеми своими ключами — он просто перестанет обслуживать этот источник.

Одного и того же бота можно назначить нескольким источникам: тогда в списке ботов в колонке «Источники» будут перечислены все. У источника при этом бот только один.

Ключи доступа

В карточке сохраненного бота два ключа, у каждого свое назначение:

  • Webhook Secret — им бот проверяет, что событие пришло действительно от vlApp, а не от постороннего.

  • Токен доступа — им бот представляется, когда пишет ответ в диалог. Без верного токена сообщение не примут.

Значения скрыты точками. Кнопка «Показать» открывает ключ на экране, «Копировать» кладет его в буфер обмена, не показывая.

Кнопка «Сброс» выпускает новое значение вместо старого. Пользуйтесь ей, если ключ мог попасть к посторонним. Ключи сбрасываются независимо: сброс Webhook Secret не трогает токен доступа, и наоборот.

Как пользоваться

Отдельного экрана у бота нет — он работает сам, а вы видите результат в переписке.

  1. Клиент пишет в источник, которому назначен бот.

  2. vlApp отправляет боту событие на его адрес.

  3. Бот отвечает: либо сообщением клиенту, либо приватной заметкой для сотрудников.

  4. Ответ появляется в ленте диалога под именем и аватаром бота. Публичное сообщение уходит клиенту в его канал, приватная заметка остается внутри.

Дальше диалог ведет оператор обычным порядком: отвечает, ставит метки, назначает и завершает.

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

Важно

  • Пока бот не назначен источнику, он не работает. В списке ботов такой бот показан как «Не назначен» — это самая частая причина, по которой «бот создан, а ничего не происходит».

  • У источника может быть только один бот. Выбор нового бота в карточке источника заменяет прежний.

  • Токен доступа дает право писать в ваши диалоги. Передавайте его разработчику по защищенному каналу и не пересылайте в общих чатах. Если произошла утечка ключа — нажмите «Сброс»: старое значение перестанет работать сразу.

  • После сброса ключа бот перестанет работать, пока разработчик не укажет новое значение. Планируйте сброс так же, как смену пароля к рабочей системе.

  • Бот умеет только писать сообщения. Он не может сменить статус диалога, назначить оператора, поставить метку или приложить файл — это остается за сотрудниками.

  • Аватар и описание бота видят только сотрудники — клиенту в его мессенджер они не передаются.