Webhookを利用してチャットツール「HipChat」と外部ツールを連携させてみよう

JIRAやConfluenceをもっと使いこなそう！ エキスパートが教える、外部ツール連携術 第3回

　昨今、開発現場での情報共有は必須ともいえるほどに重要視されています。情報共有ツールとしてJIRAやConfluenceといったアトラシアン製品は多くの開発現場で使用されていますが、チームの仕組みに存在するからなんとなく使っている……そのような方も多いのではないでしょうか。しかしせっかくのツール、多種多様な機能をもっと活用したいと思いませんか？ 本連載では使い慣れた環境と組み合わせてツールをさらに使いこなす方法を、アトラシアン製品の国内販売代理店であるリックソフトがお伝えします。前回はJIRA Softwareを「Alfresco」と連携させました。今回はWebhookを利用し、アトラシアンのチャットツール「HipChat」と外部ツールを連携させる一例をご紹介します。

はじめに

　「HipChat」はビデオ通話や画面共有機能などを備えた、エンタープライズ向けのチャットツールです。

　今回はHipChatに投稿されたメッセージを翻訳する機能を、HipChatのWebhook、およびZapierを使用して実現させます。Webhookとはアプリケーションから別のアプリケーションに対してリアルタイムな情報提供を実現するための仕組みで、Zapierは複数のサービスを簡単に接続できるサービスです。翻訳は、投稿されたメッセージが日本語なら英語、英語なら日本語に翻訳できるようにします。

開発環境

　HipChatはオンプレミス版のHipChat Serverとクラウド版のHipChat Cloudがありますが、今回は手軽に試せるクラウド版を使います。

• HipChat Basic（ユーザー数に制限なく、無料でテキストのやり取りを行うことができます）
• Zapier

連携の構成

　HipChatとZapierの連携は下図のように、ユーザーがHipChatに投稿したメッセージをWebhookでZapierに通知します。ZapierはWebhookで受け取ったメッセージを英語／日本語判定して翻訳し、翻訳後にメッセージをHipChatに投稿します。

メッセージ翻訳の流れ

ZapierでZapを作成する

　まず、ZapierでZapを作成します。Zapierにログインしたら、画面上部の［MAKE A ZAP!］をクリックします。すると、Zapの編集画面が表示されるので、まずはZapの名前とトリガーの種類を決めます。

　ここではZapの名前は「HipChat Translation」とし、TriggerはWebhookを起点として動かしたいので［Webhooks］を選択します。

Zapの編集画面

　「Select Webhooks by Zapier Trigger」では［Catch Hook］を選択し、「Set up Webhooks by Zapier Hook」では、そのまま［Continue］をクリックします。

　その後、「Test Webhooks by Zapier」に表示される「Use this」にWebhookの送信先URLが表示されるので、こちらをメモしておきます。

　この画面でWebhookの接続確認をしますが、まだHipChat側でWebhookが作成されていないため次の手順で作成していきます。

REST API用の認証トークンを作成する

　続いてHipChat側でWebhookの作成を行います。

　Webhookの作成にはREST APIを使用します。REST APIを使用するにあたり認証トークンを作成する必要があるので、まず認証トークンを作成します。

　HipChat画面右上のユーザーアイコンから［Account setting］→［API access］と進めて「API Access」画面を表示します。

API Access画面

　［Scopes］の選択リストから［Administer Room］を選択し、適当にラベルを入力して［Create］をクリックします。

　認証トークンが表示されるので控えておきます。