Linear

  Linear の統合により、AI を搭載したチャットボットに強力なプロジェクト管理機能が加わります。Botpress を、最新の課題追跡およびワークフロー管理ツールであるLinear とシームレスに接続します。この統合により、チャットボット内で直接、タスク作成の自動化、進捗の追跡、プロジェクトの共同作業が可能になります。Linear 課題の作成、更新、取得、チームメンバーへのタスク割り当て、期日の追跡などをチャットボットで行えるようになります。Linear Integration forBotpress で、プロジェクト管理プロセスを合理化し、チームの生産性を高めましょう。

## バージョン `0.x` から `1.x` への移行

Linear インテグレーションのバージョン `1.0` では、webhook 署名シークレットをユーザーに要求するようになりました。OAuth認証を使用している場合は、この変更の影響を受けません。API キーを使用してLinear で認証する場合、Botpress とLinear の間の安全な通信を保証するために、webhook 署名秘密を提供する必要があります。webhook 署名シークレットを取得するには、以下の「APIキーを使用した手動構成」の説明に従ってください。

## 設定

### OAuth による自動設定（推奨）

これは統合を設定する最も簡単な方法です。OAuth を使用してLinear の統合を設定するには、認証ボタンをクリックし、指示に従ってBotpress チャットボットをLinear に接続します。この方法は、設定プロセスを簡素化し、チャットボットとLinear の間の安全な通信を保証するため、推奨されます。

この設定モードを使用する場合、Linear ワークスペースへの接続には、Botpress-managedLinear アプリケーションが使用されます。このアプリケーションは、ユーザーの代わりに課題、コメントを管理し、操作を実行するために必要な権限を持っています。権限をより細かく制御したい場合は、手動設定モードを選択してください。

### API キーによる手動設定

統合を手動で設定したい場合は、個人のLinear アカウントをBotpress に接続するための API キーを提供できます。API キーを使用する場合、ボットによるアクションは個人のLinear アカウントに帰属することに注意してください。アクションを個人アカウントではなく組織に帰属させたい場合は、OAuth認証を使用する必要があります。OAuth認証は、APIキーよりも多くの利点を提供し、Linear 組織内の席を消費しません。

個人のAPIキーを使用してLinear の統合を設定するには、以下の手順に従ってください：

###Linear API キーの作成

1.Linear で、アカウント設定に移動し、ナビゲーション・サイドバーのAPIタブを選択する。
2.2. _Personal API keys_の下で、APIキーの名前を入力し、_Create new API key_ボタンをクリックします。
3.このAPIキーを安全な場所に保存します。このAPIキーは、Botpress でLinear の統合を設定する際に必要になります。

###Linear webhook  イベントへの登録

1.Botpress で、Linear の統合構成ページに移動します。
2.Botpress によって生成されたwebhook URL をコピーする。
3.Linear で、アカウント設定に移動し、ナビゲーション・サイドバーのAPIタブを選択する。
4.Webhooks_の下にある_Create newwebhook_ボタンをクリックする。
5.webhook の名前を入力し、_URL_ フィールドにBotpress で生成されたwebhook URL を貼り付ける。
6.webhook の署名秘密を安全な場所にコピーする。このシークレットは、Botpress でLinear の統合を設定する際に必要になります。
7.データ変更イベント」の下で、購読したいイベントを選択する：

- Issues`：Issues`: 課題が作成、更新、削除されたときに通知を受け取ります。
- コメント`：コメント`: 課題にコメントが追加された際に通知を受け取ります。

8.Teams_の下で、通知を受け取りたいチームを選択します。
9.Createwebhook_ ボタンをクリックして変更を保存します。

###Linear の統合を設定するBotpress

1.Botpress で、Linear の統合構成ページに移動します。
2.API キーでLinear を構成する」オプションを選択します。
3.Linear から取得した API キーを _API Key_ フィールドに入力する。
4.Webhook Signing Secret_」フィールドに、Linear から取得したwebhook 署名シークレットを入力する。
5.設定を保存し、統合を有効にする。
6.Botpress によって生成されたwebhook URL をコピーする。

## 制限事項

Botpress のLinear 統合には、標準的なLinear API の制限が適用される。これらの制限には、レート制限、ペイロードサイズの制限、およびLinear プラットフォームによって課されるその他の制約が含まれます。最適なパフォーマンスと信頼性を維持するために、あなたのボットがこれらの制限を守るようにしてください。

詳細については、[Linear API documentation](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting) を参照してください。