Linear

  Die Linear Integration bringt leistungsstarke Projektmanagement-Funktionen in Ihren KI-gesteuerten Chatbot. Verbinden Sie Botpress nahtlos mit Linear, einem modernen Tool für Problemverfolgung und Workflow-Management. Mit dieser Integration können Sie die Erstellung von Aufgaben automatisieren, den Fortschritt verfolgen und direkt in Ihrem Chatbot an Projekten zusammenarbeiten. Ermöglichen Sie Ihrem Chatbot das Erstellen, Aktualisieren und Abrufen von Linear Problemen, das Zuweisen von Aufgaben an Teammitglieder, das Verfolgen von Fälligkeitsdaten und vieles mehr. Optimieren Sie Ihre Projektmanagementprozesse und steigern Sie die Produktivität Ihres Teams mit der Linear Integration für Botpress.

## Migration von Version `0.x` auf `1.x`

Die Version `1.0` der Linear Integration erfordert nun, dass Benutzer ein webhook Signiergeheimnis angeben. Wenn Sie OAuth-Authentifizierung verwenden, sind Sie von dieser Änderung nicht betroffen. Wenn Sie einen API-Schlüssel zur Authentifizierung bei Linear verwenden, müssen Sie ein webhook Signiergeheimnis bereitstellen, um eine sichere Kommunikation zwischen Botpress und Linear zu gewährleisten. Um das webhook Signiergeheimnis zu erhalten, folgen Sie den Anweisungen im Abschnitt _Manuelle Konfiguration mit einem API-Schlüssel_ unten.

## Konfiguration

### Automatische Konfiguration mit OAuth (empfohlen)

Dies ist die einfachste Art, die Integration einzurichten. Um die Linear Integration mit OAuth einzurichten, klicken Sie auf die Schaltfläche Autorisierung und folgen Sie den Anweisungen, um Ihren Botpress Chatbot mit Linear zu verbinden. Diese Methode wird empfohlen, da sie den Konfigurationsprozess vereinfacht und eine sichere Kommunikation zwischen Ihrem Chatbot und Linear gewährleistet.

Wenn Sie diesen Konfigurationsmodus verwenden, wird eine von Botpress verwaltete Linear Anwendung verwendet, um sich mit Ihrem Linear Arbeitsbereich zu verbinden. Die Anwendung verfügt über die notwendigen Berechtigungen, um Themen und Kommentare zu verwalten und Operationen im Namen Ihrer Benutzer durchzuführen. Wenn Sie eine genauere Kontrolle über die Berechtigungen benötigen, können Sie sich stattdessen für den manuellen Konfigurationsmodus entscheiden.

### Manuelle Konfiguration mit einem API-Schlüssel

Wenn Sie es vorziehen, die Integration manuell zu konfigurieren, können Sie einen API-Schlüssel angeben, um Ihr persönliches Linear -Konto mit Botpress zu verbinden. Beachten Sie, dass bei Verwendung eines API-Schlüssels die vom Bot durchgeführten Aktionen Ihrem persönlichen Linear -Konto zugeordnet werden. Wenn Sie möchten, dass die Aktionen Ihrer Organisation und nicht Ihrem persönlichen Konto zugeordnet werden, müssen Sie die OAuth-Authentifizierung verwenden. Die OAuth-Authentifizierung bietet viele Vorteile gegenüber API-Schlüsseln und beansprucht keinen Platz in Ihrer Linear Organisation.

Führen Sie die folgenden Schritte aus, um die Linear Integration mit einem persönlichen API-Schlüssel einzurichten:

### Erstellen eines Linear API-Schlüssels

1. Navigieren Sie auf Linear zu Ihren Kontoeinstellungen und wählen Sie die Registerkarte API in der Navigationsleiste.
2. Geben Sie unter _Personal API keys_ einen Namen für Ihren API-Schlüssel ein und klicken Sie auf die Schaltfläche _Create new API key_.
3. Speichern Sie diesen API-Schlüssel an einem sicheren Ort. Sie benötigen ihn, um die Linear Integration in Botpress zu konfigurieren.

### Abonnieren von Linear webhook  Ereignissen

1. Navigieren Sie in Botpress zur Konfigurationsseite der Integration für Linear.
2. Kopieren Sie die von Botpress generierte webhook URL.
3. Navigieren Sie auf Linear zu Ihren Kontoeinstellungen und wählen Sie die Registerkarte API in der Navigationsleiste.
4. Klicken Sie unter _Webhooks_ auf die Schaltfläche _Neue webhook_ erstellen.
5. Geben Sie einen Namen für webhook ein und fügen Sie die von Botpress generierte webhook URL in das Feld _URL_ ein.
6. Kopieren Sie das webhook Signiergeheimnis an einen sicheren Ort. Sie benötigen es für die Konfiguration der Linear Integration in Botpress.
7. Wählen Sie unter _Datenänderungsereignisse_ die Ereignisse aus, die Sie abonnieren möchten:

- "Ausgaben": Sie erhalten Benachrichtigungen, wenn Ausgaben erstellt, aktualisiert oder gelöscht werden.
- Kommentare": Sie werden benachrichtigt, wenn Kommentare zu Ausgaben hinzugefügt werden.

8. Wählen Sie unter _Teams_ die Teams aus, für die Sie Benachrichtigungen erhalten möchten.
9. Klicken Sie auf die Schaltfläche _Create webhook_, um Ihre Änderungen zu speichern.

### Konfigurieren der Linear Integration in Botpress

1. Navigieren Sie in Botpress zur Konfigurationsseite der Integration für Linear.
2. Wählen Sie die Option _Konfigurieren Sie Linear mit einem API-Schlüssel_.
3. Geben Sie den API-Schlüssel, den Sie von Linear erhalten haben, in das Feld _API-Schlüssel_ ein.
4. Geben Sie das Signiergeheimnis von webhook , das Sie von Linear erhalten haben, in das Feld _Webhook Signing Secret_ ein.
5. Speichern Sie die Konfiguration und aktivieren Sie die Integration.
6. Kopieren Sie die von Botpress generierte webhook URL.

## Beschränkungen

Die Standardeinschränkungen der Linear API gelten für die Linear Integration in Botpress. Zu diesen Einschränkungen gehören Ratenbeschränkungen, Größenbeschränkungen für Nutzdaten und andere von der Linear Plattform auferlegte Beschränkungen. Stellen Sie sicher, dass Ihr Bot diese Beschränkungen einhält, um optimale Leistung und Zuverlässigkeit zu gewährleisten.

Weitere Einzelheiten finden Sie in der [Linear API-Dokumentation] (https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).