Боты-агенты
Общая информация
Бот-агент — это внешняя программа, которая подключается к «Диалогам» и пишет клиентам от своего лица: с собственным
именем, аватаром и описанием. Оператор в переписке видит, что ответил именно бот, а не сотрудник.
Бота используют, чтобы встретить клиента до прихода оператора: поздороваться, ответить на частый вопрос, уточнить детали
обращения. Второй сценарий — подсказка оператору: бот получает сообщение клиента, сходит в вашу систему и оставит в
диалоге приватную заметку («клиент из Москвы, три заказа, последний в возврате»). Заметку видят только сотрудники,
клиенту она не уходит.
Саму программу-бота пишет разработчик — 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. Ответ появляется в ленте диалога под именем и аватаром бота. Публичное сообщение уходит клиенту в его канал,
приватная заметка остается внутри.
Дальше диалог ведет оператор обычным порядком: отвечает, ставит метки, назначает и завершает.
Чтобы временно остановить бота во всех источниках сразу, выключите переключатель «Бот активен» в его карточке.
Выключенный бот перестает и получать события, и отвечать; переписки при этом сохраняются, а назначения на
источники не теряются. Чтобы убрать бота совсем, откройте его карточку и нажмите значок корзины — понадобится
подтверждение, после которого бот пропадет и из тех источников, где он стоял.
Важно
- Пока бот не назначен источнику, он не работает. В списке ботов такой бот показан как «Не назначен» — это самая
частая причина, по которой «бот создан, а ничего не происходит».
- У источника может быть только один бот. Выбор нового бота в карточке источника заменяет прежний.
- Токен доступа дает право писать в ваши диалоги. Передавайте его разработчику по защищенному каналу и не пересылайте
в общих чатах. Если произошла утечка ключа — нажмите «Сброс»: старое значение перестанет работать сразу.
- После сброса ключа бот перестанет работать, пока разработчик не укажет новое значение. Планируйте сброс так же, как
смену пароля к рабочей системе.
- Бот умеет только писать сообщения. Он не может сменить статус диалога, назначить оператора, поставить метку или
приложить файл — это остается за сотрудниками.
- Аватар и описание бота видят только сотрудники — клиенту в его мессенджер они не передаются.
