integrations: Update Asana integration doc to point to Zapier.

Updates the Asana documentation, which was a detailed version
of the Zapier documentation with screenshots specifically for
Asana, to instead start with the basic incoming webhook steps
and then point to the general Zapier documentation to complete
the integration.

This will be easier to maintain moving forward in the short
term as ideally we'll migrate to a system that documents all
of the integrations with Zulip that are available via Zapier.

Also, updates the current Zapier documentation to mention
Asana as one of the apps that can be integrated with Zulip.
This commit is contained in:
Lauryn Menard 2023-02-27 16:15:51 +01:00 committed by Tim Abbott
parent 4f8169aab5
commit 96aca49f9f
10 changed files with 7 additions and 53 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

View File

@ -1,60 +1,14 @@
Get Zulip notifications for your Asana projects via Zapier! Get Zulip notifications for your Asana projects via Zapier!
1. {!create-stream.md!} 1. {!create-stream.md!}
1. {!create-bot-construct-url.md!} 1. {!create-an-incoming-webhook.md!}
1. Start by setting up a [Zapier](https://zapier.com/) account. 1. Continue with step 3 of the [Zapier documentation][1] to
finish integrating Zulip with Asana.
1. Next, create a ZAP, picking Asana as the app you'd like
to receive notifications from as the **Trigger (Step 1)**:
![Trigger](/static/images/integrations/asana/001.png)
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:
![Trigger selection](/static/images/integrations/asana/002.png)
1. Next, click on **Connect a New Account** and follow the steps
to connect your Asana account to the Zap:
![Account selection](/static/images/integrations/asana/003.png)
1. Select the Asana project you'd like to receive notifications for:
![Project selection](/static/images/integrations/asana/004.png)
1. In **Action (Step 2)**, select **Webhooks by Zapier** as the app:
![App selection](/static/images/integrations/asana/005.png)
and `POST` as the action:
![Action selection](/static/images/integrations/asana/006.png)
1. Configure **Set up Webhooks by Zapier POST** as follows:
* `URL` is the URL we created above.
* `Payload Type` set to `JSON`.
1. Finally, configure **Data**. You have to add 2 fields:
* `subject` is the field corresponding to the topic of the message.
* `content` is the field corresponding to the content of the message.
1. 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:
![Example configuration](/static/images/integrations/asana/007.png)
{!congrats.md!}
![Asana bot message](/static/images/integrations/asana/008.png)
You can repeat the above process and create Zaps for different projects 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 and/or different kinds of Asana events that you'd like to be notified
about in Zulip. about in Zulip.
[1]: ./zapier

View File

@ -14,7 +14,7 @@ sent by Zapier directly in Zulip.
1. Click **Make a Zap!** in the upper left. 1. Click **Make a Zap!** in the upper left.
1. Follow the instructions to select a Trigger App and Event (**When this happens ...** (Step 1)). 1. Follow the instructions to select a Trigger App and Event (**When this happens ...** (Step 1)).
This could be an app like Trello, Gmail, Calendar, or anything else. This could be an app like Asana, Trello, Gmail, Calendar, or anything else.
1. **Do this ...** (Step 2): Search for Zulip, and click on the Zulip icon. Follow the instructions. 1. **Do this ...** (Step 2): Search for Zulip, and click on the Zulip icon. Follow the instructions.