Перейти к основному содержимому

ВКонтакте как входящий канал

Для использования ВКонтакте как входящего канала:

Настройка доступа​

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

Укажите, что в сообществе будет работать бот. Для этого перейдите Управление сообществом → Сообщения → Настройки для бота. Включите пункт Возможности ботов. Далее включите сообщения в сообществе Управление сообществом → Сообщения.

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

Получение ключа доступа​

Откройте раздел Управление сообществом (Управление станцией, если публичная страница) → вкладка Работа с API → Создать ключ доступа. Отметьте необходимые права доступа и подтвердите выбор.

предупреждение
Не размещайте ключи в публичном доступе! Если ключ был скомпрометирован, удалите его из списка — после этого он станет недействителен.

Создание канала​

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

Заполните поля:

  • Название — укажите название для канала или оставьте по умолчанию.
  • Токен — введите готовый ключ доступа.
  • Начинать диалог с любого сообщения пользователя — при активном переключателе бот начинает диалог с любого сообщения пользователя.
  • Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
  • Оператор — выберите операторский канал или оставьте пустым.
  • Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).
предупреждение
Публикацию сценария нужно выполнять перед запуском бота. На этом этапе происходит сборка бота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.

Нажмите Создать. Дождитесь всплывающего окна с результатом публикации. После успешной публикации чат-бот готов к использованию.

Тестирование бота​

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

подсказка
Подробнее о работе с API ВКонтакте

Старт диалога​

Рассмотрим алгоритм начала диалога клиента с ботом при активном переключателе Начать диалог с любого сообщения пользователя:

  1. Если клиент отправляет первое сообщение боту, то первым запросом отправляется /start. Затем боту отправляется текст сообщения.
  2. Если для бота добавлена кнопка Начать, и клиент отправляет сообщение, то первым запросом отправляется /start.
  3. Если сообщение клиента не первое, то боту отправляется текст сообщения, /start не отправляется.