Пройдя все шаги, вы настроите интеграцию вашего бота для работы с сообщениями в сообществе или на публичной странице ВКонтакте.
¶ Подготовительные шаги
¶ 1. Создайте сообщество во ВКонтакте
- Перейдите на страницу социальной сети ВКонтакте.
- Перейдите в раздел Сообщества на панели управления.
- Нажмите кнопку Создать сообщество. Откроется окно с выбором цели создания сообщества.
- Выберите из предложенного списка цель создания сообщества, которая максимально раскрывает вашу потребность.
- Введите название сообщества.
- Укажите приватность сообщества: открытое или закрытое.
- Активируйте ползунок, если хотите, чтобы ваше сообщество невозможно было найти с помощью поиска, оно будет доступно только по ссылке. По умолчанию ползунок неактивен.
- Нажмите Продолжить.
- Выберите подходящую тематику из предложенного списка для сообщества.
- Нажмите Создать сообщество. На экране отобразится окно с сообщением о создании сообщества.
¶ 2. Получите ключ доступа
- Перейдите на страницу ранее созданного сообщества.
- Нажмите Управление в левом боковом меню.
- Нажмите Работа с API в настройках сообщества.
- Нажмите кнопку Создать ключ, чтобы сгенерировать ключ доступа (authToken).
-
Выберите обязательные права для ключа доступа:
- к управлению сообществом;
- к сообщениям сообщества;
- к фотографиям и документам.
-
Выберите дополнительные права доступа и нажмите кнопку Создать. На номер телефона, указанный при регистрации, поступит уведомление с подтверждением создания ключа для сообщества.
Заранее обдумайте все возможные разрешения для вашего бота. Если не предоставить необходимое разрешение сейчас, придется генерировать новый ключ и повторно проходить процесс интеграции.
- Нажмите Подтвердить.
- Скопируйте и сохраните созданный ключ доступа. Он понадобится для привязки бота.
¶ 3. Получите токен подтверждения
- Перейдите на вкладку Callback API.
- Версия API: из выпадающего списка выберите версию
5.92. - Строка, которую должен вернуть сервер: скопируйте и сохраните токен подтверждения (confirmationToken). Он понадобится для привязки бота.
- Секретный ключ: вставьте токен подтверждения, скопированный на предыдущем шаге.
- Нажмите Сохранить.
¶ 4. Получите идентификатор чата
- Перейдите в раздел Текстовые боты личного кабинета платформы.
- Создайте новый чат. Если у вас уже есть нужный чат, скопируйте идентификатор чата (chatId). Для этого нажмите на ID слева от названия чата. Сохраните данный идентификатор, он понадобится для привязки чата.
¶ 5. Настройка бота в группе ВКонтакте
- Вернитесь на страницу сообщества ВКонтакте.
- Адрес: укажите адрес в формате
https://chat-api.twin24.ai/api/v1/webhooks/vkontakte/{authToken}/{confirmationToken}/{chatId}, гдеauthToken– полученный ранее ключ доступа,confirmationToken– токен подтверждения, иchatId– уникальный идентификатор чата.
Значения
authToken,confirmationTokenиchatIdследует указывать без фигурных скобок.
- Нажмите кнопку Подтвердить. На экране отобразится уведомление об успешном сохранении изменений.
- Перейдите на вкладку Типы событий.
- Отметьте только одно событие – Входящее сообщение.
¶ Привязка бота
- Перейдите в личный кабинет платформы → Текстовые боты.
- Наведите курсор на строку нужного чата и нажмите на
→ Интеграция. - Перейдите на вкладку ВКонтакте.
- Ключ доступа (authToken): вставьте скопированный на шаге 2 ключ доступа.
- Токен подтверждения (confirmationToken): вставьте скопированный на шаге 3 токен.
- Активируйте ползунок Использовать эту интеграцию.
¶ Включение сообщений группы ВКонтакте
- Перейдите в раздел Управление на странице сообщества.
- Перейдите в раздел Сообщения.
- Сообщения сообщества: включены.
- Нажмите Сохранить.
- Перейдите в раздел Настройки для бота.
- Возможности ботов: включены.
- Нажмите Сохранить.
После выполнения всех шагов бот будет привязан к сообщениям группы ВКонтакте и сможет отвечать на сообщения пользователей.