> ## 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.

# Integracja ze Slack

> Połącz Living Security ze Slack, aby wysyłać do swojego obszaru roboczego powiadomienia o szkoleniach, alerty bezpieczeństwa i aktualizacje Playbook.

Integracja ze Slack umożliwia Living Security wysyłanie powiadomień bezpośrednio do Państwa obszaru roboczego Slack. Można informować użytkowników o przypisanych szkoleniach, alarmować zespoły ds. bezpieczeństwa o zdarzeniach związanych z ryzykiem oraz na bieżąco informować menedżerów o postępach zespołu.

<Note>
  Aby skonfigurować dostarczanie Podpowiedzi i Playbook, przejdź do **Ustawienia → Komunikacja → Kanały** i kliknij kartę **Slack**. Ta strona opisuje podstawową konfigurację aplikacji Slack.
</Note>

## Wymagania wstępne

Przed skonfigurowaniem integracji ze Slack upewnij się, że posiadasz:

* uprawnienia administratora obszaru roboczego Slack lub uprawnienia do instalowania aplikacji,
* dostęp do portalu Slack API pod adresem [api.slack.com](https://api.slack.com),
* uprawnienia administratora w Living Security.

## Tworzenie aplikacji Slack

<Steps>
  <Step title="Utwórz nową aplikację Slack">
    1. Przejdź do [api.slack.com/apps](https://api.slack.com/apps)
    2. Kliknij **Create New App**
    3. Wybierz **From scratch**
    4. Wprowadź nazwę aplikacji (np. „Living Security")
    5. Wybierz swój obszar roboczy
    6. Kliknij **Create App**

    <Check>
      Aplikacja pojawi się w panelu Slack API.
    </Check>
  </Step>

  <Step title="Skonfiguruj zakresy OAuth">
    1. W lewym panelu bocznym kliknij **OAuth & Permissions**
    2. Przewiń do sekcji **Bot Token Scopes**
    3. Dodaj następujące zakresy:

    | Zakres | Przeznaczenie |
    | - | - |
    | `chat:write` | Wysyłanie wiadomości na kanały |
    | `chat:write.public` | Wysyłanie wiadomości na kanały bez dołączania do nich |
    | `users:read` | Wyszukiwanie informacji o użytkownikach |
    | `users:read.email` | Dopasowywanie użytkowników na podstawie adresu e-mail |

    <Tip>
      Dodawaj tylko te zakresy, których potrzebuje Twoja organizacja. Mniejsza liczba zakresów oznacza lepsze bezpieczeństwo.
    </Tip>
  </Step>

  <Step title="Zainstaluj aplikację w obszarze roboczym">
    1. Przewiń na górę strony **OAuth & Permissions**
    2. Kliknij **Install to Workspace**
    3. Przejrzyj uprawnienia i kliknij **Allow**

    <Check>
      Pojawi się **Bot User OAuth Token** zaczynający się od `xoxb-`.
    </Check>
  </Step>

  <Step title="Pobierz klucz podpisywania">
    1. W lewym panelu bocznym kliknij **Basic Information**
    2. Przewiń do sekcji **App Credentials**
    3. Skopiuj **Signing Secret**

    <Warning>
      Zachowaj klucz podpisywania w tajemnicy. Nigdy nie udostępniaj go w publicznych repozytoriach ani w logach.
    </Warning>
  </Step>
</Steps>

## Dodawanie poświadczeń w Living Security

<Steps>
  <Step title="Przejdź do integracji wychodzących">
    Przejdź do **Ustawienia → Integracje → Wyjście** i kliknij kartę **Slack**.
  </Step>

  <Step title="Dodaj poświadczenia">
    Kliknij **Add Credential** i wprowadź:

    <ParamField body="botToken" type="string" required>
      Twój Bot User OAuth Token zaczynający się od `xoxb-`. Znajdziesz go w sekcji **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Signing Secret Twojej aplikacji. Znajdziesz go w sekcji **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Opcjonalnie. Wymagany tylko w przypadku połączeń w trybie Socket Mode. Zaczyna się od `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Opcjonalnie. Przyjazna nazwa tych poświadczeń (np. „Production Slack").
    </ParamField>
  </Step>

  <Step title="Zapisz i zweryfikuj">
    Kliknij **Zapisz**. Poświadczenia pojawią się na liście ze statusem **aktywny**.

    <Check>
      Integracja ze Slack jest teraz połączona i gotowa do wysyłania powiadomień.
    </Check>
  </Step>
</Steps>

## Typy powiadomień

Po nawiązaniu połączenia Living Security może wysyłać do Slack następujące typy powiadomień:

| Powiadomienie | Opis |
| - | - |
| Przypisanie Szkolenia | Powiadamia użytkowników o przypisaniu nowego Szkolenia |
| Przypomnienia o Szkoleniu | Przypominają użytkownikom o zbliżających się terminach |
| Potwierdzenia ukończenia | Potwierdzają ukończenie Szkolenia |
| Alerty bezpieczeństwa | Powiadamiają zespoły ds. bezpieczeństwa o zdarzeniach związanych z ryzykiem |
| Podsumowania Playbook | Wysyłają okresowe aktualizacje dotyczące skuteczności Playbook |

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Wiadomości nie pojawiają się na kanałach">
    * Sprawdź, czy bot został zaproszony na kanał (`/invite @YourBotName`)
    * Sprawdź, czy dodano zakres `chat:write.public`, który umożliwia publikowanie na kanałach publicznych bez dołączania do nich
    * Upewnij się, że identyfikator kanału jest prawidłowy (użyj identyfikatora kanału, a nie nazwy)
  </Accordion>

  <Accordion title="Błąd nieprawidłowego tokenu">
    * Upewnij się, że skopiowano kompletny token zaczynający się od `xoxb-`
    * Sprawdź, czy aplikacja nadal jest zainstalowana w Twoim obszarze roboczym
    * Sprawdź, czy token nie został wygenerowany ponownie (wymaga to aktualizacji w Living Security)
  </Accordion>

  <Accordion title="Ograniczenia liczby żądań">
    Slack ogranicza liczbę żądań API. Jeśli pojawiają się błędy związane z przekroczeniem limitu:

    * Zmniejsz częstotliwość wysyłania powiadomień
    * Połącz wiele powiadomień w zbiorcze wiadomości podsumowujące
    * Skontaktuj się z pomocą techniczną w przypadku scenariuszy o dużym wolumenie
  </Accordion>
</AccordionGroup>

## Najlepsze praktyki

<Tip>
  Utwórz dedykowany kanał Slack dla powiadomień Living Security (np. `#security-training`), aby uporządkować alerty i ograniczyć szum na kanałach ogólnych.
</Tip>

* Używaj czytelnych etykiet poświadczeń podczas zarządzania wieloma obszarami roboczymi
* Regularnie sprawdzaj, które kanały otrzymują powiadomienia
* Dla alertów o dużym wolumenie skonfiguruj zbiorcze podsumowania powiadomień zamiast pojedynczych wiadomości
* Co kwartał przeglądaj uprawnienia aplikacji Slack i usuwaj nieużywane zakresy

## Powiązane

<CardGroup cols={2}>
  <Card title="Integracja poczty e-mail" icon="envelope" href="/pl/integrations/outbound/email">
    Skonfiguruj pocztę e-mail jako kanał dostarczania.
  </Card>

  <Card title="Integracja z Teams" icon="microsoft" href="/pl/integrations/outbound/teams">
    Skonfiguruj Microsoft Teams jako kanał dostarczania.
  </Card>

  <Card title="Dziennik komunikacji" icon="clock-rotate-left" href="/pl/features/communications/log">
    Śledź status i historię dostarczania wiadomości w Slack.
  </Card>

  <Card title="Jak skonfigurować nową integrację" icon="plug" href="/pl/integrations/managing/setup">
    Ogólny przewodnik konfiguracji integracji.
  </Card>
</CardGroup>


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