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

# Integrasi Slack

> Hubungkan Living Security ke Slack untuk mengirimkan notifikasi pelatihan, peringatan keamanan, dan pembaruan buku pedoman ke workspace Anda.

Integrasi Slack memungkinkan Living Security mengirimkan notifikasi langsung ke workspace Slack Anda. Beri tahu pengguna tentang penugasan pelatihan, peringatkan tim keamanan tentang peristiwa risiko, dan jaga agar manajer tetap mendapat informasi mengenai kemajuan tim.

<Note>
  Untuk pengaturan pengiriman dorongan dan buku pedoman, mulailah dari **Pengaturan → Komunikasi → Saluran** lalu klik kartu **Slack**. Halaman ini membahas konfigurasi aplikasi Slack yang mendasarinya.
</Note>

## Prasyarat

Sebelum mengonfigurasi integrasi Slack, pastikan Anda memiliki:

* Izin admin workspace Slack atau izin untuk menginstal aplikasi
* Akses ke portal Slack API di [api.slack.com](https://api.slack.com)
* Hak akses admin Living Security

## Membuat Aplikasi Slack

<Steps>
  <Step title="Buat aplikasi Slack baru">
    1. Buka [api.slack.com/apps](https://api.slack.com/apps)
    2. Klik **Create New App**
    3. Pilih **From scratch**
    4. Masukkan nama aplikasi (misalnya, "Living Security")
    5. Pilih workspace Anda
    6. Klik **Create App**

    <Check>
      Aplikasi Anda muncul di dasbor Slack API.
    </Check>
  </Step>

  <Step title="Konfigurasikan cakupan OAuth">
    1. Di bilah sisi kiri, klik **OAuth & Permissions**
    2. Gulir ke **Bot Token Scopes**
    3. Tambahkan cakupan berikut:

    | Cakupan | Tujuan |
    | - | - |
    | `chat:write` | Mengirim pesan ke kanal |
    | `chat:write.public` | Mengirim pesan ke kanal tanpa bergabung |
    | `users:read` | Mencari informasi pengguna |
    | `users:read.email` | Mencocokkan pengguna berdasarkan alamat email |

    <Tip>
      Tambahkan hanya cakupan yang dibutuhkan organisasi Anda. Semakin sedikit cakupan, semakin baik keamanannya.
    </Tip>
  </Step>

  <Step title="Instal aplikasi ke workspace Anda">
    1. Gulir ke bagian atas **OAuth & Permissions**
    2. Klik **Install to Workspace**
    3. Tinjau izin yang diminta, lalu klik **Allow**

    <Check>
      **Bot User OAuth Token** muncul dengan awalan `xoxb-`.
    </Check>
  </Step>

  <Step title="Dapatkan signing secret Anda">
    1. Di bilah sisi kiri, klik **Basic Information**
    2. Gulir ke **App Credentials**
    3. Salin **Signing Secret**

    <Warning>
      Jaga kerahasiaan signing secret Anda. Jangan pernah membagikannya di repositori publik atau log.
    </Warning>
  </Step>
</Steps>

## Menambahkan Kredensial ke Living Security

<Steps>
  <Step title="Buka Integrasi Keluar">
    Buka **Pengaturan → Integrasi → Keluar** lalu klik kartu **Slack**.
  </Step>

  <Step title="Tambahkan kredensial Anda">
    Klik **Add Credential** lalu masukkan:

    <ParamField body="botToken" type="string" required>
      Bot User OAuth Token Anda yang diawali dengan `xoxb-`. Dapat ditemukan di **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Signing Secret aplikasi Anda. Dapat ditemukan di **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Opsional. Diperlukan hanya untuk koneksi Socket Mode. Diawali dengan `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Opsional. Nama yang mudah dikenali untuk kredensial ini (misalnya, "Production Slack").
    </ParamField>
  </Step>

  <Step title="Simpan dan verifikasi">
    Klik **Simpan**. Kredensial akan muncul di daftar Anda dengan status **aktif**.

    <Check>
      Integrasi Slack Anda kini terhubung dan siap mengirimkan notifikasi.
    </Check>
  </Step>
</Steps>

## Jenis Notifikasi

Setelah terhubung, Living Security dapat mengirimkan jenis notifikasi berikut ke Slack:

| Notifikasi | Deskripsi |
| - | - |
| Penugasan pelatihan | Memberi tahu pengguna saat pelatihan baru ditugaskan |
| Pengingat pelatihan | Mengingatkan pengguna tentang tenggat waktu yang akan datang |
| Konfirmasi penyelesaian | Mengonfirmasi saat pelatihan telah diselesaikan |
| Peringatan keamanan | Memberi tahu tim keamanan tentang peristiwa risiko |
| Ringkasan buku pedoman | Mengirimkan pembaruan berkala tentang kinerja buku pedoman |

## Pemecahan Masalah

<AccordionGroup>
  <Accordion title="Pesan tidak muncul di kanal">
    * Pastikan bot telah diundang ke kanal (`/invite @YourBotName`)
    * Periksa apakah cakupan `chat:write.public` telah ditambahkan untuk memposting ke kanal publik tanpa bergabung
    * Pastikan ID kanal sudah benar (gunakan ID kanal, bukan nama)
  </Accordion>

  <Accordion title="Kesalahan token tidak valid">
    * Pastikan Anda menyalin token secara lengkap dengan awalan `xoxb-`
    * Pastikan aplikasi masih terinstal di workspace Anda
    * Periksa apakah token telah dibuat ulang (perlu diperbarui di Living Security)
  </Accordion>

  <Accordion title="Pembatasan laju">
    Slack membatasi permintaan API. Jika Anda melihat kesalahan pembatasan laju:

    * Kurangi frekuensi notifikasi
    * Gabungkan beberapa notifikasi menjadi pesan ringkasan
    * Hubungi dukungan untuk kasus penggunaan dengan volume tinggi
  </Accordion>
</AccordionGroup>

## Praktik Terbaik

<Tip>
  Buat kanal Slack khusus untuk notifikasi Living Security (misalnya, `#security-training`) agar peringatan tetap tertata dan mengurangi kebisingan di kanal umum.
</Tip>

* Gunakan label kredensial yang bermakna saat mengelola beberapa workspace
* Audit secara berkala kanal mana saja yang menerima notifikasi
* Siapkan ringkasan notifikasi, bukan pesan individual, untuk peringatan bervolume tinggi
* Tinjau izin aplikasi Slack setiap kuartal dan hapus cakupan yang tidak digunakan

## Terkait

<CardGroup cols={2}>
  <Card title="Integrasi Email" icon="envelope" href="/id/integrations/outbound/email">
    Konfigurasikan email sebagai saluran pengiriman.
  </Card>

  <Card title="Integrasi Teams" icon="microsoft" href="/id/integrations/outbound/teams">
    Konfigurasikan Microsoft Teams sebagai saluran pengiriman.
  </Card>

  <Card title="Log Komunikasi" icon="clock-rotate-left" href="/id/features/communications/log">
    Lacak status dan riwayat pengiriman Slack.
  </Card>

  <Card title="Cara Menyiapkan Integrasi Baru" icon="plug" href="/id/integrations/managing/setup">
    Panduan umum penyiapan integrasi.
  </Card>
</CardGroup>


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