［コピペでOK!］JANDIのトピックにWebhookでメッセージを送る方法

JANDIのトピックにWebhookを使ってメッセージを送る方法目次

JANDIにメッセージを飛ばしたい
チャットビューとボードビュー
トピックにメッセージを送りたい！
Webhookを使えば転送できる
自動化といえばIFTTTかZapier
設定方法
便利な使い方

チャットビューとボードビュー

まずはじめに機能のおさらい。
JANDIのコミュニティ（トピック）にはチャットビューとボードビューという2つの仕様があります。
チャットビューは名前のとおり、チャット。それぞれの会話が吹き出しで次々と登場します。
そしてボードビューはいわゆる掲示板。一つのお題に対してコメントをつける形で表示されます。

複数のお題が同時進行で走るときはボードビュー
ディスカッションを含めコミュニケーションや「あれどうなってる？」などの進捗確認にはチャットビューと、用途に合わせて利用できるのが特徴です。

JANDIは期間無制限でフリープランでも利用ができますが、（無料でも500人まで参加可能なんです！）
このボードビューは有料プランでしか利用ができません。

Webhookを使えば転送できる

Google先生に色々確認したところ、どうやらWebhook（ウェブフック）というものを使えば転送できることが分かってきました。

Webhookとは

カスタムコールバックを使用してWebページまたはWebアプリケーションの動作を拡張または変更する方法です。
Wikipediaより（英文）

なにやらよくわからないですね。
要は、JANDIに手動で投稿しなくても外部ツールからメッセージを受信できる機能らしいです。

使ってみたい！ということで更に調べてみました。

Webhookには受信と送信がある

その名のとおり、情報を送りたいときは送信・情報を受け取りたいときは受信です。

今回の場合は
JANDIで情報を受け取りたいので、Webhookの受信を使います。

『自分宛てに届いたメールをWebhookに転送し、そこからJANDIに送ってもらう』です。

ZapierはWebhookが有料だったため断念

Zapierは色々機能があったのですが、Webhookを使うには有料でした。
会社に決済を・・・（月額）と考えると断念せざるを得ませんでした。

IFTTTにはメールを転送できなかった

IFTTTは先日Googleメールのアプリ利用が終了してしまい、直でGoogleメールを接続することができなくなってしまいました。
そのため汎用的なメールアプリを利用して使うのですが、私のメールアドレスからIFTTT宛にメールを転送しないと起動してくれません。

Gmailは他ドメインへの転送は相手に許可をもらう必要があるため、IFTTT側に確認コードを送っても返答してくれないため転送処理をすることができませんでした。

困ったときに出てきたのがGoogle Apps Script（GAS）だった

途方に暮れていた私に一筋の光を与えてくれたのがGoogle Apps Scriptでした。
Googleアカウントを持っている人ならだれでも使えます。

ただ、ZapierやIFTTTのようにノーコードでは使えません。
そこで、先輩の力をお借りしてコピペで使えるコードを書いてもらいました。

Google Apps Scriptを使うと、Gmailと直で繋げることができるので、メールを指定してWebhookの送り先を指定すれば送ることができます。

右上のプラグ（コンセント？）がコネクタのマークです。
既に繋がっているコネクタがある場合は接続済みの数が表示されます。

2．追加ボタンをクリック

接続済みのコネクタがある場合はココに表示されます。
コネクタ数に上限はありませんので、複数の登録をしてもOKです。

3．Webhook受信を選んで追加ボタンをクリック

ボードビューにはまだ接続できるコネクタがWebhook受信しかないため、1つしかでてきません。
チャットビューには

・Webhook発信(Outgoing Webhook)
・Google Calendar
・RSS
・Trello
・JIRA
・GitHub
・Bitbucket
・Webhooks受信 (Incoming Webhooks)

と、8種類のコネクタが用意されています。
今回はWebhooks受信 (Incoming Webhooks)を使います。

4．Webhook URLをコピーする

https://wh.jandi.com/connect-api/webhook/…と始まるURLが生成されていますので、このURLをコピーします。

Google Apps Script（GAS）手順

今回はGoogle Apps Scriptを使って受信したメールを転送していきますので、Scriptを作成する必要があります。
ただし、ほぼ9割コピペでいけますので心配は不要です。

Script設定に必要なのはJANDIからコピーしてきたWebhookのURLと、転送したいメールの件名です。

5．Google Apps Scriptを開き新しいプロジェクトをクリック

https://script.google.com/u/0/home
上記URLから開き、左上にある新しいプロジェクトを作りましょう。

6．以下コードをコピーしてそのまま貼り付ける

This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters

Show hidden characters

	function main() {
	//JANDI
	const JANDI_WEBHOOK = "〇WebhookのURL〇";

	//Gmailから特定条件のスレッドを検索しメールを取り出す
	var strTerms = 'is:unread "〇メールのタイトル〇"';
	var myThreads = GmailApp.search(strTerms, 0, 50); //条件にマッチしたスレッドを取得
	var myMsgs = GmailApp.getMessagesForThreads(myThreads); //スレッドからメールを取得する→二次元配列で格納

	//各スレッド×メール
	for (var i = myMsgs.length - 1; i >= 0; i--) {
	var msgsInThread = myMsgs[i];
	for (var j = 0; j < msgsInThread.length; j++) {
	var msg = msgsInThread[j];

	//未読のみ
	if (msg.isUnread()) {
	//メールを既読にする
	msg.markRead();

	//メッセージ作成（絵文字も可）
	var msgBody = msg.getSubject() + "*\n" +
	msg.getFrom() + "\n\n" +
	msg.getPlainBody().slice(0,512) + "\n\n" +
	msg.getDate() + "\n";


	var msgJson = {
	"body": msgBody
	};
	var payload = JSON.stringify(msgJson);


	//JANDIに送る
	var options = {
	"method": "post",
	"payload": payload,
	"headers": {
	"Accept": "application/vnd.tosslab.jandi-v2+json",
	"Content-type": "application/json",
	}
	};

	UrlFetchApp.fetch(JANDI_WEBHOOK, options);
	}
	}
	}
	}

view raw JANDI_GAS hosted with ❤ by GitHub

3行目の〇WebhookのURL〇の部分を上記手順4でコピーしたURLを貼り付けてください。
6行目の〇メールのタイトル〇の部分を転送したいメールの件名に変えてください。

編集はこれで終わりです。
テンプレート作ってくれた先人に感謝するばかりです。

7．保存する

画面上部にあるフロッピーアイコンが保存ボタンです。
（フロッピーって今の子はわかるんでしょうか・・・？）

スクリプト名をまだつけていない場合は名前を付けてくれと表示されますので、名前を付けて保存してください。
「無題のプロジェクト」のまま保存してもいいですが、今後このスクリプトがなんなのか分からなくなってしまいがちなので、名前は付けておくのが安心です。