Slack channel

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. Event Subscriptions → Enable Events, paste the Event Request URL from the Kelma panel (step 2 below — it verifies instantly). Then under Subscribe to bot events add all four: message.im, app_mention, message.channels and message.groups. Adding these events makes Slack request the scopes they need automatically in the next step.
3. Under OAuth & Permissions → Scopes → Bot Token Scopes make sure you have: app_mentions:read, im:history, chat:write, files:read (read screenshots and voice clips), chat:write.customize (post as the agent's own name and avatar), plus channels:history and groups:history (which the events above add for you — so the agent can follow a thread without being re-tagged).
4. Press Install to Workspace and approve. Copy the Bot User OAuth Token (starts with xoxb-).
5. Under Basic Information → App Credentials copy the Signing Secret.

If you add scopes or events later, Slack makes you reinstall the app for them to take effect.

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. (The Event Request URL you need for step 1 is shown right here.)

3. Use it

• DM the bot — just message it directly; replies come straight back, no tagging.
• In a channel — run /invite @yourbot once to add it, then @yourbot your question to start. After that, just keep replying in the thread — no need to re-tag; the agent stays in the conversation. (A bot only receives messages in channels it's a member of, so the one-time invite is required, and it only follows threads it was actually brought into — it won't butt into other conversations.)
• Images & voice — drop a screenshot or a voice clip (with your @-mention or in a DM) and the agent reads/transcribes it and answers.

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.