Slack tools
The 12 Slack operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- 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.
- List usersGETLists the members of the workspace with id, name, real_name and profile.email, including bots (is_bot) and deactivated members (deleted). The response has members and response_metadata.next_cursor: pass it as cursor to read the next page.
- Get user by emailGETReturns the member of the workspace who has this email address, with their id, to mention, invite or message them.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
