ferret OneからアクションがあったらLINEWORKSに通知

概要

このワークフローでは、ferret Oneでのフォーム回答をトリガーとして、通知内容をカスタマイズしてLINEWORKSへ自動で連携します。

想定シーン・課題

  • 問い合わせがくるたびに内容を確認し、振り分けをしている
  • メンションがつかないので問い合わせが埋もれてしまう

使用するアプリ・ピース

種別名前補足
アプリferret Oneトリガー用
ピースHTTP (OAuth2) (OAuth2リクエストを送信)

構築手順

Step 1:「テンプレートから作る」をクリックする

Step 2:「ferret Oneでアクションがあったら担当者にLINEWORKSに通知」を選択する

Step 3:Webhook URLをコピーする

Step 4:ferret Oneの管理画面より、該当フォームのWebhook設定を開き、「連携先のWebhook URL」に貼り付ける

 
  • workrunの画面に戻り、テストトリガーを実施し、連携できていることを確認しましょう
 
  • 一度テスト回答を行い、実データをworkrunに送りましょう!
  • テストが成功するとデータが確認できます

Step 5:developer consoleで認証用のアプリを作成する

  • 認証アプリを選択して、アプリ名は自由につける(bot名ではない)。
  • 認証アプリの情報画面でOAuth Scopesとworkrunのredirect URLを設定して「保存」を押す。
    • 注意点
      • Redirect URLは右側の「追加」ボタンを押してから保存してください
設定例(botからメッセージ送る場合)参考資料
OAuth Scopesbot, bot.message, bot.readhttps://developers.worksmobile.com/jp/docs/auth-scope
Redirect URLhttps://ap.b-work.run/redirect

Step 6:developer consoleでBotを作成する

  • 「登録」ボタンからBot情報登録画面を開いて、赤枠の部分を入力して保存する。
 

Step 7:管理画面からBotをテナントに追加する。

  • 右上の「Bot追加」を押すとDeveloper Consoleで設定したBotが見つかるので「追加」を押す。
  • 追加したBotをクリックして「修正」ボタンを押し公開設定を「公開」にする。このようにすることでトーク画面からもBotが見えるようになる。
 

Step 8:トーク画面でBotとのトークを作成する

  • 「新規作成」>「社内メンバーとのトーク」を押すとメンバー選択ができるのでBotから作成したBotを選択する。
  • Botとのトークが開始できる。

Step 9:workrunのOAuth2リクエストの設定を行う

  • workrunで「OAuth2リクエスト」ピースを選択し、接続を作成する。
  • それぞれの項目を入力していく。
項目入力例参考資料
クライアントシークレットhttps://jp2-dev.worksmobile.com/console/openapi/v2/app/list/view にアクセスし1で作成した認証アプリの設定画面に記載(添付画像参照)
クライアントIDhttps://jp2-dev.worksmobile.com/console/openapi/v2/app/list/view にアクセスし1で作成した認証アプリの設定画面に記載(添付画像参照)
URLを承認https://developers.worksmobile.com/jp/docs/auth-oauth#authorization-request
OAuth2トークンURLhttps://developers.worksmobile.com/jp/docs/auth-oauth#issue-access-token
スコープ(Botからメッセージを送る場合)bot bot.message bot.readhttps://developers.worksmobile.com/jp/docs/auth-scope
  • 入力したら「接続する」を押す。問題なければ「保存」ボタンが押せるようになる。
 

Step 10:「OAuth2リクエスト」にてメッセージ送信の設定を行う

項目入力例参考
URLbotIdはhttps://jp2-dev.worksmobile.com/console/bot/view のBotの詳細画面から確認できる。 channelIdはトークループの右上から取得できる。(添付画像参照)
方法POST
ボディタイプJSON
JSON BODYhttps://developers.worksmobile.com/jp/docs/bot-send-text
  • メッセージが送られていることを確認します。
 
 
 

注意点・制約

  • 繰り返しイベントをトリガーにする場合、大量実行される可能性があります
  • 外部アプリ側の仕様変更により動作が変わる場合があります
 

用語の定義

1. developer console

2. 管理画面

  • テナント(会社情報)を管理する画面

3. トーク画面l