Chapter 7 · Rally outside the app / 7.1
Rally in Slack
Install Rally in your Slack workspace, link your account, and let your Sidekicks listen and post there.
If your team lives in Slack, your Sidekicks can work there too. Once Rally is installed, a Sidekick can watch Slack channels for the messages it cares about, post its results where your team already looks, and pick up replies in the Slack thread under its message. Rally in a Canvas can also search and read Slack for you.
Before you start
Two things have to happen, once each.
An owner or administrator installs Rally in Slack. This is the Connect for organization button on the Slack card in Settings → Connections, and the Slack page in chapter 5 walks through it. It needs a paid Slack plan, and one Slack workspace connects to one Rally Organization. After the install, your Slack workspace has a new member: a bot called Rally.
Each person links their Slack account to their Rally account. This is how Rally knows that the Slack person replying to a Sidekick is you, and where to send the direct messages your Sidekicks write to you.
Linking your Slack account with Connect Rally
- In Slack, open the Rally app (under Apps in Slack's sidebar) and go to its Home tab.
- Click the green Connect Rally button.
- A pop-up called Connect Rally appears. Click Open Rally.
- Your browser opens a page headed Continue in the Rally app. Click Open Rally, and the Rally desktop app opens and finishes the link. You need to be signed in there to the Organization that installed Rally in Slack.
Important
For now, this one step needs the desktop app. The web app cannot finish the link yet. You only do it once per Slack workspace, and everything else on this page works in the browser.
Rally may then carry straight on and ask you to approve your own Slack connection as well. That part is optional and is explained on the next page.
A few things about the link:
- It works once and expires after 15 minutes. If it has expired, or you clicked it twice, click Connect Rally again for a fresh one. Each new link retires the old ones.
- Your Rally account must belong to the Organization that installed Rally in Slack. If you are signed in to a different one, the link is refused.
- If Rally says the installation has been disabled, clicking again will not help. A Rally owner or administrator has to reconnect Slack in Settings → Connections.
- Linking is per Slack workspace. If you belong to two Slack workspaces that both have Rally, you link twice.
Without linking, a Sidekick cannot send you a direct message, and a reply you write under a Sidekick's message is credited to your Slack name rather than your Rally account.
What Rally does in Slack
Rally in Slack works through your Sidekicks. Mentioning @Rally in a Slack channel or sending it a direct message does not start a conversation in Rally by itself. Instead:
- A Sidekick can listen. Give a Sidekick a Slack trigger ("whenever someone posts in #support", "when Rally is mentioned in #incidents") and each matching message starts a run. See Triggers and schedules.
- A Sidekick can post. A run can send its results to a Slack channel, or to you as a direct message from the Rally bot. See Where a Sidekick's results go.
- People can reply. Reply in the Slack thread under a Sidekick's message and the same run carries on with your reply, as the next page explains.
- Rally can use Slack as a tool. In a Canvas or a Sidekick run, Rally can search, read and post in Slack, within what the bot or your own connection can see.
If your team got used to mentioning @Rally in a channel to hand it a job, make a Sidekick that watches that channel for mentions. It does the same job, and everyone it is shared with can see its runs in one place.
Watching a Sidekick work
When a Sidekick is working on a Slack message, Rally does not type its answer word by word. It puts a single emoji on the message, and changes it as the work moves along.
| Emoji | Meaning |
|---|---|
Eyes (:eyes:) | Rally has picked up the message. |
| Brain, magnifying glass, writing hand and gear, taking turns | The run is working. |
Green tick (:white_check_mark:) | Done. The answer is in the thread. |
Question mark (:question:) | The run needs input. |
Warning sign (:warning:) | The run failed. |
Stop sign (:octagonal_sign:) | The run was stopped, or the Sidekick is paused. |
Rally keeps one of its own emoji on a message at a time, and it never touches yours. It is, in effect, a tiny progress bar that went to art school.
When the answer is ready, Rally posts it in the thread in one go. A long answer is split over several messages, breaking between paragraphs and keeping code blocks whole. A note under it reminds everyone that the answer was generated by AI, so check important facts and actions before relying on them. The same run also appears as a row in the Sidekick's conversation in Rally.
The Home tab
Rally's Home tab in Slack is your own small corner of Rally in Slack.
- Before you link, it says Meet Rally, with the Connect Rally button.
- After you link, it welcomes you by name and lists your Sidekicks with their next run time.
- Owners and administrators also see a Workspace administration card showing whether the Slack connection is healthy, with a Manage button that opens Settings → Connections in Rally.
Note
The Home tab may still use the old word: an "automation" there is a Sidekick.
Inviting Rally into a Slack channel
Rally's bot does not wander into Slack channels on its own. For a Sidekick to
read or post in a private channel, invite the bot first, with /invite @Rally
or from the channel's settings (Integrations → Add apps). When a Sidekick
watches a public channel, the bot joins it by itself so it can hear what is
said there.
Inviting the bot creates nothing in Rally. It only lets your Sidekicks, and Rally in your Canvases, see and post in that channel.
When a Sidekick goes quiet in Slack
Work through this list:
- Open Settings → Connections in Rally and find the Slack row.
- If its status says Reconnect required, ask an owner or administrator to click Refresh and approve Rally in Slack again.
- Open Rally's Home tab in Slack and check that your account is linked.
- Open the Sidekick in Rally and check that it is Active, that its latest run row did not fail or ask for input, and that the bot is in the channel it should read or post in.
There is a public overview of all this at rallywith.ai/slack. Send it to a Slack administrator who wants to know what they are agreeing to. Its Open Connections in Rally button opens the right screen in Rally.