mirror of
https://github.com/zulip/zulip.git
synced 2025-11-09 00:18:12 +00:00
620854d437
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.
28 lines
988 B
Markdown
28 lines
988 B
Markdown
Get personal message notifications in Zulip for the results of your
|
|
Dialogflow queries!
|
|
|
|
1. {!create-stream.md!}
|
|
|
|
1. {!create-an-incoming-webhook.md!}
|
|
|
|
The API key for an incoming webhook bot cannot be used to read messages out
|
|
of Zulip. Thus, using an incoming webhook bot lowers the security risk of
|
|
exposing the bot's API key to a third-party service.
|
|
|
|
Construct the URL for the Dialogflow bot using the bot's API key and your
|
|
Zulip email. The webhook URL should look like:
|
|
|
|
`{{api_url}}?api_key=BOT'S_API_KEY&email=foo@example.com`
|
|
|
|
Modify the parameters of the URL above where `api_key` is the API key of your Zulip bot
|
|
and `email` is your Zulip email.
|
|
|
|
1. Go to the **Fulfillment** settings of your Dialogflow app and enable **Webhooks**.
|
|
Set **URL** to the URL constructed above.
|
|
Go to **Intents** and at the bottom, check the box **Use webhook**
|
|
under **Fulfillment**.
|
|
|
|
{!congrats.md!}
|
|
|
|
|