外部チャットツールを連携する

このページではチャットツールの連携方法をご紹介します。

Wistantで2023年3月現在連携可能なチャットツールはSlack、ChatWork、Microsoft Teamsです。
それぞれの連携方法をご紹介いたします。

メールでの各種通知の詳細はこちらをご覧ください。

※設定はシステム管理者の権限を持つ方のみ行うことができます。貴社ご担当者様へお問い合わせくださいませ。

Slackの連携方法

２．Slack上のチャンネルを一つ選択します。Slackへは全てメンバー個人へのDMで通知がなされますが、この設定画面ではDMという選択肢を選ぶことができないため、いずれかのチャンネルを選択してください。
（実際に選択したチャンネル宛に通知が飛ぶことはありません）

３．Wistantのアカウントと、Slackのアカウントを紐付けます。

Wistantのアカウントで使用しているメールアドレスと、Slackのアカウントで使用しているメールアドレスが同じ場合は、自動的にアカウント同士の紐付けが完了します。
上記に該当しないアカウント同士を紐付ける際は、対象となるメンバーのリスト内「Slackアカウントを選択してください」をクリックします。

その後表示される画面にて、表示されたリストの中から紐付けるSlackアカウントを選択し「このアカウントを選択する」をクリックして連携を完了させます。

以上の手順でSlack連携は完了します。

ChatWorkの連携方法

１．Chatworkアカウントを準備します。

①（任意）通知用のChatworkアカウントを用意する

Wistantの通知用にChatworkアカウントを用意していただき、以降の設定手順をそのアカウントで進めていくことで、Wistant用のアカウントからメッセージが投稿されます。

設定者のChatworkアカウントで設定を進めていきますと、そのアカウントとしてのメッセージが各Chatworkアカウントに投稿されてしまうので、普段のメッセージのやり取りにWistantの通知が混ざり込む形となります。

②Chatworkのコンタクトを追加する

Chatwork連携の設定中に、WistantのアカウントとChatworkアカウントを紐付ける手順があります。このとき、WistantはChatwork連携を行っている方のコンタクト情報をもとにChatworkアカウントを取得します。

Wistantアカウントと紐づけたいChatworkアカウントが自分のコンタクト一覧で管理されているか確認し、必要があれば以下のサポートページをご覧いただきChatworkアカウントを自分のコンタクトに追加してください。

コンタクトを追加する（Chatworkサポートページ）

２．ChatworkでOAuthクライアントを登録する

ChatworkのOAuthクライアント登録画面を開き、以下の情報を入力してOAuthクライアントを作成してください。

・クライアント名: Wistant
・クライアントタイプ: Confidential
・リダイレクト先URI: https://api.wistant.com/chatwork/oauth/callback
・スコープ
  ・永続的なAPIアクセスの許可（offline_access）
  ・自分のプロフィール情報の取得（users.profile.me:read）
  ・自分が参加しているチャットルームへのメッセージ投稿（rooms.messages:write）
  ・自分のコンタクト、及びコンタクト承認依頼情報の取得（contacts.all:read）

作成ボタンをクリックすると、ページの下側にクライアントIDとクライアントシークレットが表示されます。この2つをあとでWistantに登録するので、メモをしておいてください。

3．Chatwork連携を設定する

① システム設定内「外部ツールの連携」からChatworkをクリックします

② ChatworkのOAuthクライアントIDとクライアントシークレットをWistantに登録します。
先ほどChatworkのOAuthクライアント登録画面でメモしたクライアントIDとクライアントシークレットを入力して「この内容で保存する」ボタンをクリックします。

③ クライアントIDとクライアントシークレットをWistantに登録すると、そのままChatworkの画面に切り替わります。Wistantとの連携をすすめる場合は「許可する」ボタンをクリックします。

このとき、前の手順で設定したクライアントIDが間違っている場合は、Chatworkのエラー画面が表示されます。その場合はブラウザの戻るボタンでWistantの画面に戻り、正しいクライアントIDを入力してください。

④ 前の手順でWistantの連携が許可されると、Wistantの設定画面に戻ります。表示されているWistantのメンバー一覧から対象のメンバー名の横にある「Chatworkアカウントを選択してください」をクリックします。そして、紐付けるChatworkアカウントを選択して連携を完了させます。

以上の手順でChatWork連携は完了します。