Document owner | |
|---|---|
Designer | |
Tech lead | |
Technical writers | |
QA | |
OKR | Continue to add high priority business improvements for enterprise customers. |
Request (CR) | |
Request (other) | |
Design Spec | |
Technical Spec | |
Test Plan |
Objective
Group objects (whether native or AD/LDAP) are valuable as referenced objects in communication. Groups of people, whether departments, roles, owners, etc. can be needed in a discussion or channel for collaboration purposes. This feature aims to provide that value by enabling group mentions/invites on a per group basis (opt-in).
Background
Groups exists via AD/LDAP sync and native, self-defined MM groups are being considered as a standalone feature. Referencing these groups for purposes of at-mentions and invites of users is demanded and expected by MM users and administrators.
There is currently a plugin that was built to accomplish several of the user scenarios: https://github.com/mattermost/mattermost-plugin-autolink
Success metrics
Goal | Metric |
|---|---|
Build a useful feature that enables messaging and inviting groups of users with a single command |
|
User Scenarios
Members (not guests) of any channel can @mention groups of users (e.g. @infosec or @finance)
Members (not guests) can /invite any of those same groups
Members want to mention users in a specific channel that are also in a specific group
Admins can choose which groups are available to be referenced
Members can manage notifications for groups mentions (TBD)
Admins can restrict disabling of notifications (TBD)
Assumptions
Phases & Milestones
Areas Touched
Permissions
System Console UI (Channel Configuration page and permissions)
Chat-facing UI
Groups
Desktop/Mobile Apps
Requirements
Requirement | User Story | Importance | Jira Issue | |
|---|---|---|---|---|
| 1 | new permission to group mention - off for guests | |||
| 2 | add group section to autocomplete and add slugs | |||
| 3 | if 2 groups of same name, with group mentions enabled we notify everyone in both groups | |||
| 4 | ||||
| 5 | Allow members to @mention groups by their group name (slug is auto-generated) | As a user, I want the ability to @mention entire groups and push a notification to that group | HIGH | |
| 6 | Add group names to autocomplete suggestions on invite and mention screens | As a user, I want automated suggestions for groups as a type so that I can more easily find the group I am looking to reference | MEDIUM | |
| 7 | Ability for admins to turn on/off @mentions for specified groups (off by default) | As an admin, I want the ability to toggle the above setting on and off for each group | MEDIUM | |
| 8 | If within a group constrained team or channel, auto-complete only shows groups that are available in that team or channel | LOW | ||
| 9 | confirmation modal before sending to x number of users (add to setting for @mentioning groups) | LOW | ||
| 10 | system message notifying user that some users were not members of the channel with option to invite |
Open Questions
Question | Answer | Date Answered |
|---|---|---|
Does it make sense to allow role @mentions or invites? Such as @system admin or @moderator, etc? | ||
How do we prevent disruptive invitations to a channel when attempting to mention users? |
Risks
disruptive invitations to a channel when attempting to mention users
security issue if we reveal users in specific groups
Out of Scope
secret groups - groups that can be mentioned only and if no one from the group is in the channel, nothing happens (potentially with preview before joining)
ignore group mentions at channel level
remove add/invite people to channel modal
show group mentions in Recent mentions
Dup detection of group slugs
Ability for users to mute or turn off notifications from group mentions
Ability for admins to restrict disabling of notifications for specific groups
Allow members to /invite groups by their group name