Как подключить ИИ-агента к сообщениям сообщества ВКонтакте: ключ доступа, Callback API, кнопки в диалоге и что включить, чтобы они работали. Пошаговый разбор.
ИИ-агент подключается к сообщениям сообщества ВКонтакте ключом доступа: он создаётся в разделе «Работа с API» и вставляется в кабинете Савви, после чего в настройках сообщества подтверждается Callback API с сервером Савви. Для кнопок в диалоге дополнительно включаются возможности ботов. Агент отвечает по той же инструкции, что и в других каналах, диалог стоит около 15 ₽.
Сообщения сообщества — тот случай, когда канал живёт сам по себе. Реклама ведёт в группу, группа собирает вопросы, а отвечает на них тот, у кого сегодня открыта вкладка. Поэтому у сообщений ВКонтакте типичная беда — неравномерность: тишина днём и десять вопросов вечером, когда никого нет.
Подключение агента здесь занимает минут пятнадцать, но три шага из десяти делаются в настройках самого сообщества, а не в кабинете Савви — и именно на них обычно всё и застревает.
Для подключения нужны права администратора сообщества.
После подтверждения все входящие обращения начинают обрабатываться агентом, а сама переписка видна в разделе «Чаты» в кабинете. Вмешаться можно с любой стороны: и из ВКонтакте, и из кабинета.
Кнопки в диалоге — главное, чем ВКонтакте отличается от переписки в мессенджере. Человек выбирает из готового вместо того, чтобы печатать, и путь до заявки сокращается вдвое.
Но есть предварительное условие, без которого кнопки просто не появятся: в настройках сообщества нужно открыть «Сообщения» → «Настройки для бота» и включить «Возможности ботов». Пока флаг выключен, вы можете сколько угодно настраивать шаги — клиент увидит обычный текст.
Дальше кнопки добавляются шагом действия «Кнопки в VK». Что в нём задаётся:
Это не кнопочное меню, нарисованное заранее. Набор кнопок — это действие, которое агент вызывает, когда по ходу разговора видит подходящий момент. Поэтому описание функции важнее самих кнопок: по нему агент решает, показывать их или продолжать разговор словами.
Проверьте на своих диалогах.Регистрация без карты, 500 ₽ на тест по промокоду BLOG500
Собрать агентаАгент у вас один, и инструкция у него общая. Разница между каналами задаётся условиями внутри инструкции — у каждого канала есть своё техническое имя, и у ВКонтакте это vk.
Что стоит учесть именно здесь:
| Особенность канала | Что с этим делать |
|---|---|
| Клиент часто приходит из рекламного поста | Дать агенту знать, о чём был пост: контекст сокращает разговор на два круга |
| Аудитория пишет коротко и на «ты» | Задать стиль ответов явно, иначе агент будет держать деловой тон в переписке, где он неуместен |
| Есть кнопки | Использовать их для сбора структурных данных: выбор услуги, города, времени |
| Сообщения читают с телефона | Держать ответы короткими: длинный абзац на маленьком экране не читают |
Что до сценария разговора, он собирается по общим правилам — как именно, разобрано в статье про сценарий чат-бота.
Три проверки в порядке убывания вероятности.
Callback API не подтверждён. Самая частая причина. Ключ создан, канал подключён, а сервер в настройках сообщества не выбран — сообщения никуда не уходят.
Выключены ответы агента. В настройках канала есть отдельный переключатель: он глушит агента, не разрывая подключение. Удобно для паузы и легко забывается включённым обратно.
Не хватает прав у ключа. Права выбираются в момент создания ключа. Если ключ выпускали давно и под другую задачу, проще выпустить новый, чем выяснять, чего в нём не хватает.
Диалог обходится примерно в 15 ₽. Списание идёт по токенам: тысяча токенов стоит 1 ₽, считается фактически обработанный текст — сообщение клиента, инструкция, история переписки и ответ.
Для сообщества последняя цифра особенно заметна: активность в группах смещена в вечер и выходные, ровно туда, где у отдела продаж выходной.
Включите «Возможности ботов» в настройках сообщества, даже если кнопки вам пока не нужны.
Это одна галочка, которую иначе вы будете искать через неделю, когда настроите первый сценарий с выбором услуги и обнаружите, что клиенту показывается голый текст. Всё остальное подключается по шагам выше и проверяется просто: напишите в сообщество сами тот вопрос, который задают чаще всего.
Нужны права администратора сообщества. В управлении сообществом открывается «Работа с API» → «Ключи доступа» → «Создать ключ», выбираются права и подтверждается номер телефона. Полученный ключ вставляется при подключении канала VK в кабинете Савви.
Это механизм, которым ВКонтакте сообщает внешнему сервису о новых событиях в сообществе. После подключения канала нужно вернуться в настройки сообщества, открыть вкладку Callback API, выбрать сервер Савви и нажать «Подтвердить» — без этого сообщения до агента не дойдут.
Скорее всего, в сообществе не включены возможности ботов. Они включаются в настройках сообщества: «Сообщения» → «Настройки для бота» → «Возможности ботов». Пока флаг выключен, кнопки не отображаются.
Кнопки добавляются шагом действия «Кнопки в VK». Их можно разместить внизу экрана или под сообщением, задать текст и цвет, а также включить скрытие клавиатуры после одного нажатия.
Да. Отвечать можно и из самого ВКонтакте, и из кабинета Савви — все входящие обращения видны в разделе «Чаты». В настройках канала есть отдельный переключатель ответов агента, который выключает его, не разрывая подключение.
Около 15 ₽ за диалог. Оплата по токенам, тысяча токенов стоит 1 ₽. Отдельной платы за подключение канала нет.
Хотите сразу к продукту: Конструктор ВК ботов