[Docs] Add Slack 60-second quickstart - #1616
Conversation
![roomote-community[bot]](https://avatars.githubusercontent.com/u/211522643?s=60&v=4){kind=small}
| description: Start a Roomote task from Slack and steer the cloud agent from the same thread. | ||
| --- | ||
|
|
||
| Once your admin has connected Roomote to Slack, you can start agent work from |
There was a problem hiding this comment.
A Slack workspace connection is not enough for a user to start a task. The event handler looks up the user's Slack mapping and sends unmapped users to the account-connection flow before it reaches task routing. Add the linked-account/sign-in prerequisite (or explain the prompt users will receive), otherwise first-time users cannot complete this quickstart.
| <Steps> | ||
| <Step title="Invite Roomote to a channel"> | ||
| In Slack, open the channel where you want to use Roomote and invite the bot. | ||
| You can type `/invite @Roomote` or add it from the channel's integrations. |
There was a problem hiding this comment.
The installed Slack app can have a custom display name; setup records that name specifically so user guidance does not have to assume @Roomote. Every literal mention on this page, including /invite and the examples, will fail in those deployments. Use a placeholder such as @<your Roomote app> and tell users to select the installed app instead.
1 participant
What changed
Why this change was made
New users need an immediate, plain-language explanation of how Roomote works in Slack before they encounter administrator setup details. The quickstart makes the everyday workflow and the lack of local setup clear at the start of the docs journey.
Impact
Slack users can understand and try Roomote's core workflow in about a minute, while administrators can still follow the existing detailed Slack configuration guide.
Screenshots