Skip to content

Latest commit

 

History

History
57 lines (27 loc) · 4.63 KB

index_getting_started.md

File metadata and controls

57 lines (27 loc) · 4.63 KB

The Slack API is made up of several different tools that enable you to build different kinds of Slack apps. In this guide, we'll cover the most common scenarios that products and services are building with Slack APIs. We'll also offer our best advice about how to save a bit of time and build the best possible Slack app for your needs.


Which API tools should I use?

Well, it depends! Our API tools let you extend Slack to play nicely with your team's workflow, external services, and other applications. But how do you figure out where to start, and which Slack APIs are best for you? You've come to the right place. Let us guide you through some examples that will help you pick the right tools for each job.

I want to post messages, links, images, and other content in Slack

Do you want a really powerful way to inform your users when something important happens in your product or service? Let your users subscribe to them in Slack!

Maybe you're a newsletter service that sends notifications to publishers when a new person signs up for their mailing list, or you're an e-commerce service and want to let your users receive an hourly summary of sales from their online store.

Best way to do this: With an incoming webhook. They're the simplest way to programmatically send messages into Slack. Simply send a JSON payload containing your message content to a pre-configured incoming webhook URL that your users set up for you, and Slack will turn it into a message for the right team, in the right channel. For more information and some examples, read our incoming webhook documentation.

Screenshot of messages posted via incoming webhooks

I want to enable users to interact with my product from Slack

Let's say you have a dictionary tool, or a bug tracker, or a task management app, and you'd like your users to interact with it from within Slack.

For example, you'd like a way for users to type /todo list to get a list of tasks assigned to them, or /todo add Finish writing API guide to create a new task for themselves. Throw in a username to assign the task to one of your teammates — /todo for @mattMake some graphics for the API guide.

Best way to do this: Set up a slash command. This will let your users make queries or trigger external actions right from within Slack.

Screenshot of a slash command

I want to build a real-time conversational bot

Lots of people are very excited about building bots these days. Bots allow you to create a conversational interface with any external service. It's not easy, but it's fun. To do this, create a bot user to connect to Slack and post messages, along with many other APIs.

Screenshot of a bot discussion


Get news about future API updates

These are just a few of the many different kinds of apps that you can build on top of Slack. For more ideas, follow @SlackAPI on Twitter or read our collection of Slack App-related articles on Flipboard.

To learn about future enhancements to our APIs, register as an API developer, tell us a bit about yourself and the things you'd like to build, and we'll make sure you're the first to know about all the exciting things happening in the future.

Register as a Developer


Become an "official" integration

All of our official integrations go through a review process, whether they were developed in-house or by the third-party service. This process is currently a bit bottlenecked on our side, as we can only work on a handful of new integrations at a time. The good news is that we're making some changes to our integration platform that will give developers the ability to better manage and distribute their integrations in Slack, and to let our team review and approve them more quickly.

In the meantime, we recommend exploring our API tools to determine the type of integration you would like to build. Once you've got the hang of things and validated that the integration is useful for you and your users on Slack, tell us about your integration and we'll add you to our queue.

If you have questions not covered by this guide, or there's anything else you'd like to let us know about, you can contact us at [email protected].