Put it to work

Slack channel

Let your own team ask the agent inside your Slack workspace — DMs and @-mentions.

The Slack channel points the agent inward: your team DMs the bot (or @-mentions it in a channel) and gets instant answers from everything the agent knows — policies, pricing, product details. New teammates stop asking "where's the doc for…?".

1. Create the Slack app

  1. Go to api.slack.com/apps → Create New App → From scratch, name it (e.g. your agent's name) and pick your workspace.
  2. Under OAuth & Permissions → Scopes → Bot Token Scopes add: app_mentions:read, im:history, chat:write.
  3. Press Install to Workspace and approve. Copy the Bot User OAuth Token (starts with xoxb-).
  4. Under Basic Information → App Credentials copy the Signing Secret.

2. Connect it in Kelma

On your agent's Channels tab (under Messaging channels), open Slack, paste the token and signing secret, and press Connect — Kelma validates the token immediately and shows which workspace it's installed in.

3. Point Slack at Kelma

Back in your Slack app settings: Event Subscriptions → Enable Events, paste the Event Request URL from the Kelma panel (it verifies instantly), then under Subscribe to bot events add message.im and app_mention, and Save Changes.

That's it. DM the bot, or invite it to a channel (/invite @yourbot) and mention it — replies to mentions land in a thread. These conversations appear in your inbox on the Slack channel, and count towards your plan like any other messages.

The Slack channel (the agent answering) and Slack team alerts (pings when a visitor needs a human) are separate — you can use either or both.

Slack channel · Kelma Docs · Kelma