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

# Интеграция со Slack

> Подключите Living Security к Slack, чтобы отправлять в рабочее пространство уведомления об обучении, оповещения системы безопасности и обновления плейбуков.

Интеграция со Slack позволяет Living Security отправлять уведомления непосредственно в ваше рабочее пространство Slack. Уведомляйте пользователей о назначенном обучении, оповещайте команды безопасности о событиях риска и информируйте руководителей о прогрессе их команд.

<Note>
  Для настройки доставки подсказок и плейбуков перейдите в раздел **Настройки → Связь → Каналы** и нажмите карточку **Slack**. На этой странице описана настройка самого приложения Slack.
</Note>

## Предварительные требования

Перед настройкой интеграции со Slack убедитесь, что у вас есть:

* права администратора рабочего пространства Slack или права на установку приложений
* доступ к порталу Slack API по адресу [api.slack.com](https://api.slack.com)
* права администратора в Living Security

## Создание приложения Slack

<Steps>
  <Step title="Создайте новое приложение Slack">
    1. Перейдите на страницу [api.slack.com/apps](https://api.slack.com/apps)
    2. Нажмите **Create New App**
    3. Выберите **From scratch**
    4. Введите название приложения (например, «Living Security»)
    5. Выберите своё рабочее пространство
    6. Нажмите **Create App**

    <Check>
      Ваше приложение появится на панели управления Slack API.
    </Check>
  </Step>

  <Step title="Настройте области доступа OAuth">
    1. На боковой панели слева нажмите **OAuth & Permissions**
    2. Прокрутите страницу до раздела **Bot Token Scopes**
    3. Добавьте следующие области доступа:

    | Область доступа | Назначение |
    | - | - |
    | `chat:write` | Отправка сообщений в каналы |
    | `chat:write.public` | Отправка сообщений в каналы без присоединения к ним |
    | `users:read` | Поиск информации о пользователях |
    | `users:read.email` | Сопоставление пользователей по адресу электронной почты |

    <Tip>
      Добавляйте только те области доступа, которые необходимы вашей организации. Чем меньше областей доступа, тем выше безопасность.
    </Tip>
  </Step>

  <Step title="Установите приложение в рабочее пространство">
    1. Прокрутите страницу **OAuth & Permissions** в начало
    2. Нажмите **Install to Workspace**
    3. Ознакомьтесь с запрашиваемыми разрешениями и нажмите **Allow**

    <Check>
      Появится **Bot User OAuth Token**, начинающийся с `xoxb-`.
    </Check>
  </Step>

  <Step title="Получите секрет подписи">
    1. На боковой панели слева нажмите **Basic Information**
    2. Прокрутите страницу до раздела **App Credentials**
    3. Скопируйте **Signing Secret**

    <Warning>
      Храните секрет подписи в тайне. Никогда не публикуйте его в открытых репозиториях или журналах.
    </Warning>
  </Step>
</Steps>

## Добавление учётных данных в Living Security

<Steps>
  <Step title="Перейдите в раздел исходящих интеграций">
    Перейдите в раздел **Настройки → Интеграции → Исходящий** и нажмите карточку **Slack**.
  </Step>

  <Step title="Добавьте учётные данные">
    Нажмите **Add Credential** и введите:

    <ParamField body="botToken" type="string" required>
      Ваш Bot User OAuth Token, начинающийся с `xoxb-`. Находится в разделе **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Signing Secret вашего приложения. Находится в разделе **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Необязательный параметр. Требуется только для подключений в режиме Socket Mode. Начинается с `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Необязательный параметр. Понятное название для этих учётных данных (например, «Production Slack»).
    </ParamField>
  </Step>

  <Step title="Сохраните и проверьте">
    Нажмите **Сохранить**. Учётные данные появятся в списке со статусом **активен**.

    <Check>
      Интеграция со Slack подключена и готова к отправке уведомлений.
    </Check>
  </Step>
</Steps>

## Типы уведомлений

После подключения Living Security может отправлять в Slack уведомления следующих типов:

| Уведомление | Описание |
| - | - |
| Назначение обучения | Оповещает пользователей о назначении нового обучения |
| Напоминания об обучении | Напоминает пользователям о приближающихся сроках |
| Подтверждения завершения | Подтверждают завершение обучения |
| Оповещения системы безопасности | Уведомляют команды безопасности о событиях риска |
| Сводки по плейбукам | Отправляют периодические обновления об эффективности плейбуков |

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Сообщения не появляются в каналах">
    * Убедитесь, что бот приглашён в канал (`/invite @YourBotName`)
    * Проверьте, что добавлена область доступа `chat:write.public` для публикации в открытых каналах без присоединения к ним
    * Убедитесь, что идентификатор канала указан верно (используйте идентификатор канала, а не его название)
  </Accordion>

  <Accordion title="Ошибка недействительного токена">
    * Убедитесь, что вы скопировали токен полностью, включая начало `xoxb-`
    * Проверьте, что приложение по-прежнему установлено в вашем рабочем пространстве
    * Проверьте, не был ли токен перевыпущен (в этом случае его необходимо обновить в Living Security)
  </Accordion>

  <Accordion title="Ограничение частоты запросов">
    Slack ограничивает количество запросов к API. Если вы видите ошибки превышения лимита запросов:

    * Сократите частоту отправки уведомлений
    * Объедините несколько уведомлений в сводные сообщения
    * Обратитесь в службу поддержки, если у вас большой объём уведомлений
  </Accordion>
</AccordionGroup>

## Рекомендации

<Tip>
  Создайте отдельный канал Slack для уведомлений Living Security (например, `#security-training`), чтобы упорядочить оповещения и уменьшить количество лишних сообщений в общих каналах.
</Tip>

* Используйте понятные названия учётных данных, если вы управляете несколькими рабочими пространствами
* Регулярно проверяйте, какие каналы получают уведомления
* Для оповещений большого объёма настраивайте сводки уведомлений вместо отдельных сообщений
* Пересматривайте разрешения приложения Slack ежеквартально и удаляйте неиспользуемые области доступа

## Связанные материалы

<CardGroup cols={2}>
  <Card title="Интеграция с электронной почтой" icon="envelope" href="/ru/integrations/outbound/email">
    Настройте электронную почту в качестве канала доставки.
  </Card>

  <Card title="Интеграция с Teams" icon="microsoft" href="/ru/integrations/outbound/teams">
    Настройте Microsoft Teams в качестве канала доставки.
  </Card>

  <Card title="Журнал коммуникаций" icon="clock-rotate-left" href="/ru/features/communications/log">
    Отслеживайте статус и историю доставки сообщений в Slack.
  </Card>

  <Card title="Как настроить новую интеграцию" icon="plug" href="/ru/integrations/managing/setup">
    Общее руководство по настройке интеграций.
  </Card>
</CardGroup>


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