diff --git a/static/images/help/bot_types.png b/static/images/help/bot_types.png new file mode 100644 index 0000000000..d819311707 Binary files /dev/null and b/static/images/help/bot_types.png differ diff --git a/templates/zerver/help/include/create-bot-construct-url.md b/templates/zerver/help/include/create-bot-construct-url.md index d9d6f48179..76bdf7f608 100644 --- a/templates/zerver/help/include/create-bot-construct-url.md +++ b/templates/zerver/help/include/create-bot-construct-url.md @@ -1,6 +1,17 @@ -Next, on your {{ settings_html|safe }}, create a bot for -{{ integration_display_name }}. Construct the URL for the -{{ integration_display_name }} bot using the bot API key and stream name: +Next, on your {{ settings_html|safe }}, +[create a bot](/help/add-a-bot-or-integration) for +{{ integration_display_name }}. Make sure that you select +**Incoming webhook** as the **Bot type**: + +![](/static/images/help/bot_types.png) + +The API keys for "Incoming webhook" bots are limited to only +sending messages via webhooks. Thus, this bot type lessens +the security risks associated with exposing the bot's API +key to third-party services. + +Construct the URL for the {{ integration_display_name }} +bot using the bot API key and stream name: {!webhook-url.md!}