> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/integrations/vk.md).

# Вконтакте

<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 в качестве канала связи.

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

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

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

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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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%2FPo3PFbYZdOFe9ZPzFpP4%2Fimage.png?alt=media&amp;token=76be11cd-baa0-45f5-ae9b-7150c36301ff" 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&amp;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&amp;token=4c87a8f2-e66b-4be9-8f3f-b03c431164f1" alt=""><figcaption></figcaption></figure>

11\. **Подключение завершено.** В Nextbot в блоке подключения VK над полем «Ключ доступа» проверьте статус — должно отображаться «подключено».

Чтобы отключить ВКонтакте или удалить данные подключения, воспользуйтесь инструкцией в разделе «Отключение ВКонтакте и удаление настроек».

Если вы вдруг случайно выбрали неверную версию 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&amp;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&amp;token=2fa864ef-ec38-4d60-b209-d39d7d31f32a" alt=""><figcaption></figcaption></figure>

### Отключение ВКонтакте и удаление настроек

#### Как отключить ВКонтакте и сохранить настройки <a href="#undefined" id="undefined"></a>

1. Нажмите «Отключить».
2. Подтвердите отключение в появившемся окне.

Nextbot удалит Callback-сервер из сообщества ВКонтакте. Ключ доступа и строка возврата останутся в настройках агента.

Используйте «Отключить», если нужно отключить канал, но сохранить данные подключения, а «Удалить настройки», если нужно удалить данные подключения.

#### Как удалить настройки ВКонтакте <a href="#undefined" id="undefined"></a>

Откройте карточку агента → «Интеграции» → «VK» и нажмите «Удалить настройки».

Nextbot удалит Callback-сервер из сообщества ВКонтакте, а затем — настройки подключения из агента. Заранее отключать интеграцию или удалять сервер вручную не нужно.

### Что происходит при удалении агента <a href="#undefined" id="undefined"></a>

При удалении агента Nextbot автоматически удаляет связанный с ним Callback-сервер из сообщества ВКонтакте.

Если удалить сервер не удалось, Nextbot всё равно прекращает обработку событий из сообщества для удалённого агента.

#### Как проверить, что сервер удалён <a href="#undefined" id="undefined"></a>

В сообществе ВКонтакте откройте «Управление» → «Работа с API» → «Callback API» → «Настройки сервера».

После успешного отключения интеграции или удаления её настроек Callback-сервер Nextbot должен отсутствовать в списке.

### Как начать общение с клиентами

После подключения сообщества ВКонтакте к Nextbot клиенты могут общаться с ИИ-агентом через сообщения сообщества.

#### Как клиенту написать в сообщество <a href="#undefined" id="undefined"></a>

1. Откройте страницу сообщества ВКонтакте.
2. Нажмите кнопку «Сообщение» в верхней части страницы.
3. В открывшемся диалоге напишите вопрос и отправьте сообщение.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F2bpBcFdLep9MwNoQSQdV%2Fimage.png?alt=media&amp;token=f698d177-6a9d-40cd-b222-190b26479a02" alt=""><figcaption></figcaption></figure>

#### Где смотреть переписку в Nextbot <a href="#nextbot" id="nextbot"></a>

Откройте раздел «Диалоги» у подключённого агента и выберите переписку с клиентом из ВКонтакте. Здесь отображаются сообщения клиента и ответы агента, в том числе сообщения с товарами из магазина сообщества.

### Сообщения с карточками товаров

Nextbot поддерживает сообщения с карточками товаров из магазина сообщества ВКонтакте. Клиент может отправить карточку вместе с вопросом, а агент получит сведения о товаре и его фотографию.

#### Что нужно для работы с товарами <a href="#undefined" id="undefined"></a>

* Сообщество ВКонтакте должно быть подключено к агенту в Nextbot.
* В сообществе должен быть включён раздел «Товары» и добавлены товары.
* Для обработки карточек с фотографиями у агента должно быть включено распознавание изображений в Настройках агента -> [Изображения](https://doc.nextbot.ru/functional/setting-up-agent.md#izobrazheniya).

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

#### Как клиенту задать вопрос о товаре <a href="#undefined" id="undefined"></a>

1. Откройте раздел «Товары» на странице сообщества.
2. Выберите нужный товар.
3. В карточке товара нажмите «Написать».
4. ВКонтакте откроет переписку с сообществом и прикрепит карточку товара к сообщению. Может быть подставлен текст: «Здравствуйте! Меня заинтересовал этот товар».
5. Добавьте свой вопрос или оставьте предложенный текст, затем отправьте сообщение.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F3SpHz9KiHlSQoXLJjO7T%2Fimage.png?alt=media&amp;token=ad0cdab8-1b81-4cd8-a0a4-59ca15c46ca7" alt=""><figcaption></figcaption></figure>

#### Как карточка отображается в Nextbot <a href="#nextbot" id="nextbot"></a>

В разделе «Диалоги» сообщение с товаром отображается как фотография и текстовый блок. В него входят:

* сообщение клиента, если оно есть;
* название товара;
* цена;
* описание;
* артикул, если он указан;
* ссылка на товар во ВКонтакте.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
