For the complete documentation index, see llms.txt
Skip to main content

Slack integration

Connect your Biel.ai project to Slack and let users interact with your documentation bot from any channel or direct message.

Slack Integration

What you can do​

  • Answer questions in channels: users mention @Biel.ai and get an answer in a thread.
  • Per-thread context: each thread has its own conversation history.
  • Direct message support: users chat with the bot privately.
  • Reset the conversation: use /clear to reset context.

Prerequisites​

  • A Biel.ai account with at least one project and indexed documentation.
  • A Slack workspace where you have permission to install apps.
  • Admin access to your Biel.ai dashboard.

Setup​

1. Connect your Slack workspace​

  1. In the Biel.ai dashboard, open the project you want to connect.
  2. Go to Settings → Integrations in the left sidebar.
  3. On the Slack card, click Connect.
  4. You will be redirected to Slack's authorization screen. Review the permissions and click Allow.
  5. Once authorized, Slack redirects back to Biel.ai and the workspace is connected.

2. Invite the bot to a channel​

After connecting, invite the bot to any channel where you want it to respond:

/invite @Biel.ai

For direct messages, users can find the bot by searching its name in the Slack search bar.

Usage​

Asking questions​

In a channel, mention the bot followed by your question:

@Biel.ai how do I authenticate with the API?

The bot replies in a thread anchored to your message. To ask a follow-up with the same context, mention @Biel.ai again inside that thread, and Biel uses the thread's history. Mentions from the channel root always start a new thread with fresh context.

In a direct message, send your message directly, no mention needed:

What are the system requirements?

Starting a new conversation​

Run /clear to reset context. The scope depends on where you run it:

Where you run /clearWhat it clears
Inside a threadThe current thread only
In the channel rootEvery thread in that channel
In a DMThe DM conversation

The next message after clearing starts a fresh conversation.

Not getting answers?

Make sure your Biel.ai project has indexed content. You can check this from the Sources tab in your project settings.

Troubleshooting​

The bot does not respond to mentions

Make sure the bot has been invited to the channel with /invite @Biel.ai. The bot can only see messages in channels it has been added to.

The /clear command doesn't appear

Slack can take a few seconds to register slash commands after the bot is installed. Wait a moment and try again. If it still doesn't appear, reload Slack.

The bot gives incorrect or outdated answers

Re-index your documentation in the Biel.ai dashboard to make sure the bot is querying the latest content.

Need help? Contact us or visit the support page.