.top-button { background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/baseline_keyboard_arrow_up_white_18dp.png) !important; background-position: center; background-color: #47a7f5 !important; background-repeat: no-repeat; box-shadow: -1px 1.5px 3px #999; color: #47a7f5 !important; border-radius:50px !important; position: fixed; bottom: 45px; left: 93.5%; width: 50px; height: 50px !important; font-size: 12px !important; padding: 14.5px !important; z-index: 2; } .top-button:hover{ background-color: #65b9ff !important; color: #65b9ff !important; } .page-header{ background-color: #232838; background-repeat: no-repeat; background-position: center; width: auto; height: 100px; background-image: url(https://confluence.twin24.ai/download/attachments/23986188/logo_twin-02.png); background-size: 10em; color: #fff; font-size: 20px; padding: 20px; } .page-footer{ background-color: #232838; background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/decorated-pattern-dark.png); width: auto; height: 10px; color: #fff; text-align: end; font: small-caption; padding-inline-end: 30px; padding-top: 200px; padding-bottom: 30px; } .page-headline{ background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/Solid256dot8_2changed.png); background-repeat: no-repeat; background-position-x: -227px; background-position-y: center; padding: 20px; background-color: #007bff; width: auto; height: 10px; color: #fff; text-align: center; font: caption; font-weight: 600; } .tabs-menu{ padding-left: 85% !important; }

С помощью данной статьи вы сможете интегрировать своего бота в сообщения группы или публичной страницы ВКонтакте.

Создание сообщества Вконтакте

  1. Зайдите на личную страницу в социальной сети ВКонтакте.
  2. Откройте страницу Сообщества, и на вкладке Управление нажмите кнопку Создать сообщество.



       3. Создайте сообщество (открытую группу или публичную страницу) в социальной сети ВКонтакте, с которой будет ассоциирован бот:






Чтобы привязать бота к сообщениям группы ВКонтакте, нужно получить 3 ключа:

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

  1. В боковом меню на странице созданного сообщества выберите пункт Управление.



     2. В настройках сообщества на странице Работа с API нажмите кнопку Создать ключ, чтобы сгенерировать ключ доступа (authToken).




       3. Выберите нужные права для ключа доступа и нажмите кнопку Создать.

Если вы не предоставите доступ к нужному разрешению,  то в дальнейшем потребуется сгенерировать ключ с новым разрешением и заново пройти процесс интеграции.

Заранее подумайте, какие разрешения могут понадобиться вашему боту в будущем.



4. В открывшемся окне введите код подтверждения и нажмите кнопку Отправить код.




5. Скопируйте и сохраните созданный ключ доступа. Он понадобится для привязки бота.



Получение токена подтверждения

  1. На вкладке Callback API в разделе Настройки сервера в поле Версия API выберите версию API 5.92.




      2. Скопируйте и сохраните строку, которую должен вернуть сервер - это токен подтверждения (confirmationToken). Он понадобится для привязки бота.

      3. Задайте секретный ключ из любого сочетания символов и нажмите кнопку Сохранить.

Получение идентификатора чата

  1. Перейдите в раздел Чаты → Настройки личного кабинета Twin.



       2. Создайте новый чат. Если у вас уже есть нужный чат, нажмите на кнопку копирования рядом с названием этого чата, чтобы скопировать его идентификатор (chatId). Сохраните данный идентификатор, он понадобится для привязки бота.



Привязка бота

Настройка бота в группе ВКонтакте

  1. Укажите адрес в формате https://chat-api.twin24.ai/api/v1/webhooks/vkontakte/{authToken}/{confirmationToken}/{chatId}, где authToken - полученный ранее ключ доступа, confirmationToken - токен подтверждения, полученный ранее, и chatId - уникальный идентификатор чата, о котором шла речь в начале страницы. После этого нужно нажать кнопку Подтвердить.

AuthToken, confirmationToken и chatId необходимо указывать без фигурных скобок.

Убедитесь, что операция была выполнена удачно. Должно отображаться следующее сообщение.

       2. На вкладке Типы событий необходимо отметить только одно событие - Входящее сообщение.

Привязка бота к чату по API

  1. Перейдите на страницу Помощь → API личного кабинета и скопируйте авторизационный токен.

     2. Перейдите на страницу https://developers.twin24.ai/reference/integratewithvkontakte.

     3. В поле Authentication укажите авторизационный токен из личного кабинета.



     4. В поле chatID введите идентификатор чата, полученный на шаге Получение идентификатора чата.



     5. В поле authToken укажите авторизационный токен, полученный ранее на шаге Получение токена авторизации.



      6. В поле confirmationToken укажите токен подтверждения, полученный ранее на шаге Получение ключа доступа.



      7. Нажмите кнопку Try it!

После успешной привязки ниже кнопки Try it! будет показано окно с кодом 200.

Включение сообщений группы ВКонтакте

  1. На странице сообщества в разделе Управление выберите подраздел Сообщения и включите Сообщения сообщества.



2. Перейдите в раздел Настройки для ботов и включите параметр Возможности ботов.



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