「Taskworld API」 はタスクワールドのリソースにアクセスできる JSON ベースの Web APIです。様々なクライアントから実行可能で、タスクワールドのユーザーであれば、機能に制限なく、誰でも利用することが可能です。



本日は、「Taskworld API」の使い方サンプルを駆け足で見ていきましょう！

Let's スタート！

※API のリファレンスはこちらの、アジアサーバー向けのドキュメントを参照してください。
https://asia-api.taskworld.com/#introduction

------

まずは認証キーの取得からスタート！

クラウドサーバーによるタスクワールドのサービスは、アジア、欧米、欧州の3つの異なるリージョンで運営がされています。サインアップ時に選択したサーバーのリージョンがアジアであれば、アカウントおよびワークスペースは、アジアのサーバーで運営されているということになります。

利用しているサーバーのリージョンをチェックしてみましょう。タスクワールドのワークスペースにアクセスをして、そのURL のドメインが「asia-enterprise.taskworld.com」となっていれば、アジアのサーバーが使われていることが確認できます。


アジアリージョンの API に認証リクエストを送信して、認証トークンを取得してみましょう。

本記事では、 HTTP クライアントに Chrome専用アプリ「Postman」を使用します。Postmanの詳細に関しては、その公式サイトを参照してください。

Postmanを起動し、リクエストメソッド / API の URL / MIMEタイプを設定します。


続いて、 Bodyタブを開き、「raw / JSON」を選択して、登録情報のJSON（メールアドレス、パスワード）を入力します。


「Send」ボタンでリクエストを送信すると、下段に結果が表示されます。

今回はリクエストが成功し、レスポンスで以下の認証情報を取得できました：

・access_token（認証トークン）
・default_space_id（ユーザーが最初に作成したワークスペース）
・workspaces（ユーザーがアクセス可能なワークスペース）

「access_token」は、この先すべての API で使用します。その使用に際して制限などは設けられていないため、取り扱いには十分注意をしてください。


下は、メールアドレスが誤りの場合のエラーレスポンスです。


エラーに関しては、 API リファレンスのエラー情報を参照して下さい。


ワークスペースのデータ構成はこうなっています！

それではここで、ワークスペースを構成するオブジェクトの関係を少しだけ見てみましょう。

下図は、APIが返却するオブジェクトの概念的な関連図です。


タスク管理の基本構成は、ワークスペース ＞ プロジェクト ＞ タスクリスト ＞ タスクという親子関係になっています。

チャンネル（チャット）はユーザー／ワークスペース／プロジェクトに紐づいており、各々のチャンネルの会話がメッセージとして保存されます。

メッセージは、この他にタスクコメントとして単独でも使用されます。そのため、メッセージは 「parent_id」 と 「parent_type（channel / task）」の2種類のキーで親オブジェクトを識別している点に注意してください。

これらの登録データは、APIで取得する他に、一括でダウンロードすることも可能です。一括ダウンロードは、タスクワールドのアカウント設定画面からリクエストを送信できます。


※ダウンロードデータの型は、APIレスポンスとは若干異なります。

ワークスペースのデータ量が多いと、APIだけで構成を把握するのは大変です。あらかじめデータをダウンロードしておけば、開発がスムーズに進むのでオススメです。

それでは、実際にAPIを使ってみましょう！


APIで、ワークスペース情報を取得！

まずはワークスペースの情報を取得します。

「Get workspaces API」 で、ユーザーがアクセス可能な全てのワークスペースの情報を取得しましょう。ここからは、前述の取得済み「access_token」を認証に使用します。



「Get workspaces API」では、ワークスペースの「name」に注意してください。

「Taskworld API v1」 では、URL に使用するキー文字列（日本語の名前の場合はハッシュ値）が「name」として返ります。そのためレスポンスを見ただけでは、どれがどのワークスペースなのか区別するのが難しい時があります。

前述のデータダウンロードであれば、日本語名も取得できるので、可能であれば両者を突き合わせてレスポンスを確認する事をオススメします。


APIで、タスクリスト＆タスクを追加！

次は、APIを使い、プロジェクトにタスクリストを追加してみましょう。

「Create a tasklist API」を使用します。ワークスペース、プロジェクト、そして追加するタスクリスト名を指定して実行します。



リクエストが成功したら、タスクワールド上での表示を確認しましょう。下のスクリーンショットのように、タスクリストがリアルタイムで追加されます。


追加したタスクリストに、タスクを作成してみましょう。「Create a task API」で、先ほどのレスポンスの「list_id」を指定し、タスク名を設定します。


先ほどのタスクリストと同様、下のスクリーンショットのように、リアルタイムでタスクが追加されます。




APIで、タスクを更新！

それでは、APIにより、作成済みのタスクを更新してみましょう。

「Update a task API」で、タスクにポイント、ラベル色、タスク説明テキスト、開始日・期日を追加してみます。

※「API v1」では、日時をグリニッジ標準時で指定します。

更新に成功すると、レスポンスで更新後のタスクオブジェクトが返ってきます。



下のスクリーンショットのように、リアルタイムでタスクワールドのワークスペース上に、タスクの詳細情報が追加・更新されます。



APIではこの他に、タグやメッセージの操作、タスクの移動なども行えます。

ぜひ色々と試してみてください！


Slack bot を作ってみましょう！

サンプルソースを使用して、タスクワールドの特定のタスクリストを操作する、“Slack App” を作成してみましょう。

このサンプルでは、ローカル環境の node で稼働するタスクワールド操作コマンドを、「ngrok」 経由で公開して「Slack（スラック）」と連携させます。

1. localhost 環境構築

まずは、ローカル環境を構築します。

実行環境は ubuntu16.04 / node.js v9.11.2 です。

サンプルソースを API リファレンス「Examples」の github リポジトリリンクから取得しましょう。

ソースを使いやすい場所に展開したら、「tw-slack-bot」ディレクトリへ移動して、関連モジュールをインストールし、node を起動します。

この段階では起動確認だけできれば良いので .env は port だけ設定しておきましょう。

$ cd tw-slack-bot
$ yarn init # 設定値はデフォルトでOK
$ npm install --save-dev
$ cp .env.sample .env
$ vi .env # とりあえず port だけ設定
$ node index.js

続いて、「ngrok」 をインストールして localhost を公開します。

「ngrok」 に関しては、こちらのSlack のチュートリアルも参考にしてみてください。



2. Slack Appの作成とインストール

Slack Appを作成しましょう。作成方法はSlack 公式サイトでも公開されているので、ここでは、 slash command の追加手順だけ見てみましょう。

ブラウザで Slack にログインして、Slack App 構築ページを開き、「Create a slack app」を選択します。


作成ウィンドウが開くので、 Slack Appの任意の名前と、 開発対象のSlack ワークスペースを指定します。


「Basic Information」 が開いたら、「Slash Command」をクリックします。次の画面では、「Create New Command」に進みましょう。


「Create New Command」 画面に移動したら、次のようにコマンド設定を入力します。

・Command： /twctask
・Request URL： https://[ngrok で割り当てられたドメイン名]/twctask

その他は任意で設定し、「Save」をクリックします。


作成したコマンドをSlack のワークスペースにインストールします。

「Install App」画面では、「Install App to Workspace」をクリックして、次の画面で「Authorize」へ進むとインストールが完了します。




3. localhost のコマンド設定

最後に、ローカルのソースを編集してコマンドが正しく動作するように設定しましょう。

サンプルソースは北米サーバー向けになっているので、「tw-slack-bot/taskworld.js」の API URL をアジア用に修正します。



前述のステップで、「port」 を設定した 「.env」 に、今度は Slack と Taskworld API の設定を追加します。

Slack の情報はこの３つです。

・CLIENT_ID
・CLIENT_SECRET
・VERIFICATION_TOKEN

Slack の情報は「App Credentials」で確認します。

Slack のコマンド管理画面を開いて下の方にスクロールすると「App Credentials」の欄があるので、そこから必要事項をコピーして .env に記述します。



タスクワールドの情報は4件です。操作対象のタスクリストに関する情報と、認証トークンを記述しましょう。

・ACCESS_TOKEN： Auth API で取得した access_token
・SPACE_ID - ID： ワークスペース ID
・PROJECT_ID： プロジェクト ID
・LIST_ID： 対象のタスクリスト

.env を更新したら node を再起動します。


4. コマンドを実行する

作成したコマンドをSlack から実行してみましょう。


そうすると、下のスクリーンショットのように、タスクワールド上でタスクが新たに追加されます。



この他にも、Taskworld APIを活用することにより、サンプルをベースにして様々な機能を作り込んでいくことが可能です。

ぜひ色々と試してみてください！


--------------

タスクワールドは、15日間無料でトライアル利用が可能です。
トライアル期間中は、アナリティクス機能を含む、そのすべての機能を無制限で使えます。
日本語によるサポートもバッチリなので、ぜひ気軽にトライアルスタートを！

株式会社ビズ・クリエイションは、今年10周年を迎える住宅・不動産業界に特化したメディア運営会社です。昨年秋に、住宅会社が使えるイベント予約サイトを自社開発。住宅会社のサイトはアナログというイメージを刷新することに成功しました。この半年で社員が3倍に増加し、まさに急成長中の会社で、タスクワールドをどのように活用しているのか、イノベーション創造ユニット 広報・アライアンスチーム マネージャーの田中美都さんにお話を伺いました。


株式会社ビズ・クリエイションの事業内容について教えてください。


「工務店」、「不動産会社」、「設計事務所」等、企業を対象としたサービスとして、住宅見学会などの予約受付管理ができる“Kengaku Cloud”。より一般消費者向けのサービスとしては、「家を見せたい人」と「家を見たい人」をマッチングさせる住宅イベント情報掲載サービス“iemiru”。弊社は、この2つをメインの柱とし、事業展開を行っています。

そのほか、家づくりの情報を一括請求できる“イエコレ”の運営や、毎月1回発行のフリーペーパー『家。買う？』も発行しています。最近、ウェブマガジンも立ち上げて、お客様に役立つ情報を中心に、読み物に重点を置いたサイト運営も行っています。


タスクワールドの導入までの過程を教えてください。

実は、タスクワールドは取引先の会社からの紹介がきっかけとなり導入にいたりました。それまでは、別のタスク管理ツールと、チャット専用ツールを併用していたのですが、「ひとつにまとめてスッキリしたいよね」と話していたタイミングに「おすすめのツールがあるよ」と、オススメしてくれました。

新しいツールなので、操作や機能に慣れるまで面倒かなと少し懸念がありましたが、実際に使い始めるとそんなことはほとんどなく、今ではすっかり社内では、なくてはならないツールになっています。



タスクワールド導入の決め手を教えてください。

導入の決め手は、「複数ツールの併用がやめられない」という、かねてからの問題を、現実的に解決してくれるツールであると、トライアルを経て確信したことです。タスクワールド導入前に使っていたツールでは、常に複数のウィンドウを開いて作業する必要があるなど、面倒くさくスッキリしない使い勝手でした。また、完了したタスクを左から右に流していくことしかできませんでした。

タスクワールドなら、一個一個のタスクにおいて、コメントやファイルを付けることができ、担当者も明確化することができる等、「これが欲しい、これが必要」と感じていた機能がすべて備わっており、ツールの一元化を実現できたと同時に、レベルの上がったITツールの使い方ができていると感じています。



社内ではどのくらいの人数でタスクワールドを利用していますか？

社員全員使っています。弊社は、本社は岡山ですが、東京そして今年の6月には静岡に支社ができました。さらに営業担当に関しては、福岡、広島、四国全域へと出張に出るので、週に4日オフィスに居ないということも珍しくありません。プロジェクト管理ツールとしてだけでなく、毎日のコミュニケーションのためのツールとしても、社員全員がタスクワールドを使っています。特定のプロジェクトやタスクに関わらずに、一対一や、グループでのチャットができるのは、タスクワールドのオススメポイントの一つですね。

タスクワールドは、メールや電話のようなコミュニケーションツールといった位置付けですか？

そうですね。全員使っていますから。社員だけではありません。社労士さんやアドバイザーの方など外部メンバーの方にもライセンスをお渡しして、非公開設定なども活用して使用しています。

コミュニケーションツール以外の、タスクワールドの活用方法を教えてください。

タグ付けを活用して、稟議の提案もタスクワールドで行なっています。承認者をタグ付けして、右に移動していくといった使い方です。ガントチャートは、特に制作関連部署で活用しています。締め切りをつけたら自動でガントチャートが作られるから楽ですよね。

スケジュールや予定の管理もすべてタスクワールドで行なっています。弊社では毎月1回、本社のある岡山で全体合宿をやっています。前月の振り返りや当月のアクションプランを考えたり、講師を招いてのセミナーなども開催されます。合宿のスケジュールや予定の詳細も、すべてタスクワールドに格納という形で利用していますね。



使用見本になりそうな理想の使い方をしていただいているので、とても嬉しいです！

ありがとうございます（笑）。あとは、経営陣がおもしろいチャットを作るので、楽しみながら使えているのもポイントかと思います。例えば、「経営に関する疑問・質問なんでもしてきてワン！」といったチャットを作ったりするんです。チャットを使って、「気づき」とか「情報共有」とか、ラフにやり取りをしています。特定のプロジェクトに関連づけさせていないチャットの数も多いですね。

電話とメールそしてタスクワールド。利用頻度の割合を教えてください。

基本的には「タスクワールドがないと連絡手段がない」と言えます。タスクワールド導入時にルールが決定したんです。それは、「社内でのチャットは、タスクワールドで！」というものです。ビズ・クリエイションの唯一のチャットはタスクワールドのチャット。これは、会社のルールです。

社外の方とは、相手に合わせたツールを使用していますが、社内は全員タスクワールド。あとは使っちゃダメなんです（笑）

コミュニケーションツールとして、タスクワールドは100点満点の何点ですか。

「やり取り」という点に関しては100点です！ひとつだけ、改善希望ポイントを挙げるとしたら、「通知機能」ですね。メンションされていないと通知が来なかったり、わかりにくいことがあります。期待値を込めての採点と思っていただければ（笑）

コミュニケーションツールはタスクワールドに統一化されていることもあり、社員はツール内での情報共有の速度を毎日気にしていますね。社員同士、電話番号はまだ知らないけれど、タスクワールドのアカウントは知っているという感じです。コミュニケーションツールとしてのタスクワールドは、社員間の活発なやり取りを促してくれています。



タスクワールドはどのような会社にオススメだと思いますか？タスクワールドを活用されている御社ならではのアドバイスをお願いいたします。

上司が部下のタスク管理をできていないというケースは、意外と多いと思います。優れたITツールの導入は、そのような問題の解決に直結すると思っています。また、“意識の育成”という点でも役立つツールと感じています。弊社では、仕事は本人の能動性にまかせています。タスクワールドは、プライオリティが高いタスクは何か、本当に今日やるべき仕事かどうかなど、自分で考えて使いこなすツールだなと実感しています。

また、弊社の仕事の進め方は、チームを作り、プロジェクトを完了して、チームを解散する。つまり、人の出入りなどの動きが目まぐるしいという特徴があります。次々とプロジェクトをこなせているのは、タスクワールドを使っているおかげと思っています。

ズバリ！田中さんにとってタスクワールドとは何でしょう？

出社してパソコンを立ち上げ、最初に見るのはタスクワールドの画面です。自動で開くように設定しています。家族の顔よりタスクワールドの画面を見ている時間の方が、断然長いと思います（笑）それくらい、当たり前のように使っています。弊社では、入社時にタスクワールドのアカウントが用意されるので、これがないと仕事にならないという存在です。



--------------

タスクワールドは、15日間無料でトライアル利用が可能です。
トライアル期間中は、アナリティクス機能を含む、そのすべての機能を無制限で使えます。
日本語によるサポートもバッチリなので、ぜひ気軽にトライアルスタートを！

ポート株式会社は、「バーティカルメディア事業」、「採用コンサルティング事業」、「ポートメディカル事業」、「地方創生事業」という異なる4つの事業を展開しています。“時代を追うのではなく、時代を創る”をミッションに掲げ、これからの社会に“無くてはならない”を創造する。働き方改革の本格的な取り組みが注目される中、企業と自治体の架け橋となり、地方への企業誘致サポートを様々な斬新な手法で続ける会社です。

地方に拠点を置くプロフェッショナルが、東京に引けを取らないスケールとスピード感で仕事を進めるには、ITツールの活用はまさに不可欠。本日は、急増するプロジェクト管理のために、タスクワールドを導入した経緯や、現在の使い方などについて、地方創生支援室 室長の大村智一さん、アソシエイトの池内沙也さんにお話を伺いました。

地方創生事業2つの柱“場づくり”と“人づくり”


大学を出て就職する。人材は、地方から東京に流れ、地方は人口減少の問題を抱えることになります。地方創生事業では、この流れを東京から地方へと変えることを目指しています。

「地方の人が、なぜ東京に行くのか、それは地元に仕事がないから」と話す大村さん。仕事があれば、地元で就職したいという声が実は多いのだそう。そんな声に応えるべく、地方に働く場所を作り、地方で働く人を作る。東京から地方へと人材を戻すUIターン促進のために、地方で働くことを魅力的に伝えるプロモーションサイトの作成なども手がけています。

宮崎県日南市に、日南市初となるIT企業を誘致し、地方にサテライトオフィスを誕生させたことは、場づくりのモデルケースとなりました。

急激に増加したプロジェクトの管理にタスクワールドを導入


プロジェクトの数が少なかった頃のタスク管理には、スプレッドシートだけに頼っていたと話す大村さん。事業規模が急激に拡張し、30を超える数のプロジェクトが同時に進行し、その管理方法に限界を感じたのが、タスク管理ツールの導入検討を始めたきっかけに。

タスク管理ツールは、メンバーが実際に使わなければ全く意味がないもの。だからこそ、トレロを含む様々な別の専用ツールも使ってみた上で、一番使い勝手が良いと感じたことが、タスクワールド導入の大きな決め手だったそうです。

タスクワールドの魅力は、「プロジェクトごとに細かい管理ができること」と話す池内さん。まだタスクワールドの機能を十分に使いこなせていないと前置きしながらも、日南のサテライトオフィススタッフとのやり取りや、タスクの進行状況を常にチェックできることなど、便利さを実感しているとのこと。まだ併用を続けているツールは、近日中にタスクワールドに集約したいと考えているそうです。

オーバービューでタスクの抜け漏れをチェック

急激にプロジェクト数が増えた時期は、目の行き届く範囲に限界を感じていたと説明する大村さん。タスクワールドを使い始めると、誰が何をやっているのかが明確になったことが、導入による大きな改善ポイントのひとつとのこと。メンバーのキャパ状況がすぐにわかるので、仕事の振り分けがしやすくなり、誰かに偏った負荷がかかってしまうことを防げるようになったことも、メリットだったようです。


朝夕の2回、30分ずつ、これが現在の使い方。

メンバーの1日は、朝イチに今日やるべきタスクを、タスクワールドで確認することから始まるそうです。毎日夕方には、全プロジェクトの最新状況を様々な観点で俯瞰のできる「オーバービュー」機能を活用し、各プロジェクトの進行状況における抜け漏れチェックを、欠かさず行っているのだそう。この様に、タスクワールドを、チーム運営を支える基盤ツールとして積極的に現場で活用をすることにより、プロジェクトの品質を保ちながら、納期遅れを防ぎつつ、工数の大幅削除を実現していると説明してくださいました。

公共事業は書類が多い！だからこそ抜け漏れチェックに役立てたい


取引相手である地方自治体の多くが、「企業を誘致したい」と考えていると説明する大村さん。まだ具体的な戦略やノウハウを持てていない地方自治体をサポートし、企業側には、大阪、福岡のような大都市ではなく、様々な地方にサテライトオフィスを作る理由を提供していきたいのだそう。

企業にとって、地方にとって、ベストなマッチングができるように、自治体と企業の架け橋となりサポートしていくのが、ポート株式会社の地方創生事業における、現在の最大のミッションだそうです。

地方と東京の垣根をなくすためにも、タスクワールドのようなITツールは欠かせないとし、地方自治体のようなITとはかけ離れたイメージのある団体の方達にこそ、タスク管理ツールを活用してほしいと話してくださいました。


経営課題を地方進出で解決。地方で働く選択肢をもっと世の中に広めたい。未来の働き方をよくするために。ポート株式会社の地方創生事業の詳細についてはこちらから。



--------------

タスクワールドは、15日間無料でトライアル利用が可能です。
トライアル期間中は、アナリティクス機能を含む、そのすべての機能を無制限で使えます。
日本語によるサポートもバッチリなので、ぜひ気軽にトライアルスタートを！