> For the complete documentation index, see [llms.txt](https://guide.sphericaldefence.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.sphericaldefence.com/guide/integrations/slack.md).

# Slack

This page documents how you can integrate Slack with a Spherical CloudFormation stack.

Spherical integrates nicely with Slack using AWS, and can stream alerts directly to a channel of your choice. The following steps need to happen *before* starting a Spherical instance.

To start test driving Spherical with Slack, go onto your Slack dashboard [here](https://api.slack.com/apps) and create a new Slack App. This app will be configured to interact with a Spherical instance.

![](https://726634092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lu2R1YRoZxfOod-DWOM%2F-LuIkNyf-eGn9iOVlI-7%2F-LuImD8xWSXI6Ae-wM5L%2Fimage.png?alt=media\&token=9343ad90-3479-42ef-87b2-91e9788288a1)

Once you have created the app, go on to the *Incoming Webhooks* link on your sidebar and activate incoming web-hooks.

![](https://726634092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lu2R1YRoZxfOod-DWOM%2F-LuIkNyf-eGn9iOVlI-7%2F-LuImH7Cbdg8yYl6Ky90%2Fimage.png?alt=media\&token=3ce76c1e-793e-479d-a734-b658e86cf281)

Once activated, click ‘*Add New Webhook to workspace*’, and copy the resultant web-hook URL.

![](https://726634092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lu2R1YRoZxfOod-DWOM%2F-LuIkNyf-eGn9iOVlI-7%2F-LuImMwMBGXZ91WdUQLY%2Fimage.png?alt=media\&token=355abc90-c625-4c9f-b2cf-9c89f882da34)

Once you have the web-hook to your Slack app, launch the Spherical stack on AWS using the CloudFormation button. 

Add the above web-hook url to the **SlackWebhook** parameter.