チャットツール連携 Chatworkと連携する
チャットツール連携とは
チャットツール連携とは、モチベーションクラウド シェアリング上にコンテンツが公開されると、自動でChatworkやSlackに通知が届くように設定できる機能です。スペースごとに設定できます。
- モチベーションクラウド シェアリングに設定されているカテゴリごとに自動通知の有無を設定できます。
- 通知が届くように設定されているカテゴリでも、コンテンツ公開時に「閲覧制限」で公開範囲を絞っている場合、自動通知は届きません。
Step0：事前準備
本連携をする前に、あらかじめ下記を準備してください。
- Chatworkのアカウントを作成する
- Chatworkに通知を送りたいルームを作成し、メンバーとして参加する
Step1：IFTTTのアカウント新規作成する
モチベーションクラウド シェアリングとChatWorkを連携するには、「IFTTT」という外部サービスを利用し、Webhook URLを発行する必要があります。
IFTTTとは、複数のサービスを連携できるWebサービスのことです。ご利用いただくにはアカウント作成が必要となります。
＜注意＞
- IFTTTは外部ツールのため、弊社サポート対象外となります。操作手順やトラブル発生した場合は、IFTTT上のヘルプページ等をご確認ください。
- 推奨ブラウザがGoogleChromeのみとなります。
①「IFTTT」にアクセスし、画面右上「Get Started」をクリック
②「sign up」をクリック
画面上に表示されている各種アカウントをすでにお持ちの場合、そのログイン情報でIFTTTのアカウント作成ができます。
③メールアドレスとパスワードを入力し「Get Started」をクリック（※アカウント新規作成の場合）
④アカウント作成完了
Step2：IFTTTとChatworkを連携する
作成したIFTTTアカウントをChatworkに連携します。
⑤「Explore」をクリック
⑥「Search」で「Chatwork」と検索し、「Chatwork」を選択する
⑦画面中央の「Connect」をクリック
⑧表示されている内容を確認し、「許可」をクリック
⑨連携完了
Step3：Webhookを準備する
IFTTTの「Webhooks」というサービスを利用します。ここでは、通知を送りたいChatworkのルームや通知文の形式などを指定します。
⑩「IFTTT」画面にて、「Create」をクリック
⑪「If This」をクリックし、「Search services」に「Webhooks」と検索する
⑫「Webhooks」をクリック
⑬「Receive a web request」をクリック
⑭「Event Name」にAppletの名称を入力し、「Create trigger」をクリック
名称は特に指定はありません。自由にご設定いただけます。
※推奨名称：「cc_chatwork」など
⑮「Then That」をクリックし、「Chatwork」を検索する
⑯「Post a message」をクリック
⑰「room」を選択、必要に応じて「message」を変更し、「Create action」をクリック
-
A：room
通知を送りたいChatworkのルームを選択してください。
※IFTTTと連携したChatworkアカウントが参加しているルームのみ選択できます。
-
B：message：
Chatworkに届く通知文を指定することができます。必要に応じて変更してください。
以下推奨している形式です。
---------------------------
[info][title](lightbulb)【新着記事のお知らせ】{{Value1}}[/title]
{{Value2}}
[/info]
---------------------------
「Value1」に「コンテンツタイトル」、「Value2」に「コンテンツ内容の冒頭一部」と「コンテンツURL」が自動で挿入されます。
上記のように入力すると、下図のようにChatWorkに通知が届きます。
「message」内は後から変更できます。詳細は通知文の固定文字列を変更するの手順をご確認ください。
⑱「Continue」▶「Upgrade」をクリック
⑲準備完了
Step4：Webhook URLを取得する
⑳右上のユーザーアイコン▶「My services」をクリック
㉑「Webhooks」をクリック
㉒「Documentation」をクリック
㉓「To trigger an Event with 3 JSON values」＞「Make a POST or GET web request to:」のURL内「{event}」にAppletの名称を入力する
※Appletの名称とは、手順⑭で「Event Name」に登録した名称のことです。
例：「Event Name」が「cc_chatwork」の場合、「event」に「cc_chatwork」と入力します。
下記URLがWebhook URLとなります。
このURLをモチベーションクラウド シェアリングに登録します。
㉔「With an optional JSON body of:」の「value1」と「value2」に文字を入力し、「Test it」をクリック
本操作によって、連携したChatWorkルームへテスト送信ができます。本番の通知では、以下のように自動で挿入されます。
- 「value1」：コンテンツタイトル
- 「value2」：本文の冒頭一部
本操作の時点では、自動で挿入されないため、イメージがわかるように手入力で好きな文字を入力してください。
Step5：Webhook URLをモチベーションクラウド シェアリングに登録する
取得したWebhook URLをモチベーションクラウド シェアリングに登録します。
㉕「管理」＞「チャットツール連携」をクリック
㉖「Webhook URL」を入力し、「通知」「連携するカテゴリグループ」「連携するカテゴリ」にチェックを入れる
- A：取得した「Webhook URL」を入力する
-
B：「配信する」にチェックする
チェックを外すと、Chatworkに通知が届きません。 -
C：連携する「カテゴリグループ」「カテゴリ」を選択する
選択したカテゴリにコンテンツが投稿されると、ChatWorkに通知が届きます。
㉗「テスト送信」を実施し、「保存」をクリック
「テスト送信」を実施し、正常に連携できているかを確認してください。「テスト送信」は保存してからでも実施できます。
これでモチベーションクラウド シェアリングとChatWorkの連携は完了です。
＜注意＞
Chatworkに自動通知されるコンテンツURLは、IFTTTによって発行されたURLです。
例：https://ift.tt/xxxxx
クリックすると、通常のコンテンツ画面へ移行します。通知文にモチベーションクラウド シェアリングのURLを表示させたい場合は、IFTTT上の「Account」の設定を変更する必要があります。下記手順をご確認ください。
①IFTTTにて、右上の「アイコン」＞「Account」をクリック
②下にスクロールし、「URL shortening」の「Auto-shorten URLs」のチェックを外し、「Update」をクリック
通知文の固定文字列を変更する場合
①「HOME」から、変更したいAppletをクリック
②「Setting」をクリック
③「Then」をクリック
④内容を編集し、「Update action」をクリック
「Value1」と「Value2」には、それぞれ「コンテンツのタイトル」と「コンテンツ内容の冒頭一部」「コンテンツURL」が自動で挿入されます。
※「{{Value1}}」と「{{Value2}}」は必ず残してください。
参考：下図のイメージで通知の形式を作成したい場合
＜「message」入力欄＞
-
通知のメッセージを枠で囲む
[info] [/info]で通知メッセージを囲むことで、メッセージを枠で囲むことができます。 -
タイトルを表示させる
[info] [/info]で囲んだ内側で、[title] [/title]で囲むことでタイトルを表記させることができます。 -
絵文字を入れる
Chatworkで使用可能な絵文字が使用できます。
⑤「Update」をクリックして完了