Communication
Slack in your product and your AI agents, through one API
The Slack toolkit covers the channels, messages, threads and members of a Slack workspace, through the bot of the app installed in it: list, create and join channels, read messages and thread replies, post, schedule, edit and delete the bot's messages, and look up members. Through Connect, your product or AI agent calls these operations with one endpoint, while Connect stores and renews the OAuth credentials and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/slack_create_conversation/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}How it works
From a connected customer to the first Slack call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Slack account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Slack.
Alerts in the customer's channel
When something happens in your product, post a message as the app's bot in the channel the customer chose, and edit it when the status changes.
Scheduled reminders
Schedule a message up to 120 days ahead, and look up a member by email to mention them.
Agent that reads and replies
An AI agent lists the messages of a channel, reads a thread, and replies in it, after joining the channel if needed.
Tools
12 Slack tools
- List conversationsGETLists the channels of the workspace: all public channels and the private channels the app was added to. The id of a channel is the channel argument of the other tools, and is_member tells whether the app is in it. The response has channels and response_metadata.next_cursor: pass it as cursor to read the next page.
- Create conversationPOSTCreates a public or private channel with the app as a member and returns it with its id. Add people to it with Invite members to conversation.
- Join conversationPOSTAdds the app to a public channel and returns the channel. The app must be a member to read the messages of a channel or post in it. A private channel cannot be joined this way: a member adds the app to it in Slack.
- Invite members to conversationPOSTInvites members of the workspace to a channel the app is in. If one of the ids fails, nobody is invited unless force is true.
- List messagesGETLists the messages of a channel the app is a member of, newest first. Thread replies are not included: read them with List thread replies. The response has messages, has_more and response_metadata.next_cursor: pass it as cursor to read the next page. An app installed from outside the Slack Marketplace can be held to 15 messages per call and one call per minute.
- List thread repliesGETLists a thread of a channel the app is a member of: the parent message followed by its replies. The response has messages, has_more and response_metadata.next_cursor: pass it as cursor to read the next page. An app installed from outside the Slack Marketplace can be held to 15 messages per call and one call per minute.
- Send messagePOSTPosts a message as the app's bot and returns it with channel and ts, the pair Update message and Delete message ask for. Send text, markdown_text or blocks. The app must be a member of the channel: call Join conversation first for a public one.
- Schedule messagePOSTSchedules a message from the app's bot for a moment up to 120 days ahead and returns its scheduled_message_id. Send text, markdown_text or blocks. The app must be a member of the channel, and a channel takes at most 30 scheduled messages within the same 5 minutes.
- Update messagePOSTEdits a message the app's bot posted and returns it. Sending text without blocks replaces the blocks of the message with that text; leaving text out keeps them.
- Delete messagePOSTDeletes a message the app's bot posted. Messages of people cannot be deleted with this connection.
OAuth with your product's app
You register your product's OAuth app once, with POST /api/merchants/credentials/slack, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.
Questions about the Slack toolkit
Do I need to build against the Slack API?
No. Connect ships 12 Slack tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Slack account?
With the mode the toolkit accepts: OAuth with your product's app. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
