zulip/templates/zerver/help/include/create-bot-construct-url.md

{!create-a-bot.md!}

Construct the URL for the {{ integration_display_name }}
bot using the bot's API key and the desired stream name:

{!webhook-url.md!}

Modify the parameters of the URL above, where `api_key` is the API key
of your Zulip bot, and `stream` is the [URL-encoded](https://www.urlencoder.org/)
stream name you want the notifications sent to. If you do not specify a
`stream`, the bot will send notifications via PMs to the creator of the bot.

If you'd like this integration to always send to a specific topic,
just include the (URL-encoded) topic as an additional parameter
(E.g. for `your topic`, append `&topic=your%20topic` to the URL).
markdown: Add a macro with instructions for creating a bot. 2018-02-08 04:54:14 +01:00			`{!create-a-bot.md!}`
webhooks: Recommend creating "incoming webhook" bot. In all our webhooks' docs, we now recommend creating a bot with the "Incoming webhook" bot type. 2017-07-07 05:01:16 +02:00
			`Construct the URL for the {{ integration_display_name }}`
integrations: Improve wording in create-bot-construct-url.md. 2017-12-02 06:48:29 +01:00			`bot using the bot's API key and the desired stream name:`
webhooks: Add Markdown macros for repetitive documentation. 2017-05-18 03:43:32 +02:00
templates: Support parametric Markdown macros for webhooks docs. 2017-05-25 00:13:50 +02:00			`{!webhook-url.md!}`
webhooks/codeship: Migrate docs to Markdown. 2017-05-25 03:01:19 +02:00
webhooks/delighted: Migrate docs to Markdown. 2017-05-25 03:29:03 +02:00			Modify the parameters of the URL above, where `api_key` is the API key
docs: Update guidelines to URL-encode stream name or topic name. Updated create-bot-construct-url-indented.md file with guidelines on how to URL-encode stream name and topic name. The hyperlink added will solve the issue for those who use emoji in stream name or topic name. Tweaked by tabbott to edit the copy and update the non-indented version as well. Fixes #16430. 2020-10-21 01:05:09 +02:00			of your Zulip bot, and `stream` is the [URL-encoded](https://www.urlencoder.org/)
			`stream name you want the notifications sent to. If you do not specify a`
			`stream`, the bot will send notifications via PMs to the creator of the bot.
webhooks: Update macros to specify custom topics and default PMs. These changes are the result of migrating to check_send_webhook_message. 2018-03-17 19:47:53 +01:00
docs: Update guidelines to URL-encode stream name or topic name. Updated create-bot-construct-url-indented.md file with guidelines on how to URL-encode stream name and topic name. The hyperlink added will solve the issue for those who use emoji in stream name or topic name. Tweaked by tabbott to edit the copy and update the non-indented version as well. Fixes #16430. 2020-10-21 01:05:09 +02:00			`If you'd like this integration to always send to a specific topic,`
			`just include the (URL-encoded) topic as an additional parameter`
			(E.g. for `your topic`, append `&topic=your%20topic` to the URL).