Wiki › Инструкции

Быстрый старт VK: ваш первый бот в сообществе ВКонтакте

Эта инструкция проведёт вас от регистрации в SamBot до первого работающего бота в сообществе ВКонтакте. По сравнению с Telegram шагов чуть больше — нужно связать сервер SamBot с сообществом через Callback API. Никаких навыков программирования не нужно.

Что вам понадобится

  • аккаунт ВКонтакте с правами администратора в сообществе (или возможность создать новое сообщество);
  • email — для регистрации в SamBot;
  • браузер.

Шаг 1. Регистрация в SamBot

Откройте sambot.ru и нажмите «Регистрация». Введите email и пароль, подтвердите регистрацию по ссылке из письма.

Шаг 2. Получаем токен сообщества ВКонтакте

Если у вас уже есть сообщество — используйте его. Иначе сначала создайте новое: vk.com → слева «Сообщества» → «Создать сообщество».

Чтобы SamBot мог отвечать от имени сообщества, нужен токен:

  1. Откройте сообщество, которым управляете.
  2. В настройках сообщества: Управление → Дополнительно → Работа с API → Ключи доступа.
  3. Нажмите «Создать ключ», выдайте права на сообщения сообщества и на управление сообществом.
  4. Скопируйте полученный токен (длинная строка). Это секретный ключ — храните его в надёжном месте.

Шаг 3. Подключаем бота в SamBot

  1. В личном кабинете SamBot нажмите «Добавить бота».
  2. В появившемся диалоге выберите ВКонтакте.
  3. Вставьте токен из шага 2 и нажмите «Сохранить».

Сразу после этого откроется мастер «Связать сервер с ВКонтакте» — переходим к нему.

Шаг 4. Связываем сервер с ВКонтакте (Callback API)

Это ключевой шаг: ВКонтакте должна знать, на какой адрес отправлять события. SamBot уже подготовил все данные — осталось их скопировать в настройки сообщества. Мастер называется «Связать сервер с ВКонтакте» и показывает 5 нумерованных шагов:

  1. Откройте настройки сообщества: Управление → Дополнительно → Работа с API → Callback API. Не закрывайте мастер SamBot — переключайтесь между вкладками.
  2. В мастере SamBot скопируйте адрес сервера (есть кнопка copy) и вставьте его в поле URL на вкладке Callback API в ВКонтакте.
  3. ВКонтакте покажет код подтверждения — скопируйте его и вставьте в поле «Код подтверждения сервера» мастера SamBot.
  4. В мастере SamBot есть «Секретный ключ (Callback API)», сгенерированный автоматически. Скопируйте его и вставьте в поле «Секретный ключ» на вкладке Callback API в ВКонтакте.
  5. В мастере SamBot нажмите «Сохранить». Затем вернитесь в ВКонтакте и нажмите «Подтвердить» на вкладке Callback API. ВКонтакте сделает тестовый запрос на адрес SamBot и подтвердит подключение.

Эти сведения позже можно обновить в Настройках бота.

Шаг 5. Включаем типы событий

По умолчанию ВКонтакте не отправляет SamBot новые сообщения — их нужно явно подписать.

  1. На той же странице Callback API перейдите на вкладку «Типы событий».
  2. Включите «Входящее сообщение». Если планируете обрабатывать ответы на кнопки — включите также события об их нажатиях.
  3. Сохраните.

Шаг 6. Создаём первую реакцию

Форма реакции в SamBot одинакова для Telegram и ВКонтакте — разделена на четыре блока: 1. Срабатывает на, 2. В чатах, 3. Условия, 4. Действия.

Создадим простую: бот будет отвечать на слово «привет».

  1. В боковом меню откройте раздел «Реакции» и нажмите «Добавить реакцию».
  2. В поле «Заголовок» впишите название реакции, например Приветствие — это единственное обязательное поле.
  3. В блоке «1. Срабатывает на» разверните «1.1. Текстовое сообщение», включите галочку «1.1.1. Содержит ключевые слова» и добавьте ключевое слово привет.
  4. В блоке «4. Действия» галочка «4.1. Отправить сообщение» уже включена по умолчанию. Нажмите кнопку «+ Текст» — откроется форма добавления текстового сообщения. Впишите ответ: Привет! Я твой первый бот ВКонтакте на SamBot. Сохраните сообщение.
  5. Нажмите «Сохранить».

Шаг 7. Проверяем в сообществе

Откройте сообщество в ВКонтакте, нажмите «Написать сообщение» и отправьте «привет». Бот ответит вашим сообщением. ✓

Если ничего не пришло:

  • Проверьте, что бот включён в SamBot.
  • Убедитесь, что в ВКонтакте на вкладке Callback API стоит статус «Подтверждено».
  • На вкладке «Типы событий» включено «Входящее сообщение».
  • В настройках сообщества «Управление → Сообщения» сообщения сообщества включены.
  • Проверьте раздел «Статистика» в SamBot — там видно, какие события пришли и сработала ли реакция.

Что дальше

  • Реакции — все типы триггеров и действий.
  • Кнопки и опросы — добавьте интерактива в ответы.
  • Метки — сегментация подписчиков.
  • Формулы и параметры пользователя — динамический контент.
  • Приём платежей — подключите платёжного провайдера.

Похожие статьи