If you don't want to rely on our pre-built KnowledgeOwl Webhooks Slack app, you can create webhooks to monitor your team's editing activity, or your customers' feedback inside of your Slack account in real time. This involves some set up on the Slack and the KnowledgeOwl side.
Previous versions of these instructions suggested you install the Incoming Webhooks app. Slack has announced deprecation of that app. Please follow the instructions below to create your own Slack app using the Incoming Webhooks functionality, or Use the KnowledgeOwl Webhooks Slack app.
- In a browser, go to https://api.slack.com/apps.
- Click the Create an App button.
- In the Create an app pop-up, select the From scratch option.
- Give your app an App Name. Here, we use KO Webhooks.
- Select the Slack workspace to add the app to.
- Once you've finished making your selections, click the Create App button.
- Optional: Your Slack App will use a default logo of a notebook and ruler when it posts through the webhook and a specific background color. To update that image or background color, you can scroll down the page to the Display Information section to update the App Icon, background color, name, and various descriptions.
- Near the top of the page in the Add features and functionality section, select Incoming Webhooks.
- Once the Incoming Webhooks page opens, toggle the Activate Incoming Webhooks setting to On.
- Scroll down to the Webhook URLs for Your Workspace section and click the Add New Webhook to Workspace button.
- This will prompt you to select a channel to post to in the app within the Slack workspace you selected in Step 5. Choose the channel you'd like the webhooks to post to and select Allow. Here, we're using the #tests channel:
- This will now show a new Webhook URL in the Webhook URLs for Your Workspace section. Click the Copy button to copy it--we'll need to use it in the next set of steps!
- You can confirm the app was set up correctly by viewing the channel you selected; you should see a message saying that you added an integration to the channel. This notification will show as a message from you, since you're the one who set up the app.
Now you're all set to move on to the KnowledgeOwl side of the configuration!
- Go to Your Account > Webhooks.
- Select the + Create New Webhook button.
- This will open a pop-up where you can configure your webhook:
- Choose the Knowledge Bases you want to receive notifications about.
- Choose the Webhook Events you want to receive notifications about. See Available webhook events for more details.
- Select Slack from the Webhook Type dropdown.
- Paste the Webhook URL you copied from Slack into the Endpoint text field.
- Once you're done setting the webhook configuration, click the Create button.
- After you create your webhook, you should see a new notification in your Slack channel (the display may vary based on the Display Information you selected):
If you received that notification, congratulations your webhook is ready to go!
Common Use Cases
You can subscribe to the article.create and article.statusChange events to receive notifications in Slack whenever someone either creates a new article, or (for example) changes an article from "Draft" to "Ready to Publish".
This can be a great way to monitor your teams writing activity, and when used in conjunction with custom author roles, it can be a powerful way to manage and approve content before it goes live.
Subscribe to comment.create to receive new comments including the comment text itself, or comment.statusChange to be notified whenever someone publishes or deletes a comment.
Contact Form Submissions
Subscribe to contactForm.submit to receive notifications whenever someone submits a ticket from your knowledge base or embedded help widget.