From a39c55b4ab640fdcf6e61c20f98a610d71b2337a Mon Sep 17 00:00:00 2001 From: Tomasz Kolek Date: Wed, 5 Apr 2017 06:57:10 +0200 Subject: [PATCH] integrations doc: Move asana doc to separate file. --- templates/zerver/integrations/asana.html | 76 ++++++++++++++++++++++ templates/zerver/integrations/index.html | 83 ------------------------ zerver/lib/integrations.py | 2 +- 3 files changed, 77 insertions(+), 84 deletions(-) create mode 100644 templates/zerver/integrations/asana.html diff --git a/templates/zerver/integrations/asana.html b/templates/zerver/integrations/asana.html new file mode 100644 index 0000000000..07ec8cba9e --- /dev/null +++ b/templates/zerver/integrations/asana.html @@ -0,0 +1,76 @@ +

Get Zulip notifications for your Asana projects via Zapier!

+ +

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

+ +

{{ external_api_uri_subdomain }}/v1/external/zapier?api_key=abcdefgh&stream=asana

+ +

Start by setting up a Zapier account.

+ +

+ Next, create a ZAP, picking Asana as the app you'd like + to receive notifications from as Trigger (Step 1): +

+ + +

+ Next, select the Asana event that you'd like to receive notifications + for (Choose Trigger), such as when you add a new Task in + an Asana project: +

+ + +

+ Next, click on Connect a New Account and follow the steps + to connect your Asana account to the Zap: +

+ + +

+ Select the Asana project you'd like to receive notifications for: +

+ + +

+ In Action (Step 2), select Webhooks by Zapier + as the app: +

+ + +

and POST as the action:

+ + +

+ Configure Set up Webhooks by Zapier POST as follows: + +

+

+ +

+ Finally, configure Data. + You have to add 2 fields: +

+ You can format the content of the content and subject + fields in a number of ways as per your requirements. +

+ +

Here's an example configuration:

+ + +

You're done! Example message:

+ + +

+ You can repeat the above process and create Zaps for different projects + and/or different kinds of Asana events that you'd like to receive + notifications about. +

diff --git a/templates/zerver/integrations/index.html b/templates/zerver/integrations/index.html index a6454f754e..db46254e8a 100644 --- a/templates/zerver/integrations/index.html +++ b/templates/zerver/integrations/index.html @@ -112,90 +112,7 @@ {% endif %} {% endfor %} -
-

Get Zulip notifications for your Asana projects via Zapier!

- -

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.

- -

{{ external_api_uri_subdomain }}/v1/external/zapier?api_key=abcdefgh&stream=asana

- -

Start by setting up a Zapier account.

- -

- Next, create a ZAP, picking Asana as the app you'd like - to receive notifications from as Trigger (Step 1): -

- - -

- Next, select the Asana event that you'd like to receive notifications - for (Choose Trigger), such as when you add a new Task in - an Asana project: -

- - -

- Next, click on Connect a New Account and follow the steps - to connect your Asana account to the Zap: -

- - -

- Select the Asana project you'd like to receive notifications for: -

- - -

- In Action (Step 2), select Webhooks by Zapier - as the app: -

- - -

and POST as the action:

- - -

- Configure Set up Webhooks by Zapier POST as follows: - -

-

- -

- Finally, configure Data. - You have to add 2 fields: -

- You can format the content of the content and subject - fields in a number of ways as per your requirements. -

- -

Here's an example configuration:

- - -

You're done! Example message:

- - -

- You can repeat the above process and create Zaps for different projects - and/or different kinds of Asana events that you'd like to receive - notifications about. -

- -

- Logos are trademarks of their respective owners. - None of the integrations on this page are created by, - affiliated with, or supported by the companies - represented by the logos. -

-
diff --git a/zerver/lib/integrations.py b/zerver/lib/integrations.py index a5605dbd26..31abcc4372 100644 --- a/zerver/lib/integrations.py +++ b/zerver/lib/integrations.py @@ -183,7 +183,7 @@ WEBHOOK_INTEGRATIONS = [ ] # type: List[WebhookIntegration] INTEGRATIONS = { - 'asana': Integration('asana', 'asana'), + 'asana': Integration('asana', 'asana', doc='zerver/integrations/asana.html'), 'capistrano': Integration('capistrano', 'capistrano'), 'codebase': Integration('codebase', 'codebase'), 'email': EmailIntegration('email', 'email'),