# Вконтакте

<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="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FV7QtP3x8L11ko0ERHtJB%2Fimage.png?alt=media&#x26;token=906f1471-941c-4574-ac32-9ac513ea6757" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FgFjLUTyOC8AECzeUADN9%2Fimage.png?alt=media&#x26;token=06f8be7a-8611-4f5e-a2c1-d1bad622c98d" alt="" width="563"><figcaption></figcaption></figure>

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

<div data-full-width="false"><figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FONeVPPXshLUbYKaMvPvJ%2Fimage.png?alt=media&#x26;token=00f9ffa8-9420-4721-8c88-24c2af562b6f" alt="" width="563"><figcaption></figcaption></figure></div>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FX1oDCw00CuXWsi87ToPw%2Fimage.png?alt=media&#x26;token=52dc983a-65bd-4dea-92b1-f575449238c8" alt="" width="563"><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FDomBib8EzegOZPscH7XC%2Fimage.png?alt=media&#x26;token=601c4092-05fa-4650-a379-a8f63acdb29b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-b0fab53ab3a0789ff4cae1b543b42982a705d0e7%2F2024-09-18_16-24-31.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FTiiJei9MClASnIMZyUR1%2Fimage.png?alt=media&#x26;token=cfdfea8f-e919-4f62-8f17-6dfe71fcff9c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FnDVAFl7Ca4XxFGHdinwe%2Fimage.png?alt=media&#x26;token=d36e8802-1eb9-4ef2-b9dc-6657ecfa4a99" alt="" width="563"><figcaption></figcaption></figure>

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-cd8987e59405472bee977e398cac17d8e5f05706%2F7.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FlR0vNaSJRnW7yX6XDm8Q%2Fimage.png?alt=media&#x26;token=f6e22c98-9677-4597-adc5-3aaac4a988b1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F8zvCr0pYsIxK5qugkHyj%2Fimage.png?alt=media&#x26;token=7e7745c4-87ab-43aa-bb15-f388540e3e9c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FYWZ5YEDW0Ev2aJylx5Os%2Fimage.png?alt=media&#x26;token=4c87a8f2-e66b-4be9-8f3f-b03c431164f1" alt=""><figcaption></figcaption></figure>

11\. Готово.

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Ffd5sBRqvIQxFEns9nO6u%2F%7BBA52D25D-8818-46CD-B336-375BFB48DC45%7D.png?alt=media&#x26;token=4d7f192a-8899-4e22-9593-05154c346040" alt="" width="225"><figcaption></figcaption></figure>

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FMOpfbFBOoceFXEeHosak%2F%7B50D67EFA-4603-44EF-8268-92C101350454%7D.png?alt=media&#x26;token=2fa864ef-ec38-4d60-b209-d39d7d31f32a" alt=""><figcaption></figcaption></figure>
