Slack
Slack と一度連携すれば、各アプリは管理者が選んだチャンネルに投稿し、一人ひとりは受け取りたいダイレクトメッセージを受け取れます。
Taktoria で Slack ができること
Slack はここで 3 つのことを行います。
- チャンネルへの投稿:各アプリは、ローンチの公開やミームの作成など、そのアプリで起きたことを、管理者が選んだ公開チャンネルに投稿します。投稿の種類ごとにチャンネルを選ぶことも、投稿しないこともできます。
- ダイレクトメッセージ:自分に割り当てられたレビューなど、自分に関わることを、メールに加えて、またはメールの代わりに Slack で受け取れます。
- コマンド:ワークスペースの誰でも、Slack で
/launchcal、/dory、/golinks、/memegenを本人として入力でき、チャンネルに何かが届く前に、自分だけに見えるプレビューが表示されます。Slack コマンド を参照してください。
ワークスペースのオーナーか管理者が、すべてのアプリのために Slack と一度連携します。Taktoria が Slack に求める権限は、メッセージの投稿、招待されずに公開チャンネルへ投稿すること、公開チャンネルの一覧の取得、メールアドレスでの人の検索、そしてコマンドの追加です。チャンネルやメッセージを読むことはできません。
チャンネルへの投稿は、ワークスペースのメンバーが最も多く使っている言語で書かれます。ダイレクトメッセージは、受け取る人の言語で書かれます。
Slack と連携する
Slack と連携できるのは、ワークスペースのオーナーか管理者だけです。
- 設定 → 連携を開きます。
- Slackの下でSlack と連携を選択します。
- Slack で、求められたら Slack のワークスペースを選び、許可します。
- Taktoria に戻ると、カードにどの Slack と連携したかが表示され、アプリごとにオンになっている投稿の数が一覧で表示されます。
この時点ではまだ何も投稿されません。次に、各アプリの管理者がチャンネルを選びます。試行の期限が切れた、または別のワークスペースで始まったと Slack に表示された場合は、もう一度Slack と連携を選択してください。
各アプリの投稿先を選ぶ
各アプリの投稿先は、そのアプリの管理者(ワークスペースのオーナーと管理者、そしてそのアプリの管理者になった人)が選びます。
- アプリを開き、サイドバーの一番下にある管理でSlackを選択します。設定 → 連携からも各アプリのページに移動できます。
- 投稿の種類ごとに行があります。チャンネル名の一部を入力して選択します。Slack にチャンネルがいくつあっても見つけられます。選んだチャンネルの横の × を押すと、その種類はオフに戻ります。
- すべての種類がオフのときにチャンネルを選ぶと、すべての種類にそのチャンネルが選ばれます。ただし件数の多いもの(チェックインと、go リンクのリンク先の変更)は、チャンネルを選ぶまでオフのままです。
候補は公開チャンネルだけです。Taktoria は招待されなくても公開チャンネルに投稿できるため、非公開チャンネルは表示されません。選んだチャンネルがその後アーカイブされたり非公開になったりした場合は、一覧にないと表示されるので、別のチャンネルを選んでください。Slack からチャンネルの一覧が届かない場合は、代わりに各チャンネルの ID を入力するよう求められます。ID は Slack のチャンネル詳細の一番下にあります。
変更はすべて監査ログに記録されます。
各アプリが投稿する内容
- LaunchCal:ローンチが追加されたとき(オーナー、チーム、ステータス、予定日付き)、レビュー担当が判断したとき、ローンチの日付が変わったとき(変更前と変更後)、ローンチが公開されたとき、そして今後のローンチ(毎週):毎週月曜の朝に、今後 30 日間に予定されているローンチ。
- OKR ハブ:目標が追加されたとき(公開された時点)、主要な成果がチェックインされたとき(メモ付き)、四半期の折り返し:目標の数、平均スコア、2 週間チェックインのない主要な成果、そして四半期の終了:次の四半期の最初の週に、平均とスコアの高い上位 3 つの目標。
- Dory:イベントが予定されたとき(参加コードとリンク付き)、イベントが始まったとき(主催者が開始したとき、または開始時刻になったとき)、そしてイベントの結果(終了時):参加者、寄せられた質問と回答された質問、上位の質問。
- Go リンク:Go リンクが公開されたとき(リンク先と用途付き)、そしてGo リンクのリンク先が変わったとき(変更前と変更後)。
- Memegen:ミームが作られたとき。画像だけを、30 日間有効なリンク経由で投稿します。画像をキャプションで説明するをオンにすると、Slack のスクリーンリーダーがキャプションを読み上げます。オフのときは説明なしで投稿します。
四半期は、ワークスペースの会計四半期です。
決して投稿しないもの
チャンネルに投稿されるのは、ワークスペースのメンバー全員が見られるものだけです。
- 下書きは投稿しません。ローンチ、目標、go リンクは公開された時点で投稿されます。
- 非公開の目標は投稿しません。一括で取り込んだ目標は 1 つずつは投稿しません。
- 特定のメールドメインの人向けの Dory のイベントは投稿しません。そのタイトルは、入れる人だけのものです。イベントのパスコードも投稿せず、パスコード付きのイベントの結果からは質問を除きます。
- 非公開チャンネルには投稿せず、ダイレクトメッセージを代わりにチャンネルに送ることもありません。
ダイレクトメッセージ
ダイレクトメッセージは宛先の本人に届きます。Slack のアカウントとはメールアドレスで照合されるため、Slack のアカウントでは Taktoria で使っているのと同じアドレスを使う必要があります。一致しない場合、ほかの誰かに送られることはありません。
- LaunchCal で自分に割り当てられたレビューと、そのリマインドは必ず届きます。
- それ以外はアカウント → プロフィール → 通知で選べます。種類ごとにメールとSlackのチェックボックスがあり、ローンチ承認のリマインダー、ローンチの更新、ローンチ日のリマインダー、予定日を過ぎたローンチ、OKR 評価のリマインダー、OKR 中間チェックイン、Dory のまとめ、Dory 主催者向けリマインダーなどがあります。製品のヒントはメールのみです。
Slackのチェックボックスは、管理者がいずれかのワークスペースで Slack と連携すると表示されます。
連携を解除する
設定 → 連携で、ワークスペースのオーナーか管理者が Slack のカードの連携を解除を選択します。チャンネルへの投稿とダイレクトメッセージはすべてすぐに止まります。各アプリの管理者が選んだチャンネルは保持されるので、同じ Slack ともう一度連携すれば、そのまま再開します。
Taktoria を Slack から完全に削除するには、Slack のワークスペースの設定からもアプリを削除してください。
トラブルシューティング
- 何も投稿されない:アプリのSlackページを開いてください。オフになっている種類は何も投稿しません。また、投稿されるのはチャンネルを選んだあとに起きたことだけです。
- チャンネルが一覧にない:一覧に出るのは公開チャンネルだけです。公開にするか、別のチャンネルを選んでください。
- Slack と連携していないと表示される:ワークスペースのオーナーか管理者が設定 → 連携で連携します。
- ダイレクトメッセージが届かない人がいる:Slack のアカウントのメールアドレスが Taktoria で使っているものと同じで、通知設定のSlackでその種類にチェックが入っている必要があります。
- 連携に失敗した、または期限が切れた:連携したい Taktoria のワークスペースから、もう一度Slack と連携を選択してください。