Linear

  Integracja Linear zapewnia potężne możliwości zarządzania projektami w chatbocie opartym na sztucznej inteligencji. Płynnie połącz Botpress z Linear, nowoczesnym narzędziem do śledzenia spraw i zarządzania przepływem pracy. Dzięki tej integracji możesz zautomatyzować tworzenie zadań, śledzić postępy i współpracować nad projektami bezpośrednio w swoim chatbocie. Wzmocnij swojego chatbota, aby mógł tworzyć, aktualizować i pobierać zgłoszenia Linear , przypisywać zadania członkom zespołu, śledzić terminy i nie tylko. Usprawnij procesy zarządzania projektami i zwiększ produktywność zespołu dzięki integracji Linear dla Botpress.

## Migracja z wersji `0.x` do `1.x`

Wersja `1.0` integracji Linear wymaga teraz od użytkowników podania sekretu podpisywania webhook . Jeśli korzystasz z uwierzytelniania OAuth, ta zmiana nie ma na ciebie wpływu. Jeśli używasz klucza API do uwierzytelniania w Linear, musisz podać sekret podpisywania webhook , aby zapewnić bezpieczną komunikację między Botpress i Linear. Aby uzyskać sekret podpisywania webhook , postępuj zgodnie z instrukcjami w sekcji _Ręczna konfiguracja z kluczem API_ poniżej.

## Konfiguracja

### Automatyczna konfiguracja z OAuth (zalecane)

Jest to najprostszy sposób konfiguracji integracji. Aby skonfigurować integrację Linear za pomocą OAuth, kliknij przycisk autoryzacji i postępuj zgodnie z instrukcjami, aby połączyć chatbota Botpress z Linear. Ta metoda jest zalecana, ponieważ upraszcza proces konfiguracji i zapewnia bezpieczną komunikację między chatbotem a Linear.

Podczas korzystania z tego trybu konfiguracji, aplikacja Botpress zarządzana przez Linear będzie używana do łączenia się z obszarem roboczym Linear . Aplikacja będzie miała niezbędne uprawnienia do administrowania zgłoszeniami, komentarzami i wykonywania operacji w imieniu użytkowników. Jeśli potrzebujesz bardziej szczegółowej kontroli nad uprawnieniami, możesz zamiast tego wybrać tryb konfiguracji ręcznej.

### Ręczna konfiguracja z kluczem API

Jeśli wolisz ręcznie skonfigurować integrację, możesz podać klucz API, aby połączyć swoje osobiste konto Linear z Botpress. Pamiętaj, że gdy używasz klucza API, działania podejmowane przez bota będą przypisywane do Twojego osobistego konta Linear . Jeśli chcesz, aby działania były przypisywane do Twojej organizacji zamiast do konta osobistego, musisz użyć uwierzytelniania OAuth. Uwierzytelnianie OAuth ma wiele zalet w porównaniu z kluczami API i nie zajmuje miejsca w organizacji Linear .

Aby skonfigurować integrację Linear przy użyciu osobistego klucza API, wykonaj następujące kroki:

### Tworzenie klucza API Linear 

1. Na stronie Linear przejdź do ustawień konta i wybierz zakładkę API na bocznym pasku nawigacyjnym.
2. W sekcji _Personal API keys_ wprowadź nazwę klucza API i kliknij przycisk _Twórz nowy klucz API_.
3. Zapisz ten klucz API w bezpiecznej lokalizacji. Będzie on potrzebny do skonfigurowania integracji Linear w Botpress.

### Subskrybowanie wydarzeń Linear webhook  

1. W Botpress, przejdź do strony konfiguracji integracji dla Linear.
2. Skopiuj adres URL webhook wygenerowany przez Botpress.
3. W witrynie Linear przejdź do ustawień konta i wybierz kartę API na pasku bocznym nawigacji.
4. W sekcji _Webhooks_ kliknij przycisk _Twórz nowy webhook_.
5. Wprowadź nazwę dla webhook i wklej adres URL webhook wygenerowany przez Botpress w polu _URL_.
6. Skopiuj sekret podpisywania webhook w bezpiecznej lokalizacji. Będzie on potrzebny do skonfigurowania integracji Linear w Botpress.
7. W sekcji _Data change events_ wybierz zdarzenia, które chcesz subskrybować:

- `Issues`: Otrzymuj powiadomienia, gdy sprawy są tworzone, aktualizowane lub usuwane.
- `Comments`: Otrzymuj powiadomienia, gdy komentarze są dodawane do spraw.

8. W sekcji _Teams_ wybierz zespoły, dla których chcesz otrzymywać powiadomienia.
9. Kliknij przycisk _Twórz webhook_, aby zapisać zmiany.

### Konfiguracja integracji Linear w Botpress

1. W Botpress przejdź do strony konfiguracji integracji dla Linear.
2. Wybierz opcję _Configure Linear with an API Key_.
3. Wprowadź klucz API uzyskany z Linear w polu _API Key_.
4. W polu _Webhook Signing Secret_ wprowadź sekret podpisywania webhook uzyskany z Linear .
5. Zapisz konfigurację i włącz integrację.
6. Skopiuj adres URL webhook wygenerowany przez Botpress.

## Ograniczenia

Standardowe ograniczenia API Linear mają zastosowanie do integracji Linear w Botpress. Ograniczenia te obejmują limity szybkości, ograniczenia rozmiaru ładunku i inne ograniczenia nałożone przez platformę Linear . Upewnij się, że twój bot przestrzega tych ograniczeń, aby utrzymać optymalną wydajność i niezawodność.

Więcej szczegółów można znaleźć w [Linear dokumentacji API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).