upstream-zulip/zerver/webhooks/dialogflow/doc.md

Get personal message notifications in Zulip for the results of your Dialogflow queries!

1. {!create-channel.md!}

2. {!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.

3. 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!}