Intercom TicketsとJiraの課題をシームレスに統合し、チーム間のコミュニケーションを効率化します。
Intercom TicketタイプをJiraの課題と自動で同期します。
Workflowsテンプレートを使ってカスタム自動化を設定し、IntercomとJira間で同期するデータを構成します。
Jiraの課題でステータス変更やメモがあった場合、Intercomのticketsも同様に更新されるようにします。
InboxのJira for Ticketsアプリを使って、Intercom ticketsからJiraの課題を作成またはリンクします。
Jira for Ticketsの連携は現時点でJira Cloudのみ対応しています。Jira Serverのサポート予定はなく、Atlassianは2024年2月末でサポートを終了します。
アプリをインストールする
App Storeにアクセスし、Jira for Ticketsアプリを見つけてください。
Jira for Ticketsアプリを選択し、今すぐインストールをクリックします。
アクセスを許可をクリックして、Jira for TicketsにIntercom Workspaceへの適切なアクセス権を与えます。
正しいAtlassianアカウントにログインしていることを確認してください。
Jira for Intercom Tickets（アプリのAtlassian側）が要求しているアクセス権を確認し、承諾を押してください。
注意：Jiraタスクを設定する管理者がデフォルトのレポーターになります。
自動化を設定する
Jira for Ticketsアプリ設定に移動し、Intercom TicketタイプとJiraの課題を自動で同期する自動化を設定します。
注意：Jira for TicketsのworkflowsはWorkflow Builderの「統合アクションを追加」メニューではなく、Jira for Ticketsアプリ設定から構成します。アプリ設定で基本またはカスタム自動化を選択し、workflowテンプレートを管理してください。
自動化の種類を選択してください：
基本自動化
Intercom ticketsからJiraの課題を自動作成し、メモを同期します。
基本自動化はIntercom ticketのタイトルと説明のみをJiraに同期します。SummaryとDescription以外に必須フィールドがあるJira課題タイプは基本自動化ではサポートされません。追加データの同期にはカスタム自動化を使用してください。
カスタム自動化
Workflowsテンプレートを使ってIntercomとJira間のデータ同期方法をカスタマイズします。
Jiraのカスタム自動化はWorkflows付きのIntercomプランでのみ利用可能です。
Company IDなどの属性を含む適切なフィールドマッピングを行い、シームレスな統合を確保してください。
基本自動化
Jira for Ticketsアプリ設定で「基本自動化」を選択します。
「Intercom ticketsからJiraの課題を自動作成するを有効にする」を切り替え、Jiraプロジェクトを追加します。
Intercom ticketタイプをJira課題タイプにマッピングします（複数タイプのマッピング可能）。
Intercom ticketsとメモ、Jira課題のコメントを同期したい場合は、「Intercom ticketのメモとJira課題のコメントをリアルタイムで同期するを有効にする」を選択してください。
これにより、Jiraからステータスが更新された場合、Intercom ticketにメモも追加されます🎉
設定と構成が完了したら、保存を選択してください。
カスタム自動化
Jira for Ticketsアプリ設定で「カスタム自動化」を選択し、保存をクリックします。
次に、AI & Automation > Workflowsに移動し、新しいworkflowを選択します。
「アプリに接続」セクションまでスクロールし、5つのJira Workflowテンプレートオプションを見つけます：
Jira課題を作成：Intercomでticketが作成されたときにJira課題を作成します。カスタムTicket属性をJiraに同期するよう設定可能です。
Jira課題にコメント：チームメンバーがIntercomにメモを追加したとき、関連するJira課題にコメントを投稿します。コメント内容は必要な情報を取得するよう設定可能です。
Jira課題のステータスが更新されたとき：Jira課題のステータスが更新されたら、関連するIntercom ticketを更新します。デフォルトではステータス更新のメモが追加されます。
Jiraの更新からticketステータスを変更：Jira課題のステータスが更新されたとき、Intercom ticketのステータスを更新します。
Jira課題にコメントが追加されたとき：Jira課題にコメントが追加されたら、関連するIntercom ticketを更新します。コメント内容は必要な情報を取得するよう設定可能です。
テンプレートを選択し、このテンプレートを使うを選択します。
Jira Workflowテンプレートの編集
デフォルト設定を使うか、Workflowsの機能を使って編集できます。
Intercom ticketタイプのJiraへの同期を編集するには、トリガーまたはブランチフィルターを更新してください。
IntercomのどのデータがJira課題に渡されるかを編集するには、アクションを選択してください。
属性セレクターメニューを使ってJiraに送信するデータを設定できます。アスタリスク付きのフィールドは必須です。
注意：{{email}}や{{company_id}}などの標準属性プレースホルダーは、ticketが該当する連絡先や会社にリンクされている場合のみ解決されます。Trackerやバックオフィスのticketsは特定の連絡先に紐づかないことが多いため、これらのプレースホルダーはJiraのペイロードで空になることがあります。すべてのticketタイプで確実に同期するには、連絡先レベルの属性ではなくticketや会話のカスタム属性（例：{{conversation.custom_attribute.XXXXX}}）をマッピングしてください。
一部のフィールドはJSON形式で入力されます：
変更を加えたら、Jiraアクションの保存をクリックしてください。すると、Workflowのアクションステップに追加した属性が表示されます。
注意: workflowアクションステップで行った変更はそのステップの設定を更新しますが、JSONボディやフィールドマッピングを含む基盤となるリクエストペイロードはデータコネクタで直接編集する必要があります。設定 > 統合 > データコネクタに移動し、該当するコネクタを開いてリクエストボディを更新し、フィールドの追加、削除、変更を行ってください。
Jiraのworkflow設定と構成が完了したら、ライブ設定をクリックしてWorkflowをライブに設定します。
Jiraの自動化テスト
Inboxに移動して新しいticketを作成してください。
⌘ / Ctrl E を使ってticketイベントを有効にするか、三点メニュー
をクリックし、Show ticket eventsを選択してWorkflowとアクションがトリガーされたか確認してください。
トラブルシューティングのヒント
workflowとアクションがトリガーされていない場合は、workflowがライブ設定されており、適切なオーディエンスとブランチフィルターが設定されていることを確認してください。
workflowとアクションがトリガーされたが失敗した場合は、アクション名をクリックしてください。
外部ページアイコンをクリックしてアクション詳細ページを開きます。
「ログ」タブに移動してください。そこでエラーの詳細が確認できます。
Workflowに戻ってエラーを修正し、Jiraの自動化テストを再度試みてください。
制限事項
Intercom ticketのファイル属性はJiraに同期できません。
**注意:** Jira for TicketsはJiraのコメントを顧客向け返信として同期することをサポートしていません。Jiraのコメントは内部メモとしてのみ表示されます。顧客向け返信を送信するには、IntercomのCustomer ticketまたは会話を使用してください。
顧客体験
顧客は引き続きIntercomを通じてサポートチームとやり取りします。ただし、顧客やチームメイトが作成したticketは自動的にJiraの課題に変換され、プロセスが効率化され、問題の追跡と管理が向上します。
チームメイト体験
チームメイトはInbox内で直接Jiraの課題を閲覧・管理できます。新しいticketタイプが作成されると、設定時に構成されたマッピングに基づいて自動的にJiraの課題が作成されます。これにより、IntercomとJiraを切り替えることなく効率的に問題を管理・解決できます。
InboxでJiraアプリを使う
InboxのサイドバーでJira for Ticketsアプリを使い、Intercom Ticketsから手動でJiraの課題を作成したり、既存のJiraの課題にIntercom Ticketsをリンクしたりできます（複数の課題へのリンクもサポート）。
Inboxからこれらの機能を有効にするには、右サイドバーを開き、アプリを編集をクリックしてください。
Jira for Ticketsアプリを見つけて、ピンアイコン
をクリックしてInboxサイドバーの他のアプリにピン留めしてください。
Intercom Ticketsから手動でJiraの課題を作成する
Intercom ticketから新しいJiraの課題を作成するには、Jira for Ticketsサイドバーアプリの新しい課題を作成ボタンをクリックしてください。
最近閲覧したプロジェクトから、または検索フィールドを使ってJiraプロジェクトを選択してください。
次に、課題タイプを選択し、フィールドに入力します。課題を作成ボタンをクリックしてください。
これで課題が作成され、Intercom ticketにリンクされました。
Intercom Ticketsを既存のJiraの課題にリンクする
Intercom ticketを既存のJiraの課題にリンクするには、Jira for Ticketsアプリの既存の課題をリンクボタンをクリックしてください。
「最近リンクした課題」または検索フィールドで課題を見つけてクリックしてください。
課題がリンクされ、Inboxサイドバーで表示されます。必要に応じてリンク解除も可能です。
Intercom ticketが既にリンクされている場合、作成およびリンクボタンは表示されません。
制限事項
Jiraの課題を別のプロジェクトに移動すると、Jira for Tickets統合による追跡はできなくなります。
多くのIntercom ticketsやJiraの課題へのリンク
トラッカーチケットを使った多くのIntercom ticketsから1つのJiraの課題へ
多くのIntercom顧客ticketは1つのIntercomトラッカーチケットにリンクできます。そのトラッカーチケットはJiraの課題にリンクされます。Jiraの課題が更新されると、トラッカーチケットも更新される可能性があります。トラッカーチケットは関連するすべてのIntercom顧客ticketsを一括更新するために使えます。
バックオフィスチケットを使った1つのIntercom ticketから多くのJiraの課題へ
1つのIntercom顧客ticketは多くのIntercomバックオフィスticketsにリンクできます。これらのIntercomバックオフィスticketsはそれぞれのJiraの課題にリンクされます。Jiraの課題が更新されると、バックオフィスticketも更新されます。バックオフィスticketのステータスが変わると、Intercom顧客ticketが更新されます。
Jira for Ticketsアプリのトラブルシューティング
Jiraの課題がIntercomの設定に関係なくデフォルトで中優先度になる場合:
優先度マッピングを上書きする可能性のあるJiraのworkflowルールやバリデーターを確認してください。
正確なマッピングのためにIntercomとJira for Tickets間の互換性のある優先度設定を確認してください。
設定を調整した後、マッピングを検証するためにテストを実施してください。
会話とticketの制限事項
Jira for Ticketsはticketに変換せずに会話から直接課題を作成することをサポートしていません。会話から課題を作成するには、代わりにJira Cloudアプリを使用してください。
メールベースのticket作成の制限事項
JiraはIntercomに転送されたメールから直接課題を作成できません。課題作成をトリガーするには、まずメールがIntercomでticketに変換されていることを確認してください。
重複ノートの問題
会話内で「[jira for intercom tickets]」という重複したノートが表示される場合、これは通常、Jira Cloud app (Tools Plus)とJira for Tickets app (Intercom)の両方がインストールされているときに発生します。
これを解決するには、どちらかのアプリをアンインストールすることを選択できますが、トレードオフに注意してください：
Jira Cloud アプリをアンインストールした場合：重複したノートは停止しますが、Jiraの課題ステータス変更時に自動的に会話を再開するなど、Tools Plusが提供する独自機能は失われます。
Jira for Tickets appをアンインストールした場合：重複したノートは停止しますが、Intercomが提供する公式のネイティブ同期機能は失われます。
IntercomノートからJiraへの添付ファイル同期
IntercomノートからJiraへの添付ファイルの同期に影響を与える既知の問題があります。修正が展開されるまで、課題作成後にJiraで直接画像をアップロードしてください。添付ファイルは自動的に転送されません。Intercomで共有された画像はticket内でアクセス可能ですが、Jiraにはコピーされません。Intercomのファイルリンクはセキュリティ保護され時間制限があるため、Jiraのフィールドに貼り付けてもJiraユーザーが確実に開けるわけではありません。ファイルを外部でホスティングし、公開URLを共有する方法がより信頼できる回避策です。
一般的なトラブルシューティング手順
統合に問題がある場合：
365日後に再認証が必要です
セキュリティ上の理由から、Jiraはアプリに対して365日ごとに接続の再認証を要求します。この期間が過ぎると、Jira for Tickets appを再インストールして認証を更新する必要があります。
IntercomでJira for Tickets appを再インストールしても、Jiraの課題は削除または変更されません。Jiraのデータは安全です：
再インストール中は、アプリが一時的にIntercomデータへのアクセスを失います。
既存のworkflowパスと自動化設定は変更されません。
アクティブなworkflowsは再インストールによって影響を受けません。
再インストール中はIntercomとJira間のticket同期が一時的に中断されます。
再インストール中に更新されるもの：
認証トークンのみが更新されます。
統合設定の再構成は不要です。ただし、認証が既存のworkflowに正しくリンクされていることを確認する必要があります。これを怠ると、workflowがJiraに接続しようとした際に401（Unauthorized）エラーが発生する可能性があります。
再インストールが完了すると、workflowは既存の設定を維持したまま自動的に同期を再開します。
作成画面にReporterフィールドがありません
ReporterフィールドはIntercomによって制御されていません。これはJiraプロジェクトの作成画面の設定の一部です。IntercomからJira課題を作成する際にフィールドが表示されない場合、Jiraで以下のいずれかが該当します：
ReporterフィールドがそのJiraプロジェクトの作成画面に追加されていません。
統合に接続されているAtlassianアカウントにプロジェクトのReporterの変更権限がありません。
これを修正するには、Jiraプロジェクトの管理者がReporterフィールドをプロジェクトの作成画面に追加するか、接続されているAtlassianアカウントにReporterの変更権限を付与する必要があります。どちらもJiraで設定し、Intercomでは設定しません。
どのJira Appを使用していますか？
IntercomはJiraとの統合方法を2つ提供しており、それぞれサポート方法が異なります：
Jira for Tickets: これは公式のIntercomアプリ（この記事で説明しているもの）です。このアプリのサポートとトラブルシューティングはIntercomチームが担当します。
Jira Cloud App: これはTools Plusが開発・管理するサードパーティ製アプリです。IntercomのサポートはJira Cloud Appの内部機能やロジックに対して限定的な可視性と制御しか持ちません。Jira Cloud App固有の機能（例：ステータス変更時の自動会話再開）に問題がある場合は、直接Tools Plusサポートチームに連絡してください。
重要：Jiraの課題ステータスが変更されると、直接リンクされたIntercom ticketのみが更新されます。ほとんどの設定では、これはTracker ticketです。
ステータス変更はリンクされたCustomer ticketsを自動的に更新しません。Customer TicketsはTracker Ticketからの一括更新を手動でトリガーする必要があります。
これはJira → Trackerの更新は自動的に行われますが、Tracker → Customer ticketの更新は手動操作が必要であることを意味します。