JAICP

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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