Jira統合
対応: Jira
ReplyRabbit を Jira Cloud に接続し、FreeScout のサポート会話を構造化された Jira Issue に変換できるようにします。エージェントは会話から Jira Issue を作成し、リンクされた Issue を FreeScout で表示したままにし、作業完了時に ReplyRabbit を使用して顧客フォローアップを準備できます。
概要をお探しですか?
概要
Jira 統合は、FreeScout 会話の ReplyRabbit に Jira パネルを追加します。Jira がメールボックスに設定されている場合、ReplyRabbit はタイトル、説明、優先度、ラベル、担当者、課題タイプ、プロジェクト、サポート会話へのリンクを含む課題を作成できます。
Jiraがメールボックスのアクティブな課題トラッカーとして選択されています。メールボックスがすでにLinearまたはGitHub Issuesを使用している場合は、そのメールボックスをJiraに移行する準備ができるまで、そのトラッカーを選択したままにしてください。
前提条件
始める前に、次を確認してください:
- 動作するFreeScoutインストール。
- ReplyRabbitがインストールされ、有効化されています。
- 使用したいJira機能を含むReplyRabbitプラン。
- 次のようなJira Cloudサイト
https://example.atlassian.net. - 対象プロジェクトにアクセスできるJiraアカウントのメールアドレスとAPIトークン。
- issue 作成をサポートする少なくとも 1 つの Jira プロジェクトと issue タイプ。
- 有効にするワークフローのJiraプロジェクト権限:Browse ProjectsとCreate Issuesは必須です。優先度/ラベルの編集、担当者の割り当て、ステータス遷移、スレッドコメントを使用する場合は、Edit Issues、Assign Issues、Transition Issues、Add Commentsが必要です。
ReplyRabbitがまだインストールされていない場合は、次から始めてください ReplyRabbitモジュールのインストール方法)、次に完了します ReplyRabbitのセットアップ方法.
権限とAPIトークン
ReplyRabbitはBasic認証でJira Cloud REST API v3に接続します。メールボックスには3つの接続値が保存されます:
- JiraサイトURL: その
https://example.atlassian.netサイト URL。 - アカウントのメールアドレス: API トークンとともに使用する Atlassian アカウントのメールアドレス。
- APIトークン: そのアカウントの Jira Cloud API トークン。
API トークンは暗号化されたメールボックス設定として保存され、保存後に完全な形で再表示されることはありません。Atlassian でトークンがローテーションまたは削除された場合は、さらに課題を作成する前にメールボックス設定を更新してください。
Jira を接続
メールボックス設定を開く
FreeScoutでJira issueを作成するメールボックスを開き、次を開いてください 設定 そして選択 ReplyRabbit.課題トラッカーとしてJiraを選択
次の場所で 統合 セクションで、イシュートラッカーを設定する Jira)。メールボックスはLinear、GitHub Issues、Jira、またはイシュートラッカーなしを使用できます。Jira認証情報を追加
Jira CloudのサイトURL、アカウントのメールアドレス、APIトークンを貼り付けます。Jiraプロジェクトを読み込む
Jiraからプロジェクトを読み込み、新しい課題のデフォルトプロジェクトを選択します。課題タイプを選択
プロジェクトの課題タイプを読み込み、TaskやBugなどのデフォルト課題タイプを選択します。設定を保存
メールボックス設定を保存します。ReplyRabbitはそのメールボックスのJira接続を保存します。
デフォルトを設定
Jiraが接続されたら、チームが必要とするデフォルトを設定します:
- デフォルトプロジェクト: ドメインマッピングや AI プロジェクトマッチングで別のプロジェクトが選択されない場合に使用する Jira プロジェクト。
- デフォルトの課題タイプ: 新しいイシューのイシュータイプ。通常は Task または Bug。
- 優先度マッピング: ReplyRabbitの優先度レベルをネイティブのJira優先度名にマップします。
- プロジェクトルーティング: ルーティングを決定論的にする必要がある場合、顧客メールドメインをJiraプロジェクトにマップします。
- issue を自動送信: Teamティアで、トリアージがエンジニアリング作業が必要と示した場合に、ReplyRabbitがJiraイシューを自動的に作成できるようにします。
- Done 時の自動下書き: リンクされたJiraイシューがDoneステータスカテゴリに達したときに、ReplyRabbitに顧客フォローアップを準備させます。
プロジェクトルーティングは任意です。確実に一致するプロジェクトがない場合、ReplyRabbitはメールボックスの既定プロジェクトを使用します。
FreeScout の会話から Jira Issue を作成
Jiraが設定されているメールボックスで会話を開きます。ReplyRabbitパネルは顧客スレッドからJira issueを作成し、リンクされたissueをFreeScoutに表示できます。
ReplyRabbitはJiraに構造化されたAtlassian Document Formatの説明を送信します。説明にはサポート要約、顧客コンテキスト、FreeScoutの会話リンクが含まれます。顧客のテキストは指示ではなくコンテンツとして扱われます。
作成後、リンクされたJiraイシューを確認し、必要に応じてReplyRabbitパネルからステータス、優先度、担当者、ラベルを調整します。
会話と課題を同期させ続ける
課題がリンクされると、FreeScout の会話に現在の Jira ステータス、優先度、担当者、ラベル、課題キーが表示されます。エージェントは完全なエンジニアリングビューが必要なときに Jira で課題を開くことができます。
ReplyRabbitはJiraのトランジションを通じてJiraのステータスを変更します。ステータスフィールドに直接書き込むことはありません。
ReplyRabbitは完了ループもサポートします。スケジュールされたステータスチェックがリンクされたJira issueをポーリングします。JiraがDoneステータスカテゴリを報告すると、ReplyRabbitはサポートがコンテキストとともに会話をクローズできるよう、顧客フォローの下書き作成を支援できます。
トラブルシューティング
| 症状 | 確認すべきこと |
|---|---|
| プロジェクトが読み込まれない | サイト URL が Jira Cloud であることを確認する atlassian.net URL、メールが正しいこと、およびAPIトークンにプロジェクトアクセスがあること。 |
| 課題タイプが見つからない | 選択したプロジェクトが、使用予定の課題タイプをサポートしていることを確認してください。 |
| 課題が作成されない | Jiraがメールボックスの課題トラッカーとして選択され、プロジェクトが選択され、ReplyRabbitプランにこの機能が含まれていることを確認してください。 |
| 自動 issue は作成されません | Team ティアを使用していること、および issue を自動送信 が有効です。 |
| ステータスが更新されません | 会話を再読み込みし、Jiraが対象ステータスへの有効なトランジションを公開していることを確認してください。 |
| 完了時の下書きが表示されない | 確認 Done 時の自動下書き が有効で、リンクされたJiraイシューがDoneステータスカテゴリに達している。 |
より広範な修正については、次を参照してください ReplyRabbitのトラブルシューティング.
プライバシーとデータの取り扱い
ReplyRabbitはエンジニアリングへの引き継ぎに必要な課題コンテンツをJiraに送信します。これには関連する顧客コンテキスト、生成された課題テキスト、優先度、ラベル、担当者、FreeScoutの会話リンクまたは識別子が含まれる場合があります。
Jira Cloudワークスペースが受け取ることが許可されていない限り、Jira issueに機密情報を入れないでください。顧客データを完全に自分のサーバーに留める必要がある場合は、そのメールボックスでJiraを無効にしておいてください。
FAQ
ReplyRabbitはJira Data CenterまたはServerをサポートしていますか?
いいえ。ReplyRabbit は atlassian.net URL を使用する Jira Cloud サイトをサポートします。
JiraにOAuthは必要ですか?
いいえ。ReplyRabbit はメールボックスごとの Jira Cloud Basic 認証を、サイト URL、アカウントメール、Jira API トークンで使用します。
1つのメールボックスでJiraとLinearまたはGitHub Issuesを同時に使用できますか?
いいえ。メールボックスは1つのアクティブなイシュートラッカーを選択します。Linear と GitHub Issues の設定は、どちらかを選択している間も利用可能です。
Jiraの課題が完了したとき、ReplyRabbitは顧客フォローの下書きを作成できますか?
はい。ReplyRabbitはリンクされたJira課題をポーリングし、JiraがDoneステータスカテゴリを報告したときに顧客フォローの下書きを準備できます。