アークウェブのブログ

npmでPackageのインストール

node.js でredmine APIを叩くnpmがあるのでインストールします。
node-redmine

Gmailのメールボックスで新着メールを監視してくれるように inbox をインストールします。
メール本文を取得できるように mailparser をインストールします。

npm init -y
npm install -S node-redmine
npm install inbox
npm install mailparser

redmieの設定

redmineへログイン後、「個人設定」→「APIアクセスキー」の下の「表示」を押すと表示される redmine-APIキー をメモしておきます。
※redmineのバージョンが低い場合は出ません。その場合はまずredmineのバージョンアップをしてください。

クリックで拡大

GMailの設定

GMailL側の設定
「メール転送とPOP/IMAP」から「IMAPアクセス」が無効になっている場合は有効にします。

クリックで拡大

nodeのメインプログラムを作る

コードはGit参照。
https://github.com/ARK-Web/node_inbox2redmine

rdm-mailhandler.rb のようにメールをパースして、必要なプロジェクトに担当を指定して投稿するような高級な機能はなく、 極シンプルな実装 ですが今回必要なredmineに投稿するのは事足ります。

node-redmineのcreate_issue()メソッドで引数issueのパラメータを入れます。プロジェクトIDやトラッカーID、担当者IDが数字で入ってますが、この辺はredmine側を調べてください。

            redmine.create_issue({
                'issue': {
                    'project_id'    : 379,        // プロジェクト ID 「projects.xml?limit=100」へアクセス
                    'tracker_id'    : 6,          // トラッカー ID
                    'subject'       : escapeHtml(mail.subject),    // チケット名
                    'description'   : escapeHtml(mail.text),        // 説明 : 改行は「\r\n\」で書ける
                    'assigned_to_id': 4,            // 担当者 ID
                    'start_date'    : '2019-12-01',  // 開始日 : 文字列 'YYYY-MM-DD'
                }

実行すると「connected」と出力されるので、これでGmailのメールボックス監視ができたことになります。あとは、Gmailにメールをすればredmineに投稿されます。

実行：
node inbox2redmine.js

slackに通知を投げる

コードは先程のメインプログラムに書いてあります。
↓これだけ。

                // ついでにSlackになげる
                var id = ticket.issue.id;
                var link = 'https://＜redmineのURL＞/issues/'+ id;
                var slack_msg = "お問い合わせがありました。「"+ ticket.issue.subject +"」のチケット参照 <"+ link +">";
                slack.write(slack_msg);

slack.write()については lib/slack.js の方に細かい実装は書きました。
Webhook URL については次を参照ください。

slackの Webhook設定

「Incoming WebHooks」を使います。
* Slack Add App より incoming-webhooks を検索します。
* 【Add to Slack】を押す
* 「Post to Channel」から投稿するチャンネルを指定して【Add Incoming WebHooks integration】を押す
* 「Webhook URL」 をメモしておく
* lib/slack.jsの hooks に登録 する

実行

実行方法はredmine投稿の時と同じです。gmailにメールすると、redmineに書き出されてチケット番号をSlackで通知します。

実行：
node inbox2redmine.js

まとめ

今回は、A-Formの管理者宛てメールからRedmineへのつなぎ込みについて実装しました。登録用のAPIがあれば他のシステムへの登録も可能かと思います。

お問い合わせ情報の共有や、ステータス管理などに外部サービスをお役立てください。