Skip to main content

Slack

Learn how to connect to Slack, so you can send conversations into Glossa

Written by Ali
Updated over a month ago

Overview

The Slack integration allows you to capture requirements directly from your Slack conversations by tagging @GlossaBot. This enables you to document important discussions, decisions, and requirements as they happen in your team's natural communication flow.

Unlike meeting integrations that automatically process recordings, the Slack integration gives you granular control—only content you explicitly tag with @GlossaBot is sent to Glossa for processing.

How It Works

When you tag @GlossaBot in a Slack message or thread, Glossa captures that content and determines whether it contains actionable requirements. If relevant requirements are identified, Glossa automatically creates them in the mapped project with full citations back to the original Slack conversation.

Key benefits:

  • Capture requirements from async discussions

  • Document decisions made in Slack channels

  • Maintain traceability from Slack conversations to requirements

  • Control exactly what content gets processed

Setting Up Slack Integration

Step 1: Enable the Integration

  1. Navigate to Integrations in the main navigation

  2. Find Slack in the list of available integrations

  3. Enable using the slider

  4. Click Connect

Step 2: Authorize Access

You'll be redirected to Slack's authorization page where you'll:

  1. Select your Slack workspace

  2. Review the permissions Glossa is requesting

  3. Click Allow to authorize the connection

After authorization, you'll be redirected back to Glossa.

Step 3: Add GlossaBot to Private Channels (Optional)

GlossaBot can automatically access public channels, but if you want to use it in private channels:

  1. Open the private Slack channel

  2. Type @GlossaBot in the message box and send

  3. Slack will prompt you to invite GlossaBot to the channel

  4. Confirm the invitation

Repeat this for each private channel where you want to use Glossa.

Step 4: Map Channels to Projects

After connecting Slack, you need to map Slack channels to Glossa projects:

  1. Go to Integrations in the main navigation

  2. Click Manage next to Slack

  3. Click Add Channel Mapping

  4. In the modal interface:

    • Select a Slack channel from the dropdown

    • Select a Glossa project to map to that channel

    • Click Add Mapping

  5. Repeat for each channel you want to map

Important notes about channel mapping:

  • Multiple Slack channels can be mapped to one Glossa project

  • Each Slack channel can only be mapped to one project (not multiple projects)

  • Mapped channels also appear on each project's dashboard homepage

Using Slack Integration

Tagging Messages

To send content to Glossa, tag @GlossaBot in your message:

This is important - the client wants automatic lead assignment based on geography @GlossaBot

What happens:

  1. GlossaBot confirms the message has been received (you'll see a response in Slack)

  2. The content is sent to the mapped Glossa project

  3. Glossa analyzes the content for requirements

  4. If relevant requirements are found, they're automatically created

  5. If no relevant requirements are found, nothing is created

  6. The Slack message content is saved in Files section of the project

Tagging Threads

When you tag @GlossaBot in a thread, the entire thread content up to the tag is sent to Glossa:

Thread starter: What should happen when a user uploads a duplicate contact? Reply 1: We should show a warning before creating the duplicate Reply 2: And give them the option to merge with the existing contact Reply 3: Great idea! @GlossaBot

In this example, all three messages would be sent to Glossa as context.

Best practice: Tag @GlossaBot at the end of a discussion thread once the decision or requirement is clear.

File Attachments

If files are attached to a message or thread that you tag with @GlossaBot, those attachments are also sent to Glossa and processed along with the message content.

When Content Gets Processed

Glossa uses AI to determine if tagged content contains actionable requirements:

  • Relevant content: Requirements are automatically created with citations to the Slack message

  • Non-relevant content: No requirements are created (the content is still stored as a source file)

Examples of content that typically generates requirements:

  • Feature requests or functionality descriptions

  • Business rules and logic

  • User needs or pain points

  • Decisions about system behavior

  • Process descriptions

Examples of content that typically doesn't generate requirements:

  • General conversation or pleasantries

  • Scheduling messages

  • Off-topic discussions

  • Questions without answers

Viewing Slack Citations

When requirements are generated from Slack messages:

  1. Open the requirement in Glossa

  2. Navigate to the Reference Data tab

  3. You'll see citation(s) showing:

    • Date the message was posted

    • Who posted the message

    • Message preview text

    • "Open Preview" button

  4. Click Open Preview or the message title to view:

    • The full Slack message or thread

    • Highlighted relevant portions (if applicable)

    • Context from surrounding messages

Citations link directly to the specific Slack message, giving you instant context and traceability.

Managing Channel Mappings

Viewing Current Mappings

To see which channels are mapped to which projects:

Option 1: From Integrations

  1. Go to Integrations

  2. Click Manage next to Slack

  3. See all channel mappings in the Current Mappings section

Option 2: From Project Dashboard

  1. Open a project

  2. View the project dashboard homepage

  3. Mapped Slack channels are displayed in the Slack Channels section

Changing Mappings

To modify channel mappings:

  1. Go to Integrations

  2. Click Manage next to Slack

  3. Delete the incorrect mapping

  4. Add the corrected mapping by clicking Add Channel Mapping

Unmapping a Channel

To remove a channel mapping:

  1. Go to Integrations

  2. Click Manage next to Slack

  3. Delete the incorrect mapping

Note: Unmapping a channel does not delete requirements or files that were already created from that channel.

Troubleshooting

GlossaBot Doesn't Respond When Tagged

Possible causes:

  • GlossaBot hasn't been added to the private channel

  • The channel isn't mapped to any project

  • Slack integration has been disconnected

Solutions:

  1. Verify the channel is mapped to a project (Integrations → Slack)

  2. For private channels, ensure GlossaBot has been invited to the channel

  3. Check that Slack integration is connected (Integrations tab)

  4. Try disconnecting and reconnecting the Slack integration

Note that it sometimes takes a minute for GlossaBot to reply.

No Requirements Created from Tagged Content

This is expected behavior when Glossa determines the tagged content doesn't contain actionable requirements. The content is still stored as a source file in your project.

If you believe requirements should have been generated:

  1. Check the Files tab in your project to confirm the Slack message was captured

  2. Verify the content clearly describes requirements, features, or decisions

  3. Try uploading the content as a manual file or rephrasing the original message

Cannot See Private Channels in Mapping Interface

Private channels only appear in the mapping interface after you've invited GlossaBot to them:

  1. Go to the private channel in Slack

  2. Type @GlossaBot and invite the bot

  3. Return to Glossa → Integrations → Slack

  4. The channel should now appear in the mapping interface

Channel Mapped to Wrong Project

To fix incorrect mappings:

  1. Go to IntegrationsSlackManage Slack Channels

  2. Find the channel in question

  3. Delete the mapping

  4. Add the correct mapping by clicking Add Channel Mapping

Moving a channel to a different project doesn't transfer existing requirements—it only affects future tagged messages.

Best Practices

Be Strategic About What You Tag

Only tag @GlossaBot when:

  • A decision has been made that needs to be documented

  • Requirements or features are being discussed

  • Important context or rationale is being shared

  • You want to capture a thread's conclusion

Avoid tagging:

  • General conversation

  • Questions still under discussion (wait for resolution)

  • Administrative or off-topic messages

Use Thread Tags for Context

When important information is spread across a thread, tag @GlossaBot at the end of the thread rather than on individual messages. This ensures Glossa has the full conversation context.

Map Channels Thoughtfully

Consider mapping:

  • Project-specific Slack channels to their corresponding Glossa projects

  • General product discussion channels to your main product project

  • Client-specific channels to client projects

Avoid:

  • Mapping unrelated channels (social, administrative) to projects

  • Mapping one channel to multiple projects (not supported)

Review Generated Requirements

After tagging important Slack content:

  1. Check the Requirements tab in the mapped project

  2. Review newly created requirements for accuracy

  3. Edit titles, descriptions, or details as needed

  4. Verify citations link to the correct Slack messages

Combine with Other Sources

Slack works best as one of multiple input sources:

  • Tag Slack decisions and follow-up discussions

  • Use meeting integrations for discovery sessions

  • Upload formal documentation

  • Add email threads with client requirements

Glossa will automatically detect contradictions across all these sources.

Limitations

  • One project per channel: Each Slack channel can only be mapped to one Glossa project

  • Tag required: Unlike meeting integrations, Slack content is not automatically processed—you must tag @GlossaBot

  • Private channel access: GlossaBot must be explicitly invited to private channels

  • No DM support: Slack DMs are not currently supported

  • No Canvas support: Slack Canvases are not currently supported

  • No retroactive processing: Only messages tagged after setup are processed (historical messages are not automatically captured)

Did this answer your question?