> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Federated

> Настройка коннектора Slack Federated

## Обновление за январь 2026

В июне 2025 года Slack ввёл изменения в условиях использования и API,
которые запретили клиентам индексировать собственные данные. Yahont представил коннектор Slack Federated,
использующий API поиска как альтернативу индексирующему коннектору. Однако недавно Slack отменил эти ограничения API,
и индексирующий коннектор снова может работать.

Мы выяснили, что индексирующий коннектор находит релевантные результаты значительно лучше, чем API поиска Slack.
Мы настоятельно рекомендуем по возможности использовать [индексирующий коннектор
Slack](/admins/connectors/official/slack/slack_indexed).

## Настройка

### Авторизация

**1. Предварительное условие**

Чтобы настроить коннектор, нужно быть администратором рабочего пространства Slack.

**2. Откройте приложения Slack**

Откройте и войдите на [https://api.slack.com/apps](https://api.slack.com/apps).

**3. Создайте новое приложение**

Нажмите кнопку **Create New App** в правом верхнем углу. Выберите вариант **From an app manifest**.
Выберите нужное рабочее пространство в раскрывающемся списке и нажмите **Next**.

![Создание приложения Slack с выбранным вариантом манифеста](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/slack/SlackApp.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=2dd1d59a23d411e9264d84566da334f5)

**4. Вставьте манифест**

Выберите вкладку «YAML», вставьте в текстовое поле следующий манифест и нажмите **Next**:

```
display_information:
  name: Onyx Search Assistant
  description: Search your Slack data as yourself
  background_color: "#4A154B"

oauth_config:
  redirect_urls:
    - https://<YOUR_YAHONT_DOMAIN>/federated/oauth/callback
  scopes:
    user:
      - channels:read
      - groups:read
      - im:read
      - mpim:read
      - search:read
      - channels:history
      - groups:history
      - im:history
      - mpim:history
      - users:read

settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
```

> [!NOTE]
>
> Для Yahont Cloud значение `redirect_urls` должно быть `https://cloud.yahont.ai/federated/oauth/callback`.

> [!WARNING]
>
> Ротация токенов пока не поддерживается, поэтому `token_rotation_enabled: false` обязательно.

**1. Создайте приложение**

Нажмите кнопку **Create**.

**2. Откройте Basic Information**

На странице приложения откройте вкладку **Basic Information** в заголовке **Settings**.

**3. Скопируйте учётные данные клиента**

Скопируйте **Client ID** и **Client Secret**. Сохраните их в надёжном месте для следующего шага.

![Страница Basic Information в Slack с Client ID и Client Secret](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/slack/FederatedSlackCredentials.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=6ab85df32586097234c93c315a51f25a)

### Индексирование

**1. Откройте коннектор Slack**

Откройте панель коннекторов и выберите коннектор **Slack**.

**2. Введите учётные данные клиента**

Введите **Client ID** и **Client Secret** с шага 7.

**3. Настройте область поиска**

Настройте область поиска для федеративного коннектора. Доступны следующие параметры:

**Выбор каналов:**

* **Search All Channels**: включите, чтобы искать по всем доступным каналам. Когда включено,
  поле Channels отключается.
* **Channels**: укажите, по каким каналам искать (используется, только если Search All Channels отключён). Поддерживаются шаблоны glob (например, `general`, `eng*`, `product-*`).
* **Exclude Channels**: исключите отдельные каналы из поиска. Поддерживаются шаблоны glob (например, `secure-channel`, `private-*`, `customer*`).

**Типы сообщений:**

* **Include Direct Messages**: включать в результаты поиска личные сообщения пользователей (1:1).
* **Include Group Direct Messages**: включать в результаты поиска групповые личные сообщения (MPIM).
* **Include Private Channels**: включать в результаты поиска приватные каналы (у пользователя должен быть доступ).

**Параметры поиска:**

* **Default Search Days**: максимальное число дней, на которое искать назад (по умолчанию: 30).
  Увеличение значения может ухудшить качество ответов.
* **Max Messages Per Query**: максимальное число сообщений, получаемых за один поисковый запрос (по умолчанию: 25).
  Большие значения дают больше контекста, но могут быть медленнее.

После настройки нажмите кнопку **Create/Update**.

![Настройки коннектора Slack Federated в Yahont с учётными данными клиента](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/slack/SlackFederatedConnectorSetting.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=50671efec47ad9a8a8f0df6347f86bc7)

**4. Завершите OAuth**

Вернитесь на главную страницу чата и пройдите процесс OAuth!

> [!NOTE]
>
> Каждому пользователю нужно пройти этот процесс OAuth. Содержимое, доступное для поиска, зависит от:
>
> * Параметров конфигурации коннектора (каналы, личные сообщения, приватные каналы и т. д.)
> * Областей OAuth, предоставленных при настройке
> * Индивидуальных прав доступа пользователя в Slack
>
> Если некоторые области OAuth отсутствуют (например, `mpim:read`, `im:history`),
> коннектор спокойно продолжит поиск по другим доступным типам каналов и запишет в журнал предупреждения об
> отсутствующих областях.

![Экран согласия OAuth Slack для приложения поиска](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/slack/FederatedSlackOauth.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=827c5bc64cd3bd5480c1fbe111e1681f)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.