paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-11-05 14:35:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

integrations doc: Move asana doc to separate file.

Browse Source
This commit is contained in:
Tomasz Kolek
2017-04-05 06:57:10 +02:00
committed by Tim Abbott
parent 5b17622589
commit a39c55b4ab
3 changed files with 77 additions and 84 deletions
Download Patch File Download Diff File Expand all files Collapse all files

76
templates/zerver/integrations/asana.html Normal file
View File

@@ -0,0 +1,76 @@
<p>Get Zulip notifications for your Asana projects via Zapier!</p>
<p>
First, create the stream you'd like to use for Asana notifications, and
subscribe all interested parties to this stream. We recommend the
name <code>asana</code>.
</p>
<p><code>{{ external_api_uri_subdomain }}/v1/external/zapier?api_key=abcdefgh&amp;stream=asana</code></p>
<p>Start by setting up a <a href="https://zapier.com/">Zapier</a> account.</p>
<p>
Next, create a ZAP, picking Asana as the app you'd like
to receive notifications from as <code>Trigger (Step 1)</code>:
</p>
<img class="screenshot" src="/static/images/integrations/asana/001.png"/>
<p>
Next, select the Asana event that you'd like to receive notifications
for (<code>Choose Trigger</code>), such as when you add a new Task in
an Asana project:
</p>
<img class="screenshot" src="/static/images/integrations/asana/002.png"/>
<p>
Next, click on <code>Connect a New Account</code> and follow the steps
to connect your Asana account to the Zap:
</p>
<img class="screenshot" src="/static/images/integrations/asana/003.png"/>
<p>
Select the Asana project you'd like to receive notifications for:
</p>
<img class="screenshot" src="/static/images/integrations/asana/004.png"/>
<p>
In <code>Action (Step 2)</code>, select <code>Webhooks by Zapier</code>
as the app:
</p>
<img class="screenshot" src="/static/images/integrations/asana/005.png"/>
<p>and <code>POST</code> as the action:</p>
<img class="screenshot" src="/static/images/integrations/asana/006.png"/>
<p>
Configure <code>Set up Webhooks by Zapier POST</code> as follows:
<ul>
<li><code>URL</code> is the URL we created above</li>
<li><code>Payload Type</code> set to <code>JSON</code></li>
</ul>
</p>
<p>
Finally, configure <code>Data</code>.
You have to add 2 fields:
<ul>
<li><code>subject</code> is field corresponding to a subject of the message</li>
<li><code>content</code> is field corresponding to a content of the message</li>
</ul>
You can format the content of the <code>content</code> and <code>subject</code>
fields in a number of ways as per your requirements.
</p>
<p>Here's an example configuration:</p>
<img class="screenshot" src="/static/images/integrations/asana/007.png"/>
<p>You're done! Example message:</p>
<img class="screenshot" src="/static/images/integrations/asana/008.png"/>
<p>
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.
</p>

83
templates/zerver/integrations/index.html
View File

@@ -112,90 +112,7 @@
{% endif %}
{% endfor %}
<div id="asana" class="integration-instructions">
<p>Get Zulip notifications for your Asana projects via Zapier!</p>
<p>First, create the stream you'd like to use for Asana notifications, and
subscribe all interested parties to this stream. We recommend the
name <code>asana</code>.</p>
<p><code>{{ external_api_uri_subdomain }}/v1/external/zapier?api_key=abcdefgh&amp;stream=asana</code></p>
<p>Start by setting up a <a href="https://zapier.com/">Zapier</a> account.</p>
<p>
Next, create a ZAP, picking Asana as the app you'd like
to receive notifications from as <code>Trigger (Step 1)</code>:
</p>
<img class="screenshot" src="/static/images/integrations/asana/001.png"/>
<p>
Next, select the Asana event that you'd like to receive notifications
for (<code>Choose Trigger</code>), such as when you add a new Task in
an Asana project:
</p>
<img class="screenshot" src="/static/images/integrations/asana/002.png"/>
<p>
Next, click on <code>Connect a New Account</code> and follow the steps
to connect your Asana account to the Zap:
</p>
<img class="screenshot" src="/static/images/integrations/asana/003.png"/>
<p>
Select the Asana project you'd like to receive notifications for:
</p>
<img class="screenshot" src="/static/images/integrations/asana/004.png"/>
<p>
In <code>Action (Step 2)</code>, select <code>Webhooks by Zapier</code>
as the app:
</p>
<img class="screenshot" src="/static/images/integrations/asana/005.png"/>
<p>and <code>POST</code> as the action:</p>
<img class="screenshot" src="/static/images/integrations/asana/006.png"/>
<p>
Configure <code>Set up Webhooks by Zapier POST</code> as follows:
<ul>
<li><code>URL</code> is the URL we created above</li>
<li><code>Payload Type</code> set to <code>JSON</code></li>
</ul>
</p>
<p>
Finally, configure <code>Data</code>.
You have to add 2 fields:
<ul>
<li><code>subject</code> is field corresponding to a subject of the message</li>
<li><code>content</code> is field corresponding to a content of the message</li>
</ul>
You can format the content of the <code>content</code> and <code>subject</code>
fields in a number of ways as per your requirements.
</p>
<p>Here's an example configuration:</p>
<img class="screenshot" src="/static/images/integrations/asana/007.png"/>
<p>You're done! Example message:</p>
<img class="screenshot" src="/static/images/integrations/asana/008.png"/>
<p>
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.
</p>
<p style="font-size:11px; font-style:italic;">
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.
</p>
</div>
<div id="capistrano" class="integration-instructions">

2
zerver/lib/integrations.py
View File

@@ -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'),