zulip/templates/zerver/integrations/asana.md

Get Zulip notifications for your Asana projects via Zapier!

{!create-stream.md!}

Next, on your {{ settings_html|safe }}, create a bot for Asana. Construct the URL for the Asana bot using the bot API key and stream name, like so:

{{ 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 the 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:

• URL is the URL we created above
• Payload Type set to JSON

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

• subject is the field corresponding to the subject of the message
• content is the field corresponding to the content of the message

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:

{!congrats.md!}

You can repeat the above process and create Zaps for different projects and/or different kinds of Asana events that you'd like to be notified about in Zulip.