mirror of https://github.com/zulip/zulip.git
46 lines
1.7 KiB
HTML
46 lines
1.7 KiB
HTML
|
<p>
|
||
|
|
<em>
|
||
|
|
If you are running JIRA version 5.2 or greater, or if you are
|
||
|
|
using the hosted JIRA provided by Atlassian, you can use the built-in
|
||
|
|
web-hook support to connect to Zulip — read on. For older,
|
||
|
|
self-hosted JIRA installs, you can use our <a href="#jira-plugin">JIRA Plugin</a>.
|
||
|
|
</em>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
First, create the stream you'd like to use for JIRA notifications, and
|
||
|
|
subscribe all interested parties to this stream. We recommend the
|
||
|
|
name <code>jira</code>.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
In your JIRA administration control panel, go to the Webhooks page. If you are using the OnDemand
|
||
|
|
hosted JIRA, follow the instructions
|
||
|
|
<a href="https://developer.atlassian.com/display/JIRADEV/JIRA+Webhooks+Overview#JIRAWebhooksOverview-WhereistheJIRAAdministrationUIforwebhooks?">
|
||
|
|
on the Atlassian wiki
|
||
|
|
</a>
|
||
|
|
for locating the Webhook UI.
|
||
|
|
</p>
|
||
|
|
<p>Give your new web hook a name, and for the URL provide the following:</p>
|
||
|
|
<p>
|
||
|
|
<code>{{ external_api_uri_subdomain }}/v1/external/jira?api_key=abcdefgh&stream=jira</code>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
where <code>api_key</code> is the API key of your Zulip bot,
|
||
|
|
and <code>stream</code> is the stream name you want the
|
||
|
|
notifications sent to.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
Next, go back to Zulip and set up a stream called "jira," if it does not already exist.
|
||
|
|
(If you prefer your JIRA notifications to go to a stream other than "jira," then change the URL above to match
|
||
|
|
it.)
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<b>Congratulations! You're done!</b><br/>
|
||
|
|
Updates from JIRA will be sent to the Zulip stream you specified in the JIRA web-hook.
|
||
|
|
</p>
|
||
|
|
<img class="screenshot" src="/static/images/integrations/jira/001.png"/>
|