diff --git a/static/images/integrations/asana/001.png b/static/images/integrations/asana/001.png new file mode 100644 index 0000000000..c07b5e87ce Binary files /dev/null and b/static/images/integrations/asana/001.png differ diff --git a/static/images/integrations/logos/asana.png b/static/images/integrations/logos/asana.png new file mode 100644 index 0000000000..9c63b5bb7a Binary files /dev/null and b/static/images/integrations/logos/asana.png differ diff --git a/templates/zerver/integrations.html b/templates/zerver/integrations.html index e0cfe39cc8..3d9a9d1cf3 100644 --- a/templates/zerver/integrations.html +++ b/templates/zerver/integrations.html @@ -17,6 +17,12 @@
Get Zulip notifications for your Asana tasks!
+ +First, create the stream you'd like to use for Asana notifications, and
+ subscribe all interested parties to this stream. We recommend the
+ name asana
.
Next, on your Zulip settings + page, create an Asana bot. Please note the bot name and API key.
+ +Then:
+Download and install our Python bindings on the
+ server where the Asana mirroring script will live. The Asana
+ integration will be installed to a location
+ like /usr/local/share/zulip/integrations/asana/
.
Visit your Asana + account settings page and retrieve your API key.
+ +Edit asana/zulip_asana_config.py
and set
+ the ASANA_API_KEY
, ZULIP_USER
,
+ and ZULIP_API_KEY
configuration options to your
+ credentials.
If you are using a stream other than asana
,
+ set ZULIP_STREAM_NAME
to the chosen stream name.
Test your configuration by running the mirror with python
+ asana/zulip_asana_mirror
. It will print some informational
+ messages and process any recently created or completed tasks.
This mirror is intended to be a long-running processing and should be
+ hooked into your infrastructure for keeping services running (for
+ example, auto-restarting through supervisord
).
Please + contact support@zulip.com + if you'd like assistance with maintaining this integration. +
+Congratulations! You're done!
When team members create and
+ complete tasks in Asana, you'll get a Zulip notification that looks like
+ this:
First, create the stream you'd like to use for Basecamp notifications,
and subscribe all interested parties to this stream. We recommend the
name basecamp
.