Files
zulip/templates/zerver/help/include/create-bot-construct-url.md
David Rosa 620854d437 integrations: Add incoming webhook macro to relevant docs.
Several integration docs instruct the user to create a bot, but don't
specify that the type of bot should be "Incoming webhook".

Renames create-a-bot.md -> create-an-incoming-webhook.md for clarity,
and replaces all incomplete instructions with this macro.
Renames bot_types.png -> bot_types_incoming_webhook.png and updates
the image with a screenshot of the latest UI.
2022-09-09 16:31:33 -07:00

756 B

{!create-an-incoming-webhook.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 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).

{% if all_event_types is defined %}

{!event-filtering-instruction.md!}

{% endif %}