Linear

  Integrasi Linear menghadirkan kemampuan manajemen proyek yang kuat ke chatbot bertenaga AI Anda. Hubungkan Botpress dengan Linear, alat pelacakan masalah dan manajemen alur kerja modern. Dengan integrasi ini, Anda dapat mengotomatiskan pembuatan tugas, melacak kemajuan, dan berkolaborasi dalam proyek secara langsung di dalam chatbot Anda. Berdayakan chatbot Anda untuk membuat, memperbarui, dan mengambil masalah Linear , memberikan tugas kepada anggota tim, melacak tanggal jatuh tempo, dan banyak lagi. Sederhanakan proses manajemen proyek Anda dan tingkatkan produktivitas tim dengan Integrasi Linear untuk Botpress.

## Migrasi dari versi `0.x` ke `1.x`

Versi `1.0` dari integrasi Linear sekarang mengharuskan pengguna untuk memberikan rahasia penandatanganan webhook . Jika Anda menggunakan autentikasi OAuth, Anda tidak terpengaruh oleh perubahan ini. Jika Anda menggunakan kunci API untuk mengautentikasi dengan Linear, Anda harus memberikan rahasia penandatanganan webhook untuk memastikan komunikasi yang aman antara Botpress dan Linear. Untuk mendapatkan rahasia penandatanganan webhook , ikuti petunjuk di bagian _Konfigurasi manual dengan kunci API_ di bawah ini.

## Konfigurasi

### Konfigurasi otomatis dengan OAuth (disarankan)

Ini adalah cara paling sederhana untuk mengatur integrasi. Untuk mengatur integrasi Linear menggunakan OAuth, klik tombol otorisasi dan ikuti instruksi untuk menghubungkan chatbot Botpress Anda ke Linear. Metode ini direkomendasikan karena menyederhanakan proses konfigurasi dan memastikan komunikasi yang aman antara chatbot Anda dan Linear.

Saat menggunakan mode konfigurasi ini, aplikasi Botpress yang dikelola Linear akan digunakan untuk terhubung ke ruang kerja Linear Anda. Aplikasi ini akan memiliki izin yang diperlukan untuk mengelola masalah, komentar, dan melakukan operasi atas nama pengguna Anda. Jika Anda memerlukan kontrol yang lebih terperinci atas izin, Anda dapat memilih mode konfigurasi manual.

### Konfigurasi manual dengan kunci API

Jika Anda lebih suka mengonfigurasi integrasi secara manual, Anda dapat memberikan kunci API untuk menghubungkan akun Linear pribadi Anda ke Botpress. Ingatlah bahwa ketika Anda menggunakan kunci API, tindakan yang diambil oleh bot akan dikaitkan dengan akun Linear pribadi Anda. Jika Anda ingin agar tindakan dikaitkan dengan organisasi Anda dan bukan ke akun pribadi Anda, Anda harus menggunakan autentikasi OAuth. Otentikasi OAuth menawarkan banyak keuntungan dibandingkan kunci API dan tidak menghabiskan tempat di dalam organisasi Linear Anda.

Untuk menyiapkan integrasi Linear menggunakan kunci API pribadi, ikuti langkah-langkah berikut ini:

### Membuat kunci API Linear 

1. Di Linear, buka pengaturan akun Anda dan pilih tab API di bilah sisi navigasi.
2. Di bawah _Kunci API pribadi_, masukkan nama untuk kunci API Anda dan klik tombol _Buat kunci API baru_.
3. Simpan kunci API ini di lokasi yang aman. Anda akan memerlukannya untuk mengonfigurasi integrasi Linear di Botpress.

### Berlangganan ke acara Linear webhook  

1. Di Botpress, buka halaman konfigurasi integrasi untuk Linear.
2. Salin URL webhook yang dihasilkan oleh Botpress.
3. Di Linear, buka pengaturan akun Anda dan pilih tab API di bilah sisi navigasi.
4. Di bawah _Webhooks_, klik tombol _Buat webhook_ baru.
5. Masukkan nama untuk webhook dan tempelkan URL webhook yang dibuat oleh Botpress di bidang _URL_.
6. Salin rahasia penandatanganan webhook di lokasi yang aman. Anda akan membutuhkannya untuk mengonfigurasi integrasi Linear di Botpress.
7. Di bawah _Peristiwa perubahan data_, pilih peristiwa yang ingin Anda berlangganan:

- `Masalah`: Menerima notifikasi ketika isu dibuat, diperbarui, atau dihapus.
- `Komentar`: Menerima notifikasi ketika komentar ditambahkan ke isu.

8. Di bawah _Teams_, pilih tim yang ingin Anda terima notifikasinya.
9. Klik tombol _Buat webhook_ untuk menyimpan perubahan Anda.

### Mengonfigurasi integrasi Linear di Botpress

1. Di Botpress, buka halaman konfigurasi integrasi untuk Linear.
2. Pilih opsi _Konfigurasi Linear dengan Kunci API_.
3. Masukkan kunci API yang Anda peroleh dari Linear di bidang _API Key_.
4. Masukkan rahasia penandatanganan webhook yang Anda peroleh dari Linear di bidang _Secret Penandatanganan Webhook_.
5. Simpan konfigurasi dan aktifkan integrasi.
6. Salin URL webhook yang dihasilkan oleh Botpress.

## Keterbatasan

Batasan API Linear standar berlaku untuk integrasi Linear di Botpress. Batasan ini termasuk batasan tarif, batasan ukuran payload, dan batasan lain yang diberlakukan oleh platform Linear . Pastikan bot Anda mematuhi batasan ini untuk mempertahankan kinerja dan keandalan yang optimal.

Rincian lebih lanjut tersedia di [Linear dokumentasi API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).