Linear

  L'intégration Linear apporte de puissantes capacités de gestion de projet à votre chatbot alimenté par l'IA. Connectez de manière transparente Botpress avec Linear, un outil moderne de suivi des problèmes et de gestion des flux de travail. Grâce à cette intégration, vous pouvez automatiser la création de tâches, suivre les progrès et collaborer sur des projets directement dans votre chatbot. Donnez à votre chatbot les moyens de créer, de mettre à jour et de récupérer les problèmes sur Linear , d'assigner des tâches aux membres de l'équipe, de suivre les échéances, etc. Rationalisez vos processus de gestion de projet et améliorez la productivité de votre équipe avec l'intégration Linear pour Botpress.

## Migration de la version `0.x` vers `1.x`

La version `1.0` de l'intégration Linear demande maintenant aux utilisateurs de fournir un secret de signature webhook . Si vous utilisez l'authentification OAuth, vous n'êtes pas affecté par ce changement. Si vous utilisez une clé API pour vous authentifier avec Linear, vous devez fournir un secret de signature webhook pour assurer une communication sécurisée entre Botpress et Linear. Pour obtenir le secret de signature webhook , suivez les instructions de la section _Configuration manuelle avec une clé API_ ci-dessous.

## Configuration

### Configuration automatique avec OAuth (recommandée)

Il s'agit de la méthode la plus simple pour configurer l'intégration. Pour configurer l'intégration Linear à l'aide d'OAuth, cliquez sur le bouton d'autorisation et suivez les instructions pour connecter votre chatbot Botpress à Linear. Cette méthode est recommandée car elle simplifie le processus de configuration et garantit une communication sécurisée entre votre chatbot et Linear.

Lorsque vous utilisez ce mode de configuration, une application Linear gérée par Botpress sera utilisée pour se connecter à votre espace de travail Linear . L'application disposera des autorisations nécessaires pour gérer les questions, les commentaires et effectuer des opérations au nom de vos utilisateurs. Si vous avez besoin d'un contrôle plus granulaire sur les autorisations, vous pouvez opter pour le mode de configuration manuel.

### Configuration manuelle avec une clé API

Si vous préférez configurer manuellement l'intégration, vous pouvez fournir une clé API pour connecter votre compte personnel Linear à Botpress. Gardez à l'esprit que lorsque vous utilisez une clé API, les actions effectuées par le robot seront attribuées à votre compte personnel Linear . Si vous souhaitez que les actions soient attribuées à votre organisation plutôt qu'à votre compte personnel, vous devez utiliser l'authentification OAuth. L'authentification OAuth offre de nombreux avantages par rapport aux clés API et n'occupe pas de place au sein de votre organisation Linear .

Pour configurer l'intégration de Linear à l'aide d'une clé API personnelle, procédez comme suit :

### Création d'une clé API Linear 

1. Sur Linear, accédez aux paramètres de votre compte et sélectionnez l'onglet API dans la barre latérale de navigation.
2. Sous _Clé API personnelle_, saisissez un nom pour votre clé API et cliquez sur le bouton _Créer une nouvelle clé API_.
3. Enregistrez cette clé API dans un endroit sûr. Vous en aurez besoin pour configurer l'intégration de Linear dans Botpress.

### Abonnement aux événements Linear webhook  

1. Sur Botpress, accédez à la page de configuration de l'intégration pour Linear.
2. Copiez l'URL webhook générée par Botpress.
3. Sur Linear, accédez aux paramètres de votre compte et sélectionnez l'onglet API dans la barre latérale de navigation.
4. Sous _Webhooks_, cliquez sur le bouton _Create new webhook_.
5. Saisissez un nom pour webhook et collez l'URL webhook générée par Botpress dans le champ _URL_.
6. Copiez le secret de signature de webhook dans un endroit sûr. Vous en aurez besoin pour configurer l'intégration de Linear dans Botpress.
7. Sous _Data change events_, sélectionnez les événements auxquels vous souhaitez vous abonner :

- `Issues` : Recevez des notifications lorsque des questions sont créées, mises à jour ou supprimées.
- `Comments` : Recevoir des notifications lorsque des commentaires sont ajoutés aux questions.

8. Sous _Teams_, sélectionnez les équipes pour lesquelles vous souhaitez recevoir des notifications.
9. Cliquez sur le bouton _Create webhook_ pour enregistrer vos modifications.

### Configurer l'intégration de Linear en Botpress

1. Dans Botpress, naviguez jusqu'à la page de configuration de l'intégration pour Linear.
2. Sélectionnez l'option _Configurer Linear avec une clé API_.
3. Saisissez la clé API que vous avez obtenue sur Linear dans le champ _API Key_.
4. Entrez le secret de signature de webhook que vous avez obtenu de Linear dans le champ _Webhook Signing Secret_.
5. Enregistrez la configuration et activez l'intégration.
6. Copiez l'URL webhook générée par Botpress.

## Limitations

Les limitations standard de l'API Linear s'appliquent à l'intégration de Linear dans Botpress. Ces limitations comprennent des limites de débit, des restrictions de taille de charge utile et d'autres contraintes imposées par la plateforme Linear . Veillez à ce que votre robot respecte ces limitations afin de maintenir des performances et une fiabilité optimales.

Plus de détails sont disponibles dans la [Linear API documentation](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).