IntercomのConversationsやTicketsからワンクリックで直接GitHub Issuesを作成し、ツール間の面倒なコピー＆ペーストを省きます。
統合方法
数ステップのクリックで簡単にGitHubとIntercomを統合できます。
Intercomと追加したいGitHubリポジトリの管理者権限が必要です。
まず、Intercomの
App Storeに行き、GitHub appを検索して今すぐインストールをクリックしてください。
すでにGitHub appをインストールしている場合は、一度アンインストールして再インストールしてください。その後、GitHubリポジトリを削除して再追加し、メインリポジトリを選択してください。
GitHubが新しいタブで開き、アプリケーションの認可を求められます。認可すると、Intercomは接続されたissueが更新された際にGitHubからwebhookを受け取れるようになります。
注意：GitHub組織でOAuth Appアクセス制限が有効な場合、組織のオーナーがIntercomを承認するまで認可は失敗します。オーナーは組織の設定 > サードパーティアクセス > OAuth AppポリシーでIntercom appを承認できます。承認後、統合を完了できます。
アプリケーションを認可すると、設定タブにアクセス可能なリポジトリ一覧が表示され、Intercomに接続できます。
各メンバーはGitHubでアクセス権のあるリポジトリのみ追加可能です。開発チームとissueを記録するメインリポジトリや、Intercomにリンクしたい他のリポジトリを選択してください。
次に、リポジトリを追加をクリックしてGitHubリポジトリをIntercomに接続します。
複数のリポジトリを追加した場合は、設定タブの上部で「メインリポジトリを選択」してください。
Intercomから直接issueを作成できるリポジトリは1つだけ選べます。他のリポジトリには会話リンクを貼るか、GitHub issueを会話のノートとして追加してリンク可能です。
リポジトリに関する注意：各メンバーはGitHub appの設定タブでアクセス権のあるリポジトリのみ見えます。デフォルトリポジトリが他のメンバーがアクセスできないものになる可能性があるため、全員がアクセスできるメインリポジトリを選んでください。
会話からGitHub issueを作成
Intercomの会話から直接GitHub issueを簡単に作成できます。
GitHub issueとして作成したいコメントやノートにカーソルを合わせ、三点リーダーアイコンをクリックします。
次に、新しいGitHub issueを選択します。
新しいGitHub issueが新しいタブで開きます。会話のテキスト、画像、会話リンク、顧客情報が自動で含まれます。必要に応じて編集し、GitHubで新しいissueを送信をクリックして作成してください。
IntercomからGitHub issueを作成するには、ブラウザでIntercomの「ポップアップを許可」する必要があります。
issueを作成すると、Finがそのissueにリンクされた会話にノートを残します。
issueがクローズされるとFinがノートを残し、関連するスヌーズまたはクローズされたConversationsやTicketsを再オープンして顧客に更新を伝えます。
会話をGitHub issueに貼り付ける
メイン以外のリポジトリでは、IntercomのConversationsやTicketsのURLをGitHub IssueやIssue Commentに貼り付けてリンクできます。これは設定タブで追加した任意のリポジトリで可能です。Fin AI Agentがノートを追加し、会話がクローズされると通知します。
注意：以前にGitHub Issueにリンクした会話にはFinは新しいノートを残しません。
GitHub issueをノートとして追加
GitHub IssuesのURLをIntercomの会話やticketのノートに追加してリンクできます。GitHub Issueがクローズされると会話やticketは再オープンされます。
BETA WorkflowsでGitHub Issue作成を自動化
Intercom Workflowsにアクセスできる場合、新しいGitHub Workflowテンプレートが新規Workflow作成時に表示されます。
アクセス権を得るには、こちらの価格とプランをご覧ください。
GitHub appにプリインストールされている3つのWorkflowテンプレートがあり、要件に合わせてカスタマイズ可能です。
GitHub Issueを作成 - メインリポジトリにGitHub issueを作成し、Intercom Ticketにリンクします。
GitHub Issueコメントを追加 - TeammateがIntercom Ticketにノートを追加した際、リンクされたGitHub Issueにコメントを追加します。
GitHub Issueを更新 - Intercom Ticketの状態が更新された際、リンクされたGitHub Issueにコメントを追加します。
GitHub Workflowテンプレートが表示されない場合は、GitHub appの設定タブでGitHubリポジトリを追加してください。
デフォルトテンプレートを使うか、Workflowsの力で編集できます。
Intercom情報をGitHub issueに渡す内容を編集するには、GitHub Actionステップの三点リーダーアイコンをクリックし、編集を選択します。
GitHub Create Issue Actionに属性を追加するには、タイトル、本文、ラベル、担当者の各フィールドで属性セレクターを編集して使用します。ラベルと担当者はカンマで区切り、GitHubリポジトリのラベルと担当者に一致させてください。
変更を加えたら、GitHub Create Issue Actionで保存をクリックします。追加した属性がアクションステップに表示されます。
GitHub WorkflowとActionが準備できたら、ライブ設定をクリックしてWorkflowを有効にします。
Workflowはトリガー条件が満たされたときに実行されます。
Workflowsの詳細はこちらをご覧ください。
よくある質問
複数のGitHubアカウントがある場合は？
複数のGitHubアカウントをIntercomと統合可能ですが、Intercomからissueを作成できるのはメインリポジトリのみで、全メンバーに適用されます。GitHub app設定で表示されるリポジトリ一覧は、現在のブラウザセッションでログイン中のGitHubアカウントのものです。
Intercomはリポジトリ内で以下の名前のテンプレートを探します。
.github/ISSUE_TEMPLATE.md
.github/issue_template.md
issue_template.md
ISSUE_TEMPLATE.md
.github/ISSUE_TEMPLATE/bug-report.md
このリストで最初に見つかったテンプレートが使用され、Intercom会話の事前入力情報がテンプレートの後に追加されます。
GitHubアプリケーション設定でIntercomのGitHubアカウントアクセスを取り消せます。
どのGitHubアカウントがリンクされているか変更するには？
統合を解除して再統合すると、元の認可済みGitHubアカウントに自動接続されます。別のアカウントに接続したい場合は、Intercomからログアウトし、新しいGitHubアカウントで同じブラウザにログイン後、再インストールとセットアップを行ってください。
独自のissueテンプレートがある場合は？
独自のGitHub issueテンプレートを使う場合、Intercomはテンプレートを保持しつつ、会話やTicketの事前入力情報をテンプレートの下部に追加します。
GitHub appに組織またはエンタープライズレベルのリポジトリアクセスを許可するには、GitHubの個人アカウント設定から明示的にIntercom appのアクセスを承認する必要があります。
手順：
https://github.com/settings/applications（個人アカウント設定）にアクセス。
Intercomアプリケーションを選択。
Intercomが組織にアクセスできるか確認し、必要に応じてリクエスト。
アプリに問題がありますか？
トラブルシューティングの一つとして、GitHubとの再接続を試してください。App StoreのGitHub app設定でGitHubに接続をクリックし、GitHub認可フローに従って再接続します。
すべてのGitHubリポジトリを表示するには、組織アクセスのリクエストを求められる場合があります。
会話にノートが追加されない問題がありますか？
リポジトリの設定 > WebhooksでIntercom webhookの横に✅があることを確認してください。
なければ、リポジトリの再認可が必要です。これで解決するはずです。
