mattermost / mattermost/mattermost-developer-documentation
Bot accounts for inbound webhooks
Open
Nobody has claimed this yet.
- Dominant language
- CSS
- Stars
- 90
- Forks
- 460
- Avg merge
- 9d 23h
- Merged PRs (30d)
- 2
Description
Customers ask why bots are needed for inbound webhooks and our developer documentation isn't clear and prescriptive in this area.
Key clarifications to focus on:
- It's not clear that the bot runs as the user that created it.
- It's not clear that if the user gets deactivated, the webhook is effectively deactivated, too
- There don't seem to be any recommendations about which user think should run them and why
- There's no talk about how to setup bot accounts to be the users for inbound webhooks
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the developer documentation covering inbound webhooks, bot accounts, user deactivation, and setup guidance. Review the existing explanations and add prescriptive guidance covering bot identity, deactivation effects, recommended account ownership, and setup steps; the issue is done when all four questions are clearly answered.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100