Как создать бота ВКонтакте: гайд для старта на платформе

Автоматизируем рутинные процессы с помощью платформы ботов VK — подборка материалов для разработчиков

Привет! Меня зовут Семён, я деврел платформы ботов ВКонтакте. Расскажу о том, как с ней работать, какие есть возможности и перспективы для разработчиков. В этой статье вы найдёте краткий пошаговый мануал: от поиска идеи для вашего чат-бота до проектирования его бизнес-возможностей. К каждому этапу будут ссылки на полезные материалы и источники, где можно узнать больше и погрузиться в технологию.

Статья будет дополняться по мере развития платформы — свежими ссылками на документацию, обзорами и интересными кейсами.

Начинаем с идеи

Первый шаг при создании бота — продумать идею и сценарии использования. Для этого полезно уже на старте знать, что умеет платформа. Вариантов масса:

— автоматизация вашей службы поддержки;

— помощь в работе бизнеса (оформление заказов и доставки в вашем магазине, общение с клиентами);

— внедрение социальных механик (знакомства, поиск единомышленников, опросы);

— рекламные проекты или, например, текстовые квесты.

Чем больше нюансов вы учтёте до того, как погрузитесь в написание бота, тем проще будет в реализации. Здесь нет исключений и неважных мелочей: подумайте над целями, потенциальной аудиторией, продвижением, разными сценариями — всё это упростит и ускорит работу в дальнейшем.

Готовим сообщество для бота

Сообщество — это точка входа для пользователей, которые будут общаться с вашим ботом. Если у вас уже есть такая страница, проверьте, включены ли сообщения («Управление сообществом» → «Сообщения»). Так пользователи смогут писать боту, когда он будет готов.

Если сообщества ещё нет, его нужно создать.

• Как открыть сообщество ВКонтакте — подробная инструкция по всем шагам запуска и возможностям сообществ.

Выбираем сценарий для получения обновлений

Чтобы реагировать на какие-либо события, ваш скрипт бота должен о них узнать. Для этого существуют два подхода — Callback API и Long Poll.

Как начать использовать Callback API

Подключите свой сервер в настройках сообщества («Управление сообществом» → «Настройки» → «Работа с API»). А затем выберите типы событий, данные о которых требуется получать: например, новые комментарии и фотографии.

• Документация Callback API — подробно о подключении, удалении сервера, настройках через API, типах событий, поддержке в SDK + пример использования.

Long Poll API

Этот подход позволяет работать с событиями из вашего сообщества в режиме реального времени. В отличие от Callback API, очередь из событий хранится на стороне ВКонтакте — мы не будем присылать отдельное уведомление для каждого события. Чтобы использовать Bots Long Poll API, откройте раздел «Управление сообществом», на вкладке «Работа с API» перейдите к  «Long Poll API» и выберите «Включён».

• Документация Long Poll API — инструкция по подключению, настройке через API, информация о формате данных и ошибках, а также поддержке в SDK.

Изучаем стартовую документацию и правила платформы

• Техническая документация платформы — основной инструмент для разработки чат-бота;

• Правила платформы — обязательные требования к функциональности и сценарию бота;

• Знакомство с API ВКонтакте — если вы ещё не работали с нашим сервисом API, узнайте, с чего начать;

• ВКонтакте API — сообщество с актуальной информацией об обновлениях и дополнениях API.

Получаем ключ доступа

Ключ доступа потребуется для получения обновлений в Long Poll, а также для работы с API. Вы можете сгенерировать несколько ключей с разными правами доступа. Важно помнить, что ключи нельзя размещать публично. Для получения ключа требуется лишь открыть раздел «Управление сообществом» (или «Управление страницей», если у вас публичная страница), выбрать вкладку «Работа с API» и нажать «Создать ключ доступа».

Получить ключ доступа можно, используя Authorization Code Flow — двухэтапный вариант с дополнительной аутентификацией вашего сервера.

• Документация Authorization Code Flow — всё о запросе списка администрируемых сообществ, открытии диалога авторизации, правах доступа, получении code и access_token.

Если вы хотите, чтобы пользователи могли добавлять бота в беседу, требуется выдать необходимые права. Перейдите в «Управление сообществом» → «Сообщения» → «Настройки для бота» и поставьте галочку в пункте «Разрешать добавлять сообщество в беседы». После этого в сообществе появится кнопка «Пригласить в беседу», открывающая модальное окно со списком чатов.

Сейчас боты поддерживают три уровня доступа: только упоминание, доступ ко всей переписке и доступ уровня администратора. Подробнее о различиях в доступах можно узнать в документации о добавлении ботов в беседы.

Переходим к возможностям

Чат-бот общается с пользователями с помощью сообщений сообщества. Для их отправки применяется метод messages.send. Вы можете использовать любые вложения: фотографии, аудиозаписи или видео, документы, голосовые, ссылки. Сообщения отправляются с помощью запросов к API ВКонтакте.

• Сообщения от бота. API для чат-ботов, часть 2 — подробная инструкция по работе с сообщениями бота, вложениями, пользовательским контентом и другими возможностями.

Следующий шаг — подключение клавиатуры. Чтобы запустить её в сообществе, перейдите в «Управление сообществом» → «Сообщения» → «Настройки для бота» и включите «Возможности ботов». Там же можно добавить кнопку «Начать».

• Клавиатуры для ботов. API для чат-ботов, часть 3 — мануал по всем нюансам настройки и отображения клавиатур.

Боты могут отправлять специальные сообщения, используя шаблоны. Такие сообщения отличаются от обычных и внешним видом, и функциональностью. Сейчас поддерживается один шаблон — карусель. В нём несколько элементов, которые можно скроллить горизонтально.

• Карусели. API для чат-ботов, часть 4 — всё об этом шаблоне сообщений, их отправке, структуре элементов и обратной совместимости.

Выбираем функции для бизнеса

• Чат-бот ВКонтакте: какую пользу он принесёт бизнесу — подробно о том, как использовать чат-ботов для повышения продаж.

Рекламный API позволяет с помощью бота отправлять пользователям промосообщения. Их важно помечать визуально и в программном интерфейсе. Чтобы получить доступ к рекламному API, бот должен соответствовать критериям платформы и пройти модерацию ВКонтакте.

• Правила монетизации ботов — о способах заработка с чат-ботами (платной подписке, предложении получать рекламную рассылку), а также критериях модерации для доступа к рекламному API.

• Заявка на модерации бота — форма.

После успешной модерации бот сможет отправлять своим собеседникам рекламные сообщения. В диалоге с таким ботом пользователь увидит предупреждение об этом.

Если вы не разработчик, но хотите обзавестись чат-ботом для своего бизнеса или любого другого проекта — это тоже возможно. Например, пригодятся сервисы-конструкторы: они помогают создать бота под ваши задачи и предлагают простой, удобный интерфейс для работы. А если функциональности конструктора будет недостаточно, всегда есть услуги аутсорс-разработчиков. Проверенные команды специалистов и конструкторы ботов можно найти на платформе «Бизнес ВКонтакте» — в разделе «Эксперты и сервисы».