Skip to main content

Slack

Message a Bot from Slack to draft a checklist, look up Gravity Rail documentation, or work through a question in a channel thread. Each Slack app installation connects to one Gravity Rail Organization and one Bot.

Use Connect to Slack for the shared Gravity Rail app during initial setup. After setup, open Connections in your Bot’s Settings to choose a Slack workspace. The signed-in Slack install page also shows workspace choices. Use Connect if it is available, or Use this Bot instead to review a switch from another Bot. An Organization administrator can select Disconnect to free that installation for another Bot. It removes everyone’s account links for that Bot. To add another app, open Organization Connections.

  1. Sign in to Gravity Rail with your own account. In the Organization menu, open Bots and select your Bot.
  2. Select the Bot’s name above the Chat to open the sidebar. Under Connections, select Connect beside Slack. An organization admin does this first if the Organization has no installed Slack app.
  3. On Slack’s consent screen, choose your team’s Slack workspace. Check which Slack account you are using, then allow the connection.
  4. If Gravity Rail asks you to review a switch, confirm the new Bot before sending a message. After the connection succeeds, choose Open DM in Slack to message the Bot in the workspace you just connected. If Slack shows the app page, choose Messages. Use View Chat to open the Gravity Rail transcript.

Each teammate repeats these steps from their own Gravity Rail account. The Slack row in the Bot sidebar shows Connected when their account is linked.

An organization admin can review app approval and linked people under Organization Connections.

Switch to another Bot​

  1. Open the destination Bot and connect it to the same Slack workspace.
  2. Review the change in Gravity Rail and confirm it. An administrator needs access to both Organizations when a switch crosses Organizations.
  3. Link your account to the new Bot and send a new Slack message outside an earlier thread. Ask teammates to link their own accounts.

Earlier messages remain visible to their original audience. The new Bot starts with new messages. Review access to protected information before sending it.

Try a direct message​

Open the connected app in Slack and send a direct message:

Draft a checklist for reviewing an appointment reminder Workflow before launch. Use Gravity Rail documentation and include links for the reviewer.

Continue in the same Slack conversation. For example, ask the Bot to shorten the checklist to three items or turn it into a draft for your team to review.

Ask in a channel thread​

  1. Add the connected app to a channel where your team wants to work with it. An organization admin can review the Bot's channels under Organization Connections.
  2. In a post or thread, @mention the app and give it a clear task. For example: “From the notes in this thread, list the decisions we made and the questions we still need to answer.”
  3. Check the same thread for the reply. @mention the app again when asking a follow-up unless your administrator has configured the Bot to respond to follow-ups there.

A channel response is visible to that channel's audience. For work that uses protected Workspace information, use an approved direct message or open the Bot in Gravity Rail. App approval and approval of your linked account are separate from your Workspace access.