zulip/templates/zerver/integrations/asana.md

Get Zulip notifications for your Asana projects via Zapier!

1. {!create-stream.md!}

2. 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:

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

3. Start by setting up a Zapier account.

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

   

5. 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:

   

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

   

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

   

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

   

   and POST as the action:

   

9. Configure Set up Webhooks by Zapier POST as follows:

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

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

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