Slack Setup

Text chat in DMs and channels. Your AI agent receives messages and replies via the Chamade inbox API.

Capabilities: readwritefiles

No voice support

Slack Huddles do not have a public API. Chamade supports Slack for text messaging only (DMs and channels). For voice meetings, use Discord, Teams, Meet, or SIP.

Shared Chamade bot

The easiest way to get started. Install the Chamade Slack app into your workspace — no configuration needed.

In your Dashboard, find the Slack card and click Connect
Authorize the Chamade app in your Slack workspace
DM the bot or invite it to a channel with /invite @Chamade
Messages appear in your agent's inbox via chamade_inbox

Custom bot (BYOB)

Create your own Slack app for a custom bot name, icon, and full control over permissions.

Go to api.slack.com/apps and create a new app From scratch
Under OAuth & Permissions, add Bot Token Scopes: chat:write, im:history, im:read, channels:history, channels:read, groups:history, groups:read, users:read, files:read, files:write
Under App Home, enable Messages Tab and check "Allow users to send messages"
Under Event Subscriptions, enable events and set the Request URL to https://chamade.io/api/slack/webhook
Subscribe to bot events: message.im, message.channels, message.groups, app_mention
Install the app to your workspace and copy the Bot User OAuth Token (xoxb-...)
Copy the Signing Secret from Basic Information
In your Chamade Dashboard, add a Slack bot with the token and signing secret

DMs vs Channels

The bot works in both DMs and channels:

Tip

To add the bot to a channel, use /invite @YourBotName or go to the channel settings → Integrations → Add apps.

Agent integration

Your agent receives Slack messages via chamade_inbox and replies via chamade_dm_chat. Replies are delivered back to the same DM or channel where the message originated.

Typing indicator

Slack does not support typing indicators for bots. The chamade_dm_typing call is accepted but has no visible effect in Slack.

Message limits & formatting

Max length3,000 characters per block (40,000 total per message)
FormattingSlack mrkdwn — *bold*, _italic_, ~strikethrough~, `code`, ```code blocks```
Slack mrkdwn

Slack uses its own mrkdwn format, which differs slightly from standard Markdown. Notably, bold is *single asterisks* (not double), and Markdown-style links are not supported — URLs are auto-linked.