You can create webhooks to monitor your team's editing activity, or your customers' feedback inside of your Slack account in real time.
First, you will need to make sure you have the Slack Incoming Webhook app installed.
Once installed, in Slack:
- Click on your workspace title to get a dropdown.
- Select Settings & administration.
- Select Manage Apps.
- Select Custom Integrations.
- Select Incoming Webhooks.
- Add Configuration.
- In the new configuration, you can either create a new Slack channel or choose an existing channel to receive the notifications.
- After you choose the channel and click Add Incoming Webhooks integration, find the Webhook URL and Copy URL.
- 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 the Slack page 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:
If you received that notification, congratulations your webhook is ready to go!
Here's a sample Slack webhook set up:
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 user 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.