De integratie Linear brengt krachtige projectbeheermogelijkheden naar je AI-gestuurde chatbot. Verbind Botpress naadloos met Linear, een moderne tool voor het volgen van problemen en workflowbeheer. Met deze integratie kun je het aanmaken van taken automatiseren, de voortgang bijhouden en samenwerken aan projecten direct in je chatbot. Stel je chatbot in staat om Linear issues aan te maken, bij te werken en op te vragen, taken toe te wijzen aan teamleden, vervaldata bij te houden en nog veel meer. Stroomlijn je projectbeheerprocessen en verbeter de teamproductiviteit met de Linear Integratie voor Botpress. ## Migreren van versie `0.x` naar `1.x` Versie `1.0` van de Linear integratie vereist nu dat gebruikers een webhook ondertekeningsgeheim opgeven. Als u OAuth authenticatie gebruikt, wordt u niet beïnvloed door deze verandering. Als u een API-sleutel gebruikt om te authenticeren met Linear, moet u een webhook ondertekeningsgeheim opgeven om veilige communicatie tussen Botpress en Linear te garanderen. Volg de instructies in de _Handmatige configuratie met een API-sleutel_ sectie hieronder om het webhook ondertekeningsgeheim te verkrijgen. ## Configuratie ### Automatische configuratie met OAuth (aanbevolen) Dit is de eenvoudigste manier om de integratie in te stellen. Om de Linear integratie in te stellen met behulp van OAuth, klik je op de autorisatieknop en volg je de instructies om je Botpress chatbot te verbinden met Linear. Deze methode wordt aanbevolen omdat het het configuratieproces vereenvoudigt en een veilige communicatie tussen je chatbot en Linear garandeert. Wanneer je deze configuratiemodus gebruikt, wordt een Botpress-beheerde Linear applicatie gebruikt om verbinding te maken met je Linear werkruimte. De applicatie heeft de benodigde machtigingen om problemen en opmerkingen te beheren en bewerkingen uit te voeren namens je gebruikers. Als je meer controle wilt over de machtigingen, kun je kiezen voor de handmatige configuratiemodus. ### Handmatige configuratie met een API-sleutel Als u de integratie liever handmatig configureert, kunt u een API-sleutel opgeven om uw persoonlijke Linear account te verbinden met Botpress. Houd er rekening mee dat wanneer u een API-sleutel gebruikt, acties die door de bot worden uitgevoerd, worden toegeschreven aan uw persoonlijke Linear account. Als u wilt dat acties worden toegeschreven aan uw organisatie in plaats van aan uw persoonlijke account, moet u OAuth-authenticatie gebruiken. OAuth-authenticatie biedt veel voordelen ten opzichte van API-sleutels en neemt geen plaats in binnen uw Linear organisatie. Volg deze stappen om de Linear integratie in te stellen met behulp van een persoonlijke API-sleutel: ### Een Linear API-sleutel aanmaken 1. Navigeer op Linear naar uw accountinstellingen en selecteer het tabblad API in de navigatiebalk. 2. Voer onder _Personal API keys_ een naam in voor uw API key en klik op de knop _Create new API key_. 3. Sla deze API-sleutel op een veilige locatie op. U hebt deze sleutel nodig om de Linear integratie in Botpress te configureren. ### Inschrijven voor Linear webhook evenementen 1. Navigeer in Botpress naar de integratieconfiguratiepagina voor Linear. 2. Kopieer de URL webhook die door Botpress is gegenereerd. 3. Navigeer op Linear naar uw accountinstellingen en selecteer het tabblad API in de navigatiebalk. 4. Klik onder _Webhooks_ op de knop _Create new webhook_. 5. Voer een naam in voor de webhook en plak de URL webhook die is gegenereerd door Botpress in het veld _URL_. 6. Kopieer het ondertekeningsgeheim van webhook naar een veilige locatie. U hebt dit nodig om de Linear integratie in Botpress te configureren. 7. Selecteer onder _Gebeurtenissen gegevenswijziging_ de gebeurtenissen waarop u zich wilt abonneren: - `Uitgiften`: Meldingen ontvangen wanneer issues worden aangemaakt, bijgewerkt of verwijderd. - `Commentaren`: Meldingen ontvangen wanneer opmerkingen aan issues worden toegevoegd. 8. Selecteer onder _Teams_ de teams waarvoor u meldingen wilt ontvangen. 9. Klik op de knop webhook om uw wijzigingen op te slaan. ### De Linear integratie configureren in Botpress 1. Navigeer in Botpress naar de integratieconfiguratiepagina voor Linear. 2. Selecteer de optie _Configure Linear with an API Key_ ( configureren met een API-sleutel). 3. Voer de API-sleutel die u hebt verkregen van Linear in het veld _API Key_ in. 4. Voer in het veld _Webhook Signing Secret_ het ondertekeningsgeheim van webhook in dat u van Linear hebt gekregen. 5. Sla de configuratie op en schakel de integratie in. 6. Kopieer de URL webhook die is gegenereerd door Botpress. ## Beperkingen Standaard Linear API beperkingen zijn van toepassing op de Linear integratie in Botpress. Deze beperkingen omvatten snelheidslimieten, payload grootte beperkingen en andere beperkingen opgelegd door het Linear platform. Zorg ervoor dat uw bot zich aan deze beperkingen houdt om optimale prestaties en betrouwbaarheid te behouden. Meer details zijn beschikbaar in de [Linear API documentatie](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).
