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