# Вконтакте

<h2 align="center"><strong>Видеоурок:</strong> Вконтакте</h2>

Команда Nextbot подготовила видеоурок о подключении Вконтакте к Nextbot.

**Посмотреть на YouTube:** <https://www.youtube.com/watch?v=hlhI8hoCCMo>\
**Посмотреть на Rutube:** <https://rutube.ru/video/private/84d91de80ec706921e51c762a5ca9f1d/?p=MN0xCymCmV087z39grK9zw>

## Общие требования

Вы должны быть **администратором группы** и, следовательно, иметь права для подключения к ней ИИ-агента.

## **Мастер подключения**

**Мастер подключения —** это самый простой и быстрый способ подключить ВК к Nextbot в качестве канала связи.

<figure><img src="/files/uH6NYs6BlAPTXWl5NfSg" alt=""><figcaption></figcaption></figure>

Перейдите в раздел **«Интеграции» → «ВКонтакте»** и нажмите кнопку **«Мастер подключения»** для пошаговой настройки.\
Если вы уверенный пользователь и вам не нужны подсказки, вы можете пропустить «Мастер подключения» и перейти к стандартной настройке.

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

## **Инструкция подключения (стандартная настройка)**

1\. Откройте группу ВК, где вы хотите подключить ИИ-агента. Нажмите кнопку **«Управление»**.

<figure><img src="/files/L6o0xcoS55V9g5JZW6NS" alt="" width="563"><figcaption></figcaption></figure>

2\. Нажмите кнопку **«Дополнительно»**, а затем – **«Работа с API»** в правом меню.

<div data-full-width="false"><figure><img src="/files/xg0xP0GeeanQMMO5jY89" alt="" width="563"><figcaption></figcaption></figure></div>

3\. Нажмите кнопку **«Создать ключ»**.

<figure><img src="/files/aNo5exS2oi9cnbI2xuzI" alt="" width="563"><figcaption></figcaption></figure>

4\. Включите чек боксы:

* «Разрешить приложению доступ к управлению сообществом»
* «Разрешить приложению доступ к сообщениям сообщества»
* «Разрешить приложению доступ к фотографиям»
* «Разрешить приложению доступ к документам сообщества».

\
4.1 Нажмите кнопку **«Создать»**.

<figure><img src="/files/ncu26F8wtJFGLi0HSeZs" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Для отправки PDF-файлов через ИИ необходимо выпустить новый ключ доступа с разрешением на чтение документов. Ранее созданные ключи не поддерживают эту функцию.**
{% endhint %}

5\. Скопируйте созданный ключ и вставьте в поле **«Ключ доступа»** [странице интеграции ВКонтакте в Nextbot](https://app.nextbot.ru/integrations?tab=VkSettings).

<figure><img src="/files/qRnk8IvYd7xuLo49mYiF" alt="" width="563"><figcaption></figcaption></figure>

6\. Переключите на вкладку **«Callback API»** в группе ВК.\
6.1. Проверьте версию API (должна быть **5.131**).\
6.2. Скопируйте номер из: **«строка, которую должен вернуть сервер»**, например **fefd90**.<br>

<figure><img src="/files/ijCjh1vo2l3F6NbSAcsQ" alt=""><figcaption></figcaption></figure>

6.3. Вставьте в поле **«Строка возврата»** на [странице интеграции ВКонтакте в Nextbot](https://app.nextbot.ru/integrations?tab=VkSettings).

<figure><img src="/files/Y1KT7vhHhvoe1p5WUnct" alt="" width="563"><figcaption></figcaption></figure>

7\. Откройте в группе ВК вкладку **«Типы событий»**.\
7.1 Включите чек боксы

* **«Входящее сообщение»**
* **«Исходящее сообщение»**

<figure><img src="/files/9x0hbsVL5qTAcuncOuot" alt=""><figcaption></figcaption></figure>

8\. Скопируйте ссылку из поля **«Адрес для подключения»** на [странице интеграции ВКонтакте в Nextbot](https://app.nextbot.ru/integrations?tab=VkSettings)

<figure><img src="/files/ZZV35TQVoF5hW8lJEKJw" alt=""><figcaption></figcaption></figure>

9\. Перейдите в ВК во вкладку **«Callback API»**.\
9.1. Вкладка **«Настройки сервера»**. Введите вашу ссылку в поле **«Адрес»**.\
9.2. Нажмите кнопку **«Подтвердить»**.

<figure><img src="/files/tJ3cYg1PGE7Z89eeMIs6" alt=""><figcaption></figcaption></figure>

10\. Если все прошло успешно, то появится надпись **«Адрес сервера успешно сохранен»**

<figure><img src="/files/UWmH76mGAwRIw0AicR8R" alt=""><figcaption></figcaption></figure>

11\. Готово.

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

<figure><img src="/files/rdzBb9d3pJdzPuVGQEqY" alt="" width="225"><figcaption></figcaption></figure>

При клике на него вы увидите сообщение:

*"Получен callback из VK с неподдерживаемой версией API. Перейдите в вашу группу во ВКонтакте - Управление - Дополнительно - Работа с API - и переключитесь на вкладку «Callback API». Выберите версию API 5.131."*

<figure><img src="/files/ubc0M2T67S6Q61hoLe0N" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/functional/integrations/vk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.