mirror of
https://github.com/zulip/zulip.git
synced 2025-11-13 02:17:19 +00:00
The Beeminder integration requires an `email` parameter that our bot creation documentation macros don't yet support.
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
Get Beeminder notifications in Zulip whenever you're going to derail from your goal!
|
|
|
|
{!create-stream.md!}
|
|
|
|
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**:
|
|
|
|

|
|
|
|
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 Beeminder bot using the bot's API key and your Zulip email.
|
|
|
|
The webhook URL should look like:
|
|
|
|
`{{api_url}}/v1/external/beeminder?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.
|
|
|
|
{!append-stream-name.md!}
|
|
|
|
* When creating or editing a goal in Beeminder, you can check the **Make private** option to make sure
|
|
the bot sends you private messages; otherwise, the bot will send messages to a public stream.
|
|
|
|

|
|
|
|
* Copy the above URL and paste it in the `WEBHOOK` input option in the `reminders`
|
|
setting of your Beeminder account.
|
|
|
|

|
|
|
|
{!congrats.md!}
|
|
|
|

|