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 @@
+
+ + + Asana + +
@@ -173,8 +179,63 @@
-
+
+ +

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:

+
    +
  1. +

    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/.

    +
  2. +
  3. +

    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.

    +
  4. +
  5. +

    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.

    +
  6. +
  7. +

    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. +

    +
  8. +
+ +

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.