メインコンテンツへスキップ

LINE WORKSと連携する　API 2.0 Ver.

Jugaad阿部
  • 更新

LINE WORKSと連携する　API2.0 Ver.

こちらではLINE WORKS API2.0への連携方法とSSOの設定についてご紹介します。

連携しますと、通知機能とアプリディレクトリ（別途設定が必要）を利用できるようになります。

※LINEWORKS　API 1.0は、2023年４月末でサービス終了しておりますので、
必ずLINE WORKS　API 2.0をご利用ください。


無料トライアル中のアカウントもLINE WORKS連携をお試しいただく事が可能です。
管理者のみが連携の設定・ユーザー連携設定を行います。（一般ユーザー様自身が設定する項目はありません）
LINE WORKSのFreeプランをご利用の場合は、通知とアプリディレクトリのご利用のみ可能です。

連携が成功した後、反映にお時間がかかる場合があります。
連携してすぐに通知が来ない、通知からアプリ遷移ではなくブラウザ版に遷移する場合は、少し時間を空けてからお試しください。

 

※アプリディレクトリの追加は、LINE WORKS連携後の対応です。
先にアプリディレクトリを追加しないようお願いします。


▶LINE WORKS連携利用の流れ

①LINE WORKSとJugaadを連携する　→　②JugaadのユーザーとLINE WORKSのユーザーを紐づける　→③SSOを設定する（LINE WORKSの有料プランユーザーのみ可能）　→　④アプリディレクトリを追加する

 



 

連携の際に必要なもの

「Jugaad」と「LINE WORKS」の連携をスムーズに行っていただくため、アクセス権限のあるアカウントのご用意をお願いいたします。

  • Jugaadアカウント(権限レベル：SuperAdminのみ)
  • LINE WORKS Developer Consoleへのアクセス権限(この本文のリンクからアクセス可能です）

 

目次

1.LINEWORKSにログインする
2.アプリの新規追加を行う
3.アプリ名称を入力する
4.アプリのアクセス権限・トークン設定をする
5.Redirect URLを入力する
6.OAuth Scopes の管理をする
7.保存する
8.Service Accountを発行する
9.それぞれの項目をJugaadに貼り付ける
10.Private Keyを発行・ダウンロードし、貼り付ける
11.LINEWORKSボットの作成・保存をする
12.LINE WORKSのユーザーと、Jugaadのユーザーを紐づける
13.連携に失敗した場合


1.LINE WORKSにログインしConsole画面をクリックします。

 

こちらのURLよりアクセスできます。

https://dev.worksmobile.com/jp/console/openapi/v2/app/list/view

2.APIのClientAppを選択し、アプリの新規追加を行います。


　　　　　　　　　　　　　　　　　　　　　　　　

3.

「認証アプリ」を選択
アプリ名称を入力し、同意して利用するをクリックします。
名称は任意で設定可能ですが、後から何のアプリか判断がつくようにしてください。

推奨：Jugaad　または　ジュガール



 

必要に応じてアプリの説明を入力します。（任意）


 

4.以下の設定を行います。
アプリのアクセス権限  　[「すべてのメンバー」　を選択

トークン設定
・Access Tokenの有効期限  　「24 hours」を選択
・Refresh Token Rotation  　「ON」　の設定のまま





5.Redirect URLを入力し「追加」をクリックします。


▶入力するURL
https://smartflow.vebuin.com/jp/

 


6.OAuth Scopes の管理を行います。

6－1．管理をクリックします
mceclip12.png


6-2.✓を入れて選択を行います。

※重要※
LINE WORKSのプランが有料か、無料かによって✓する項目が違うのでご注意ください。

■LINE WORKSが有料版の場合（5つにチェック）
bot
bot.read
security.external-browser
security.external-browser.read
user.read




■LINE WORKSが無料版の場合（３つにチェック）
bot
bot.read
user.read




7．OAuth Scope の選択画面で、「保存」をクリックします。




8.一番下のアプリ全体画面の「保存」をクリックします。



※上記の保存を行うことで、Service Accountが発行できるようになります。

 

9.Service Account  を発行します。
mceclip5.png

 

10.LINE WORKSのそれぞれの項目をJugaadの画面に貼り付けます。

 

Jugaadの管理画面　→　会社個別設定→　LINEWORKS設定を開きます。

JugaadログインURL

https://smartflow.vebuin.com/dash_board/index#/app/dashboard/home

 

 

①. LINE WORKS Domain ID

LINEWORKSの管理画面から、Domain IDをコピーします。

　　　　　　　　　↓
Jugaad画面のLINEWORKS2.0　Domain　IDに貼り付けます。
 

※必ず　LINEWORKS2.0　に貼り付けてください。



mceclip29.png
 



 

▶LINEWORKS画面

 

②Client ID
 

③Client Secret　
 

④Service Account   



mceclip10.png

　　　　　　　　　　　↓
▶Jugaad画面
 

mceclip12.png
       　　　　　　　　　　　　　　　
 

11.Private Keyを発行し、ダウンロードします。　　　　　　　　　　　　　　　　　　

mceclip19.png
 

 

ダウンロードされたデータを開きます。

※ご利用のPCによって、ダウンロードデータを開く方法が異なります。

クリックしても開かない場合は、適切なプログラムを選択してファイルを開いてください。

mceclip13.png

 

例）　ファイルを選択し、右クリック　→　プログラムから開く　→　Wordを選択
-----BEGIN CERTIFICATE-----
-----END PRIVATE KEY-----　　も含めて貼り付けをお願い致します。

 

mceclip22.png


Private Keyをコピーして、JugaadのPrivate Keyに貼り付けます。

mceclip24.png

 

10.LINEWORKSボットの作成・保存をクリックします

mceclip25.png

 

 

Jugaad画面の「LINE WORKSボットの作成・保存」をクリックします。
手順に誤りがなければ、「連携が完了しました」が表示されます。

 

※この後にユーザー設定を行いませんと通知が届きませんので、必ず最後までお読みください！！！




mceclip27.png

12.LINE WORKSのユーザーと、Jugaadのユーザーを紐づける

12-1.ユーザー管理から、LINE WORKSのIDを追加するユーザーをクリックします。




12-2. LINE WORKS　アカウントIDに、LINE WORKS IDを貼り付けます。

※LINE WORKS IDの貼り付け間違いにお気をつけください。

（メールアドレスとの間違い・ドメイン違い・@が全角など）

12-3.画面下の登録ボタンをクリックします。

 

12-4.ユーザー数が多い場合は、ユーザー登録とLINE WORKS IDの同時登録が可能です。

 

ユーザー一覧画面のCSV操作で、テンプレートをダウンロードして必要な情報を入力し、アップロードしてください。


13.連携に失敗した場合

連携出来なかった場合はエラーメッセージが表示されます。
また、ユーザー管理画面で、LINE WORKS IDを貼り付けるスペースが無い場合も連携が失敗しています。
Jugaad画面に貼り付けた内容に誤りが無いか確認をお願い致します。



 


◆連携がうまくいかない場合に確認、行っていただく事◆
・OAuth Scopes のチェックを入れた項目を確認する。

※user.readにチェックを入れ漏れていないか確認

　LINE WORKSがフリープランの場合３つ

　LINE WORKSが有料版の場合は５つ

・ID等の貼り付け間違いをしていないかのチェック
・Private Keyを再発行/ダウンロードし、再度Jugaadに貼り付ける

・ユーザー一覧に設定したLINE WORKS IDに誤りがないかのチェック

 

■LINE WORKS からのシングルサインオン（SSO）設定方法

※シングルサインオン（SSO）機能の連携にはLINE WORKSの「ライトプラン」以上のご契約が必要となります。LINE WORKSの無料プランのお客様はご利用いただけません

連携の設定と同様に、LINE WORKS Developer Consoleと、会社設定にアクセスできる管理者権限が必要です。

以下のリンクから参照して行ってください。
LINE WORKS　SSOの設定方法

 


◆LINE WORKSの連携解除について◆
LINEWORKS設定画面より解除することができます。




削除をクリックすると、確認画面が表示されます。スクリーンショット 0006-01-26 12.05.47.png

 

連携が解除されて、 ユーザー情報の、LINEWORKSアカウントIDの入力項目も表示されなくなります。


 

 

LINE WORKS Developer ConsoleのAPIについては、上記の連携解除を実施しても削除されません。

連携は解除されておりますが、こちらも削除をしてください。



LINE WORKS アプリディレクトリの設定方法

こちらでは、LINE WORKS アプリディレクトリの導入方法についてご紹介します。

LINE WORKS アプリディレクトリでは、以下の機能がご利用いただけます。

・LINE WORKS のチャットから、申請フォームを検索、遷移して申請
・LINEWORKS のチャットから承認・拒否、遷移して承認タスク一覧の確認
・LINE WORKS のチャットへの通知（承認完了・拒否・差し戻し・回覧・共有・リマインド）

※LINE WORKSとの連携方法は、こちらをご確認ください。
LINEWORKSと連携する　API 2.0 Ver.

 

※アプリディレクトリの追加は、LINE WORKS連携後の対応です。
先にアプリディレクトリを追加しないようお願いします。


▶LINE WORKS連携利用の流れ

①LINE WORKSとJugaadを連携する　→　②JugaadのユーザーとLINE WORKSのユーザーを紐づける　→③SSOを設定する（LINE WORKSの有料プランユーザーのみ可能）　→　④アプリディレクトリを追加する

 

目次

1.スマートフォンにJugaad・LINE WORKSのアプリをインストールする

2.LINE WORKSアプリ内の設定より、JugaadのアプリをBotリストに追加する
3.利用開始する

4..申請フォームにLINE WORKS連携で表示させる項目を設定する

連携の際に必要なもの

「Jugaad」と「LINE WORKS」の連携をスムーズに行っていただくため、アクセス権限のあるアカウントのご用意をお願いいたします。

◆スマホから対応する場合◆

1. スマートフォンにJugaadとLINE WORKSのアプリをインストールし、ログインする。
（既にアプリ版をダウンロード・ログインしている方は、必要ございません。）

 

2. LINE WORKSアプリ内の設定より、JugaadのアプリをBotリストに追加する

2-1. LINE WORKSのホーム画面から、サービスメニュの「アプリ」を選択します。

 

 

2-2. アプリ一覧から「Jugaad（ジュガール）」を選択します

 

2-3. 「追加する」をクリックします



 

2-4.利用規約およびプライバシーポリシーに同意します




2-5.メンバー選択を行い、保存をクリックします。

※全てのメンバー・一部のメンバーを選択する事が可能です


2-6.OKをクリックします。
（一定の時間がかかりる場合があります）

 

追加完了




 

◆ブラウザから対応する場合◆

 

2-1-1.LINE WORKSにログインし、右上のLINE WORKSのメニュー画面から「アプリ」を選択



2-1-2.Jugaad（ジュガール）を選択

 

 

2-1-3.「追加する」をクリック



2-1-4.追加メンバーを選択し、右上の「保存」をクリック


3.サービス通知にて、追加のBotリストに追加されたことが通知されます

3-1.Botを利用するとクリックすると、新たなBotが追加され、利用できるようになります。
先程、メンバー選択された管理者権限ではないユーザーにも、通知が届きますので、同じように「Botを利用」をクリックする事で、利用できるようになります。





 





※自動でBotが追加されない場合は、以下の対応でBotを追加してください。

トーク画面右下の「＋」マークをクリック
「社内ユーザーとトーク」　→　Botの「Jugaad（ジュガール）」を選択　→　OK

 

 

3-2..申請フォームを検索したい場合は、Botへのワード入力で、検索するか、申請フォーム一覧から申請が可能です。





 

申請をクリックすると、Jugaadのアプリ版に移行します。

フォーム連携に少し時間がかかる場合がございます。連携後すぐに申請をクリックしてJuugaadアプリの申請画面に移行しない場合は、時間をおいてお試しください。


2－8．承認をしたい場合は、承認依頼一覧をクリックし、閲覧したい申請をクリックします


2-9.申請内容を確認し、拒否・承認　を行う事が可能です
※Bot内に表示される項目は10個まで、事前に申請フォームで設定した、LINE WORKS連携した項目のみ表示されます。

項目連携をしていない内容を含めて全て確認する場合は、「表示」をクリックし、Juugaadのアプリから内容を確認して承認します。



4.申請フォームにLINE WORKS連携で表示させる項目を設定する
最大で、10個の項目までアプリディレクトリのbot通知に表示させる事が可能です。

申請フォーム作成で、📝マークをクリックし、[LINE WORKS/Tesms連携]に✓を入れて保存します。

 

 

※10個の項目で承認が可能かどうか、確認していない項目で承認可否が違ったという事の無いよう、運用方法を決めて設定いただきようお願い致します。


 

◆アプリディレクトリがエラーになった場合◆

 

・LINE WORKS連携をそもそも行っていない

→LINEWORKSと連携する　API 2.0 Ver.

・JugaadのユーザーとLINE WORKSのユーザーが紐づいていない
→　Jugaadのユーザー管理から、LINE WORKS IDの貼り付け間違いがないか確認

 

 

一般ユーザー向けガイドを別途ご用意しました。必要に応じてユーザーに共有をお願い致します。
LINE WORKSから申請・承認する


※アプリディレクトリをご利用する場合、LINE WORKS通知（URLリンク通知）と重複するため、
アプリディレクトリの通知が確認できましたら、「個人設定」からLINE WORKS通知をＯＦＦにすることとお勧めします。


以上でございます。
最後までお読み頂きありがとうございます。

関連キーワード👀
 LINE WORKS, 連携方法,LINEWORKS連携,LINE,ラインワークス,2.0,API2.0,LINE,ライン,SSO,シングルサインオン,連携解除

設定に関するご質問等は、support@smartflowhelp.zendesk.comまでよろしくお願いいたします。

関連記事