> ## 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, щоб надсилати до вашого робочого простору сповіщення про навчання, сповіщення системи безпеки та оновлення Playbook.

Інтеграція зі Slack дає змогу Living Security надсилати сповіщення безпосередньо до вашого робочого простору Slack. Повідомляйте користувачів про призначені Training, сповіщайте команди безпеки про події, пов’язані з ризиками, та інформуйте керівників про прогрес їхніх команд.

<Note>
  Щоб налаштувати доставлення Nudge і Playbook, перейдіть до **Settings → Communications → Channels** і натисніть картку **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>
      Ваш застосунок з’явиться на Dashboard 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="Отримайте Signing Secret">
    1. На бічній панелі ліворуч натисніть **Basic Information**
    2. Прокрутіть до **App Credentials**
    3. Скопіюйте **Signing Secret**

    <Warning>
      Зберігайте Signing Secret у таємниці. Ніколи не публікуйте його в публічних репозиторіях або журналах.
    </Warning>
  </Step>
</Steps>

## Додавання облікових даних у Living Security

<Steps>
  <Step title="Перейдіть до Outbound Integrations">
    Перейдіть до **Settings → Integrations → Outbound** і натисніть картку **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="Збережіть і перевірте">
    Натисніть **Save**. Облікові дані з’являться у вашому списку зі статусом **active**.

    <Check>
      Вашу інтеграцію зі Slack підключено, і вона готова надсилати сповіщення.
    </Check>
  </Step>
</Steps>

## Типи сповіщень

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

| Сповіщення | Опис |
| - | - |
| Призначення Training | Повідомляє користувачів про нові призначені Training |
| Нагадування про Training | Нагадує користувачам про наближення кінцевих термінів |
| Підтвердження завершення | Підтверджує завершення Training |
| Сповіщення системи безпеки | Повідомляє команди безпеки про події, пов’язані з ризиками |
| Підсумки Playbook | Надсилає періодичні оновлення щодо результативності Playbook |

## Усунення несправностей

<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="/uk/integrations/outbound/email">
    Налаштуйте електронну пошту як канал доставлення.
  </Card>

  <Card title="Інтеграція з Teams" icon="microsoft" href="/uk/integrations/outbound/teams">
    Налаштуйте Microsoft Teams як канал доставлення.
  </Card>

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

  <Card title="Як налаштувати нову інтеграцію" icon="plug" href="/uk/integrations/managing/setup">
    Загальний посібник із налаштування інтеграцій.
  </Card>
</CardGroup>


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