# Работа с ключами API в сообществе ВКонтакте

## Что такие ключ доступа сообщества

**Ключ доступа сообщества** - это уникальный токен (набор символов), который используется для связи Senler с вашим сообществом ВКонтакте через API.\
С его помощью Senler может:

* Отправлять сообщения от имени сообщества;
* Получать данные о подписчиках;
* Управлять рассылками и действиями внутри группы.

Срок действия ключа - **бессрочный**, но он может перестать работать, если:

* Изменились настройки сообщества или права;
* ВКонтакте обновил формат ключей или политику API.

> 💡 В этих случаях ключ нужно **заменить на новый**, чтобы Senler продолжал работать корректно.

С помощью такого ключа вы можете работать с API ВКонтакте от лица сообщества или публичной страницы. Например, вы можете использовать его в API-запросах, чтобы отвечать подписчикам на сообщения, которые поступают в адрес сообщества. [Более подробная информация ](https://dev.vk.com/ru/api/access-token/getting-started?ref=old_portal#%D0%9A%D0%BB%D1%8E%D1%87%20%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%B0%20%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D1%81%D1%82%D0%B2%D0%B0)

{% hint style="warning" %}
**Внимание!** Сообщество без ключей отключается в сервисе автоматически через **30 дней и все данные будут утеряны**.
{% endhint %}

## 1. Добавление ключей API в сообществе ВКонтакте

Ключи доступа ВКонтакте используются для работы с API ВКонтакте и позволяют Senler отправлять сообщения от имени вашего сообщества. Чем больше ключей добавлено, тем быстрее будет работать отправка сообщений.

Для добавления нового ключа выполните следующие действия:

1. **Раскройте пункт меню "Настройки"**: В левом меню вашей рабочей области Senler выберите "Настройки"<br>
2. **Нажмите на пункт меню "Подключение ВКонтакте"**\
   ![](/files/yCkAtke9wrkWBJmInoRQ)<br>
3. **Нажмите кнопку "Добавить ключ"**<br>

   <figure><img src="/files/DEjUD7D7y1h94pZg9b1L" alt=""><figcaption></figcaption></figure>
4. **Нажмите "Разрешить" для доступов приложения**: Откроется окно с запросом на доступ для приложения Senler. Убедитесь, что перечисленные доступы соответствуют вашим требованиям, и нажмите "Разрешить".

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

После этого ключ будет успешно добавлен и отобразится первым в списке "Ключи доступа ВКонтакте".

## 2. Удаление ключей API в сообществе ВКонтакте

### **2.1 Порядок действий для удаления ключей сообщества ВКонтакте**

Удаление ключей позволяет удалить доступ к сообществу ВКонтакте через API. Чтобы удалить ключи, необходимо выполнить следующие действия:&#x20;

1. В [vk.com](https://vk.com/) откройте **Сообщества** → нужное сообщество.
2. **Управление → Дополнительно → Работа с API**.
3. Удалите все ключи, выданные для приложения **Senler**.

> ⚠️ После удаления ключей доступ Senler прекратится. Чтобы восстановить работу — **создайте и добавьте новый ключ**.

<figure><img src="/files/DGjWrnN3sKifHSsDsllZ" alt=""><figcaption><p>Удаление ключей в Управлении сообществом ВКонтакте</p></figcaption></figure>

После удаления всех ключей при отправке запросов к API ВКонтакте будет возвращаться следующая ошибка:

{% content-ref url="/pages/-M7YcwEZus\_UMXRJaInc" %}
[Error 27 - Group authorization failed: group revoke access for this token](/senler/help/oshibki/oshibki-vkontakte/error-27-group-authorization-failed-group-revoke-access-for-this-token.md)
{% endcontent-ref %}

### 2.2 Автоматическое удаление ключей

Ключи становятся нерабочими и удаляются автоматически по следующим причинам:

* если у сотрудника, который создал ключ, удалить права доступа к сообществу ВКонтакте;
* отключение сообщений или блокировка сообщества в связи с нарушением [правил ВКонтакте;](http://vk.com/terms)
* блокировка сообщества из-за взлома.

## 3. Замена ключей ВКонтакте

Рекомендуется заменить ключ, если:

* Создан **более года назад**;
* Устаревший формат ключа (Если ваш ключ выглядит следующим образом:\
  ![](/files/2ud4CDyCkw3AdrLCejFm))
* Сервис перестал выполнять действия от имени сообщества;
* ВКонтакте изменил разрешения или политику API.

> 🧭 Практика показывает: если ключ "прошлогодний", лучше обновить его на более свежий  это снижает риск сбоев.

Для замены ключей выполните следующие действия:

1. **Удалите старые ключи**: Следуйте инструкции в пункте 2 данной статьи "Удаление ключей API в сообществе ВКонтакте".
2. Зайдите в Senler в раздел **"Настройки" — "Подключение ВКонтакте" —** нажмите **"Проверить ключи",** для того, чтобы убедиться, что ключи удалены.
3. **Добавьте новые ключи**: Следуйте инструкции в пункте 1 данной статьи "Добавление ключей API в сообществе ВКонтакте".
4. Нажмите кнопку "**Автоматическая настройка**" для актуализации интеграции с ВКонтакте.

После удаления старых и добавления новых ключей интеграция с VK API будет работать корректно.

## 4. Полезные материалы

{% embed url="<https://dev.vk.com/api/access-token/getting-started>" %}


---

# 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://help.senler.ru/senler/help/faq/voprosy-o-soobshestvakh/udalenie-klyuchei-soobshestva.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.
