forked from knative/docs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Notification service docs: Add the tutorial on how to create the slac…
…k workspace (knative#5939) * add tutorial * create workspace docs * Edit img
- Loading branch information
1 parent
5698ba7
commit 0495f68
Showing
5 changed files
with
36 additions
and
0 deletions.
There are no files selected for viewing
36 changes: 36 additions & 0 deletions
36
code-samples/eventing/bookstore-sample-app/create-workspace.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
# Notification Service: Creating a Slack Workspace | ||
|
||
## Create a Slack Workspace | ||
|
||
To create a Slack workspace, follow these steps: | ||
|
||
- Visit [https://slack.com/get-started#/createnew](https://slack.com/get-started#/createnew). | ||
- Enter your email address and click Continue, or continue with Apple or Google. | ||
- Check your email for a confirmation code. | ||
- Enter the code on the Slack website. | ||
- Click "Create a Workspace" and follow the prompts. | ||
- For detailed instructions for androids and , refer to [Create a workspace](https://slack.com/help/articles/206845317-Create-a-Slack-workspace). | ||
|
||
## Adding Channels to Your Workspace | ||
|
||
After creating your Slack workspace, you can add channels by following these steps: | ||
|
||
- Click the '+' icon next to 'Channels' on the sidebar of your Slack workspace. | ||
- Choose "Create a channel" and specify the channel name and purpose. | ||
- For enterprise grid organizations, refer to [Slack's help article](https://slack.com/help/articles/115001399587-Add-a-channel-to-multiple-workspaces-in-your-Enterprise-Grid-organization) for instructions. | ||
|
||
## Setting Up a Webhook for Notifications | ||
|
||
To set up a webhook for sending notifications to your Slack workspace: | ||
|
||
- Create a [Slack app](https://api.slack.com/apps/new), following the instructions by signing in, adding name and workspace to put the app in. | ||
- After this, you'll be redirected to the setting pages of your new app. Choose **Incoming Webhook** and toggle **Activate Webhook**. | ||
- Scroll down to click the option **Add New Webhook to Workspace**. | ||
![Alt text](./screenshots/select-channel.png) | ||
- The page will give you a link associated with the app you created. This link will be where API requests are sent to send messages to your Slack workspace. | ||
![Alt text](./screenshots/webhooklink.png) | ||
- To test if the webhook works as needed, you can try sending an API request to this link to see if the message goes through. I used Postman to test this. Remember that this is an application/json file. | ||
![Alt text](./screenshots/Postman.png) | ||
- Afterwards, the text channel should have a new message | ||
![Alt text](./screenshots/result.png) | ||
- Go to [Slack's webhook documentation](https://api.slack.com/messaging/webhooks) to learn more about setting up webhooks. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+222 KB
code-samples/eventing/bookstore-sample-app/screenshots/select-channel.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+187 KB
code-samples/eventing/bookstore-sample-app/screenshots/webhooklink.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.