Slack API: what you can do and how to use it with AI agents
The Slack API lets you build apps that read and send messages, react to events and interact with users through commands and buttons. Engineering, operations and IT teams use it for internal automations and bots. Access is through apps installed in the workspace with defined OAuth scopes.
What the Slack API offers
Web API
Methods to send and edit messages, list channels, look up users and manage conversations.
Events API
Events sent to the app when something happens, such as a new message, a mention or someone joining a channel.
Interactivity
Buttons, menus, modals and shortcuts the user triggers inside Slack.
Slash commands
Custom commands that trigger actions in the app.
Files
Upload and reading of files shared in channels and direct messages.
How to access the Slack API
- With your company’s credentialsOAuth 2.0: the app is created in the Slack developer portal and installed in the workspace, producing bot or user tokens with specific scopes.
- Methods have rate limits by tier; bulk messages need to be spaced out.
- Ask only for the scopes you need: reading the history of every channel is rarely necessary.
- Messages can contain sensitive data; align with the workspace's retention policy.
Official documentation: api.slack.com
What an iTeam agent does with the Slack API
Internal support agent
The agent answers HR, IT and policy questions in a dedicated channel, citing the internal document it used, and opens a ticket when it does not know.
Incident triage
When monitoring reports an error, the agent opens the incident channel, pages the on-call engineer and summarizes logs and recent deploys.
Button approvals
Purchase, discount or access requests reach the manager as a message with approve and reject buttons, and the result goes back to the source system.
Channel summaries
At the end of the day, the agent summarizes the decisions and open items from project channels for anyone who did not follow along.
From the credential to the agent at work, with approval
Create the app in Slack
Create the app in the Slack portal, set the minimum scopes needed and install it in the workspace with an administrator.
Register the token in iTeam
The bot token goes in the iTeam vault; you choose which channels each agent works in and what it can post.
Turn on events and test
Enable message and mention events, test in a pilot channel and keep human approval for actions outside Slack.
Ready-made AI teams that use Slack
Help desk support team
It reads each ticket, finds the answer in your docs and past replies, and drafts a response your agents can send or improve.
Customer success team
It reads usage, tickets and CRM notes every week and tells your team which accounts need a call, and why.
Customer feedback analysis
It reads every comment, finds the themes behind the scores and tells each area what customers are asking it to fix.
Management reporting team
Revenue, margin, pipeline and cash in one report, built from your systems, with a short note on what changed and why.
Employee HR help desk
Questions about time off, benefits and payslips get a correct answer from your handbook. Sensitive topics go straight to HR.
Performance review team
Feedback and goals are collected as work happens, so the review is written from facts and not from memory.
Questions about the Slack API
Is the Slack API free?
Creating apps and using the API has no separate charge, but some features and limits depend on the workspace plan. Check your company's plan.
Do I need to write code to use the Slack API with iTeam?
No. iTeam already connects to Slack and the deployment team helps create the app, choose scopes and define the channels.
Does the agent read every message in the workspace?
No. It sees only the channels it was added to and the scopes you authorized.
