octpathは特定アプリケーションとの連携が可能です。ここではoctpathとSlackを連携し、主要な通知をSlack上で確認するための方法を記載します。
Slackと連携しプロセスに関する通知を受け取れるようにする
通知内容
現在Slackと連携することで通知される内容は以下になります。
・プロセス開始
プロセスを開始したメンバー、プロセス名、フロー名を通知します。
※定期実行でのプロセス作成時はプロセスの開始者は「octpath」として表示されます。
・タスク担当者の割り当て
担当者を変更したメンバー、担当者に割り当てられたメンバー、変更されたタスク名、プロセス名を通知します。
※担当者を未割り当てに変更した際も通知されます。
・プロセスのコメント追加
コメントを追加したメンバー、プロセス名、コメントの内容を通知します。
Slackとoctpathの連携を許可する
最初に、octpathとSlackの連携自体を許可する作業を行います。これにより、フローごとにSlack通知を受け取るチャンネルの設定が可能になります。
まず、octpathにログイン後、画面左側の設定ボタンをクリックして、「アプリ連携」からSlackのアイコンをクリックします。「アプリ連携」はチームのオーナー権限を持つユーザーしかアクセスできません。
画面が遷移し、Slack側の設定にてoctpathとの連携を許可するかどうかの画面が表示されますので、内容を確認後、許可をクリックしてください。
以上で、Slackとの連携が完了します。
※チャンネル取得が失敗する場合はSlackとの連携が正常に完了していない可能性がございますので、Slack通知設定でチャンネル取得が失敗する場合の対応手順をお試しください。
特定のフローとSlackのチャンネルを接続する
Slackとの連携を許可すると、フローごとに通知送信先のSlackチャンネルを設定できるようになります。設定は接続するフローのオーナーまたは管理者権限のユーザーが可能で以下の手順で実施します。
Slackと連携したいフローの設定画面を開きます。
表示された設定画面から、「通知」タブをクリックし、「Slack通知」をオンにして、通知先チャンネルから連携したいチャンネルを選択します。連携できるチャンネルはフローにつき一つまでになります。
※連携したいチャンネルは「パブリック」チャンネルである必要があります。現在一覧に「プライベート」チャンネルも表示されてしまいますが、今後改修を予定しています。
以上で、フローとSlackチャンネルの連携が完了になります。
Slackとの連携を解除する
連携を解除する場合は、特定のフローごとに接続解除する方法と、チーム全体でSlackの連携を解除する方法の2種類があります。後者については、同時に全フローとSlackの連携も解除されますのでご注意ください。
特定フローとSlackチャンネルの接続を解除する
フロー単位での接続を解除する場合も接続時と同様にフローのオーナーまたは管理者権限のユーザーが解除可能です。以下の手順で実施します。
フローの設定画面を開きます。
表示された設定画面から、「通知」タブをクリックし、「スラック通知」をオフにすれば、接続が解除されます。
Slackとoctpathの連携を解除する
octpathとSlack自体の連携を解除する場合は以下の手順で設定を実施してください。連携時同様、「アプリ連携」はチームのオーナー権限を持つユーザーしかアクセスできません。
※これにより、各フローに設定されているslackチャンネルの接続も全て解除されるのでご注意ください。
octpathにログイン後、画面左側の設定ボタンをクリックして、「アプリ連携」からSlackのアイコンをクリックします。
Slackと連携されている場合は「連携を解除する」のボタンが表示されますので、クリックすることで連携が解除されます。
Slackからoctpathアプリケーションを削除する
octpathとSlackの連携を完全に解除するには、Slackのアプリ管理画面からoctpathアプリをアンインストールする必要があります。
アプリの削除手順については、以下のSlackヘルプセンター記事をご参照ください。
ワークスペースからアプリとカスタムインテグレーションを削除する
Slack通知設定でチャンネル取得が失敗する場合の対応手順
octpathとSlackの連携に問題が発生、もしくは連携先Slackチャンネル数が非常に多い場合、取得に60秒以上要します。60秒経過しても取得しきれない場合は以下のチャンネルID入力画面が表示されます。
表示されるケースごとに以下の手順をお試しください。
・Slack通知をオンにした際に、チャンネルID入力画面が表示された場合
チャンネルの一覧取得に失敗した場合、チャンネルIDを入力する方法で設定することができます。
1.SlackアプリからチャンネルIDを取得する
Slackアプリ上で、チャンネルを右クリック＞チャンネル詳細を表示する＞チャンネル情報タブ
チャンネルIDが記載されていますのでコピーアイコンからコピーしてください。
2.octpathのチャンネルID入力画面にチャンネルIDを入力
チャンネルIDを入力し、インプット外をクリックするとチャンネル名が自動で入力されます。
チャンネル名は任意の名前に編集することも可能です。
3.「有効にする」ボタンをクリック
4.通知先チャンネルに設定されます
・Slack通知がオンの状態で通知タブを開いた際に、チャンネルID入力画面が表示された場合
1.設定済みのチャンネルIDとチャンネル名が入力された状態で、チャンネルID入力画面が表示されます
2.チャンネルIDとチャンネル名を編集し、「変更を保存する」ボタンをクリック
3.通知先チャンネルが変更されます
上記方法で取得できなかった場合
- Slackとoctpathの連携を解除する
- Slackからoctpathアプリケーションを削除する
- Slackとoctpathの連携を許可する
※連携を解除すると、フロー毎に設定したSlackへの通知設定も全て解除されますので、ご注意ください。