やりたいこと

Hubotから @usergroup でユーザグループに通知を飛ばしたい。

ユーザグループとは？

特定のチャンネルの全員ではなく、特定の人に通知をしたい場合に使える機能。
グループに参加すると特定のチャンネルにjoinさせることもできる。

チャンネルはトピックごとに参加者がいる（例えば開発チャンネルには開発に関わる全ての人がいるはず）。そのうちの一部（例えばインフラエンジニア）だけに通知したいとか。
新入社員が1000個あるチャンネルから必須チャンネル10個とかを登録してもらうとかめんどくさい。グループにjoinしてもらうと一括で必須チャンネルに登録できる。

以下のドキュメントに方法が書いてある。
Message Formatting | Slack

For paid teams

とあるように、有料で使っていないとできない。

usergroups.list APIを使って通知したいグループのIDを取得する。
ドキュメント：usergroups.list method | Slack

<!subteam^ID|handle>の項目を埋めていく。

"<!subteam^S0*******|mygroup>"

hubot経由で上の文字列をSlackにポストすると、@mygroupとしてグループに通知される。