]> BookStack Code Mirror - website/commitdiff
Merged in discord-specific webhook text during review of #113
authorDan Brown <redacted>
Thu, 31 Mar 2022 11:54:02 +0000 (12:54 +0100)
committerDan Brown <redacted>
Thu, 31 Mar 2022 11:54:02 +0000 (12:54 +0100)
content/docs/admin/email-webhooks.md

index 673baa53e150162671a48dc074c233d6fe0ae5f7..95fb430965f7f057c1751b9e11807c2b4fb34a31 100644 (file)
@@ -73,16 +73,14 @@ after changing your configuration. This action will also attempt to capture any
 Webhooks can be configured in the "Settings > Webhooks" area of your BookStack instance.
 An example of the POST data format is shown when creating or editing a webhook.
 
-The running on webhooks can slow down a system due to the required additional processing time.
-See the [async action handling](#async-action-handling) section below to details on running webhooks
-in a background process to improve performance.
-
-#### Bookstack Webhooks to Discord/Slack
-Bookstack is compatible with webhooks for Discord and Slack, since they both use a similar webhook format. To set this up, copy the Webhook url from the platform of choice into the "Webhook Endpoint" text box, and then append `/slack` onto the end of the URL. 
+The webhook data is "Slack Compatible" in respect to having a `text` property containing a human-readable description
+of the event. Services such as [Discord](https://discord.com/developers/docs/resources/webhook#execute-slackcompatible-webhook), [Zulip](https://zulip.com/integrations/doc/slack_incoming) and Teams, upon many others, have options to support this format.
 
-Once done, the URL should look like `https://discord.com/api/webhooks/[Webhook ID]/slack`, where `[Webhook ID]` is the unique ID assigned to your specific Webhook.
+A video guide on BookStack webhooks, including usage with Discord and HomeAssistant, [can be found here](https://www.youtube.com/watch?v=_zIp1ruGpoI).
 
-For a more in depth tutorial, see [this video](https://www.youtube.com/watch?v=_zIp1ruGpoI&t=60s)
+The running of webhooks can slow down a system due to the required additional processing time.
+See the [async action handling](#async-action-handling) section below to details on running webhooks
+in a background process to improve performance.
 
 ---