LoginSignup
16
15

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

Day 1

LINEWORKS Advent Calendar 2019

@taketakekaho(たけだ)

LINE WORKSのフリープランでBot開発のための設定

Last updated at Posted at 2019-12-01

アドベントカレンダー初日ゲットしました！が、初日でもありますし、私はLINE WORKS初心者向けの内容でスタートしようと思います。LINE WORKSは無料でもBot開発ができるようになってますので、Bot開発するまでのLINE WORKS側の設定や前提情報など書きます。

対象とする方

  • LINE WORKSを初めて触る
  • チャットボットって何？はなんとなく知っている、もしくは作ったことがある
  • LINE WORKSでチャットボット作ってみたい
  • REST API使った開発を行ったことがある

LINE WORKSとは

超簡単に言うと、ビジネス版のLINE（みたいなメッセージングサービス）にグループウェアのような予定表や掲示板などの機能を追加したサービスです。個人ではLINEで自由に色んな人とつながってコミュニケーションをとりますが、会社や組織、団体、コミュニティなど管理された範囲で利用するための機能があるプラットフォームですね。
image.png
詳細は以下参考になるかと思います。

プランによって費用が違います。ちょうど1年くらい前に無料プランができまして、機能に一部制限はありますが、初めてのBot開発ならフリープランで十分かと思います。プラン情報はこちら参照。
image.png
フリープランについての機能比較や有償との違いはここのよくある質問にまとまってます。

LINE WORKSセットアップに必要なもの

  • インターネットがつながるパソコン
  • 以下のブラウザのどれか（ブラウザ要件のドキュメントこちら）
    • Internet Explorer: IE10, IE11
    • Chrome: 最新版
    • Firefox: 最新版
    • Safari: 10.1 以降
    • （任意：必要に応じて）Postman
    • （任意：必要に応じて）callbackURL

Bot開発環境構成

Bot開発する時の構成イメージはこんな感じかと思います。
使うクラウドによっては、ローカルでの開発ではなくcloud9やherokuなどクラウド上で開発＆テストすることもありますが、Botとユーザーが会話する上では、Botにメッセージなどを送信する時のLINEWORKS側のAPIと、Botからプログラムに対してメッセージなどを送信するためのCallbackが必要になります。
image.png

手順

それではさっそくLINE WORKSのセットアップから作業します。

LINEWORKS無料プランで新規開設

こちらに公式の新規開設手順あるんでそのままっちゃそのままですが
無料版に特化して手順書きます。

LINE WORKS 公式サイトにアクセス

LINE WORKS公式サイトにアクセスし、右上にある[無料ではじめる]をクリックします
image.png

新規開設方法を選択して認証

新規開設方法の選択画面が表示されます。
image.png

サービスを利用するグループの名前になる企業/団体名を入力します。
image.png

企業/団体名の業種を選択します。
image.png

この業種はチュートリアルやガイド表示のために使われるようなので特に不要の場合には「選択しない」でよいと思います。

管理者になる名前を登録します。
image.png

携帯電話の電話番号を入力し、[認証番号を送信]をクリックします。
image.png

携帯電話を持っていない人あるいは電話番号を登録したくない方は電話番号以外の認証も可能ですので別の方法で新規開設のリンクをクリックして設定してください。

登録した携帯電話の番号宛にSMSが届きます。
image.png

SMSに届いた4桁の番号を、入力してください。
image.png

アカウント情報を忘れた場合の確認用として使われるメールアドレスを登録します。
image.png

はい。登録完了しました。自分1人だけのワークスグループに誰か招待する場合にはここから招待できますしあとからでも追加できます。[サービスをはじめる]をクリックします。
image.png

はい。完成。ユーザー利用画面が表示されます。
image.png

電話番号のみのログインだけでなくIDとパスワードログインもできるように設定します。右上のアイコンクリックして表示されるメニューから個人情報をクリックします。
image.png

環境設定画面の左ペインで[セキュリティ]をクリック
image.png

パスワード変更をクリックします。
image.png

IDとパスワードを入力します。IDも一緒に変更できるようです。
image.png

ID/passでログインできるか確認しましょう。
image.png

管理者画面表示

右上の自分の名前をクリックして表示されるメニューの中から[管理者画面]をクリックします。
image.png

黒いメニューバーの画面が表示されます。これが管理画面です。
image.png

色々いじってみる

ユーザー操作感はLINEですし、管理者設定なども感覚で操作できますので習うより慣れろで色々いじってみればすぐに慣れるはず。わからないことあればこちらのガイドがわかりやすいかと思います。
プランのアップグレードをしない限りは有償になることがないので安心していじれますね。
フリープランでも有償の機能画面は見れたりするので、ひととおりボタンクリックして見てみるとよいかと。
image.png

設定しておいた方がいい作業

以下はBot検証のためやっておいた方がよいかと思います。

  • 他のテスト用アカウントを数名追加する（自分だけだとルームすら作れない...） [ガイド]
  • トークルームを適当にいくつか作成
  • モバイルにアプリをインストールしてログインしとく（ボット作るにはモバイルUIも知っといた方がよい）
  • 組織をいくつか作ってユーザーを所属　[ガイド]
  • Bot登録作業するユーザーにはDevelopers権限を付与（初回登録したアカウントのままなら最高責任者になるので特に追加作業不要です） [ガイド]

私はこんなユーザー構成にしました。
image.png

Botの登録

BotアカウントはLINE WORKS Developer Consoleから登録します。

Developwer Consoleログイン

LINE WORKS Developer Consoleを開き、右上の[Developwer Condole]をクリックします。
image.png

私はログイン情報のキャッシュ拾ってそのまま次画面に遷移しましたが、キャッシュ情報がなかった場合にはLINE WORKS認証画面が表示されますので、Developer権限保有しているアカウントでログインします。
image.png
Developer権限がない場合にはこのようなエラー画面になりますのでAdmin画面から権限設定（権限設定ガイドこちら）してからもう一度Developer Consoleにログインしてください。
image.png

利用規約画面に遷移しますので内容確認後、同意チェックして[利用する]をクリック
image.png
これが LINE WORKS Developwer Console画面です。
image.png

APIの発行とBot登録

ドキュメントのこちらに詳細説明ありますが、APIには2種類あります。

  • Service API（ログインユーザー本人のデータのみアクセスできるAPI）
  • Server API（ドメイン内すべてのユーザーデータにアクセスできるAPI）
    どういうボットを作るのかによって利用するAPIが変わります。

今回は、誰かが何か発言したらそのトークルームに何か返すというBotを想定してましたのでServerAPIになるかと思います。（多分）
まずはAPI IDの発行
image.png
ペロンと出てきて
image.png
発行完了
image.png

で、次にServer API Consumer Key発行
image.png

※LINE WORKS APIあるあるなんですが、「Service」と「Server」って見間違えやすいので注意です。

Step1でAPIの権限範囲を指定します。ここでは特に要件がないので全部チェックいれます。（後から変更可）
image.png
固定IPタイプのサーバーの場合の発行するToken設定を指定します。
image.png
発行されました。
image.png
image.png

次に、Server Listを登録します。今回はローカルで開発してボットサーバーに上げるので、そのタイミングでIPアドレスが変わってしまいますが、ローカル開発中は自分のパソコンのグローバルIPアドレスを登録することになります。
Server List（固定IPタイプ）の[追加]をクリックして
image.png
Server List画面でサーバー名とグローバルIPアドレスを入力し、Keyをプルダウンから選択後、[発行]をクリックします。
image.png
ポップアップが表示されるので[OK]をクリックします。
image.png
[同意して利用する]をクリックします。
image.png
はい。登録できました。
image.png

Bot登録

APIが準備できた所で、Botアカウントの登録を行います。LINE WORKSは、LINEやSlackと同様でボットアカウントをチャット側で提供してくれます。
Developer Consoleの左メニューから[Bot]をクリックします。
image.png
[登録]をクリック
image.png
Bot登録画面で該当する項目を埋めます。Callback URLは開発後でもいいですが、テストのためngrok使えば一時的に受信するhttpsのURLが発行できるので便利です。
image.png
Botの管理者を自分に設定して[保存]します。
image.png
image.png
Botのステータスが準備中になってますね。
image.png
トークBotの状態の見方はここのドキュメントにありますが、まだ今の状態だと私が作ったLINE WORKSのワークスグループに繋がってない状態です。
image.png

ドメインへのBot追加

ドメイン（ワークスグループ）に先ほど作ったBotアカウントを追加します。Admin管理画面に戻り、上のメニューからサービス＞Bot＞追加をクリックします。
image.png
先ほど作ったBotが表示されるのでチェックして[追加]
image.png
image.png
追加されましたが、非公開になってますね。
image.png
開き、公開設定にチェックを入れて[保存]をクリックします。
image.png
公開になりました。
image.png
チャット画面では管理者より通知されました。（これ通知しないという設定もどっかにありましたが開発用テナントなんで今回気にしない）
image.png
Developer ConsoleのBot画面のステータスもサービス中に変わりました。問題なさそう。
image.png

これでLINE WORKSとBotアカウント、ローカル環境がつながりました。
動作確認はPostman使うのが便利かと思います。（詳しくは明日以降のアドベントカレンダーでも投稿ありそうな予感..期待！！）
image.png
image.png

フリープランでAPIはどこまで使える？

ドキュメントのここに説明ありますが、フリープランだとBot10個までで、トークのみしか使えないです。
(´･ω･`)ｼｮﾎﾞーﾝ
kintoneみたいにDeveloperプランとかあったらなー...LINE WORKSさーん
壁|||ω｀）＜チラリ）
image.png

まとめ

LINEWORKS側のセットアップからボット開発できるようになるまでをまとめました。次回は、実際のボット開発をまとめてみようと思います！
皆でこんなボット作ったよっていうのがあったら是非教えてください♪

参考になるURL

16
15
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
16
15

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?