操作ガイド
GitHub 連携
問い合わせを GitHub Issue に連携する設定方法を説明します
GitHub 連携を有効にすると、問い合わせをチケット化したタイミングで GitHub リポジトリに Issue を自動作成できます。開発チームが GitHub Issues を使って不具合や改善要望を管理している場合、サポート窓口で受けた問い合わせを開発タスクへ引き継ぎやすくなります
GitHub 連携設定の流れ
1
GitHub 連携プランを契約する
管理画面の「プラン・課金」で対象フォームの GitHub 連携プランを契約します
- GitHub 連携はフォーム単位のオプションです
- 契約していないフォームでは GitHub 連携設定を保存できません
- 契約後、フォーム設定画面に GitHub Issues 連携の設定欄が表示されます
2
Personal Access Token を用意する
GitHub 側で Issue を作成するための Personal Access Token を用意します
- トークンには Issue を作成できる書き込み権限が必要です
- 対象リポジトリにアクセスできるユーザーまたは組織のトークンを使います
- トークンは QAries に保存されるため、不要になったら GitHub 側で失効させてください
3
GitHub 連携情報を入力する
管理画面の「設定」にある GitHub Issues 連携で、オーナー名、リポジトリ名、Personal Access Token を入力します
- オーナー名には GitHub のユーザー名または組織名を入力します
- リポジトリ名には Issue を作成したいリポジトリ名だけを入力します
- トークン欄を空のまま保存すると、既存のトークンを維持します
4
連携を有効化して保存する
「GitHub 連携を有効にする」をオンにして保存します
- 連携を有効にする場合、オーナー名とリポジトリ名は必須です
- 保存に失敗する場合は、フォーム設定権限、契約状態、入力値を確認します
- 連携を一時停止したい場合は、設定値を残したまま有効化だけをオフにできます
5
チケット化して動作確認する
テスト問い合わせを作成し、管理画面でチケット化して GitHub Issue が作成されることを確認します
- Issue のタイトルには問い合わせの件名が使われます
- Issue 本文には送信者情報、フォーム回答、チケット化時点までのコメント、添付ファイル情報が含まれます
- GitHub API の呼び出しに失敗してもチケット化自体は完了し、失敗内容はサーバーログに記録されます
6
運用ルールを決める
運用開始後は、GitHub Issue と QAries チケットの役割をチーム内で決めておきます
- GitHub Issue はチケット化時に1回だけ作成され、後続の返信やステータス変更は自動同期されません
- 顧客への返信は QAries 側で行い、開発調査や修正作業は GitHub 側で管理すると役割が分かりやすくなります
- リポジトリやトークンを変更した場合は、設定画面で保存し直してからテストします
事前に確認すること
- 対象フォームで GitHub 連携プランを契約している必要があります
- フォーム設定を変更できる権限が必要です
- Issue 作成先の GitHub オーナー名とリポジトリ名を確認してください
- Issues への書き込み権限を持つ Personal Access Token を用意してください
セキュリティと運用の注意点
- Personal Access Token は秘密情報です。共有チャットやドキュメントに貼り付けないでください
- GitHub Issue への作成はチケット化時のみ行われ、QAries の返信やステータス変更は同期されません
- リポジトリ名を変更した場合や権限が変わった場合は、テスト問い合わせで再確認してください