integration-docs: Update Zapier for new doc format.

Part of zulip #29592.

Co-authored-by: Lauryn Menard <lauryn@zulip.com>
This commit is contained in:
Niloth P 2024-07-08 02:22:58 +05:30 committed by Tim Abbott
parent d630564305
commit 2c2f530fe0
1 changed files with 29 additions and 28 deletions

View File

@ -1,46 +1,47 @@
# Zulip Zapier integration
Zapier supports integrations with
[hundreds of popular products](https://zapier.com/apps). Get notifications
sent by Zapier directly in Zulip.
{start_tabs}
1. {!create-channel.md!}
1. {!create-an-incoming-webhook.md!}
1. Create an account on [Zapier](https://zapier.com).
1. Create an account on [Zapier](https://zapier.com). Go to [Zulip
Integrations][1], and select the app you want to connect to Zulip.
1. Go to [Zulip Integrations](https://zapier.com/apps/zulip/integrations).
1. Under **Choose a Trigger**, select an event in the app you are
connecting to Zulip. Under **Choose an Action**, select **Send a
Private Message** or **Send a Stream Message**. Click **Connect**.
1. Scroll down to click on the app you want to connect to Zulip, or find it via
the search box.
1. Follow the instructions in the right sidebar to set up the trigger
event.
1. Under **Choose a Trigger**, select an event in the app you are connecting to Zulip.
1. Select the Zulip action in the center panel, and under **Account** in
the right sidebar, click **Sign in** to connect your bot to Zapier.
1. Under **Choose an Action**, select **Send a Private Message** or **Send a
Stream Message**.
1. On the **Allow Zapier to access your Zulip Account** screen, enter
the URL for your Zulip organization, and the email address and API
key of the bot you created above.
1. Follow the instructions in the right sidebar to set up the trigger event.
1. Click on the Zulip action you selected in the center panel.
1. Under **Account** in the right sidebar, click **Sign in** to connect your bot
to Zapier.
1. On the **Allow Zapier to access your Zulip Account?** screen, enter the URL for
your Zulip organization, and the email address and API key of the bot you
created above.
1. Under **Action** in the right sidebar, configure **Recipients** for a direct
message, or **Stream name** and **Topic**, as well as **Message content**.
1. Under **Action** in the right sidebar, configure **Recipients** for
direct messages, or **Stream name** and **Topic** for channel
messages. Configure **Message content**.
!!! tip ""
To send direct messages, enter a **Zulip account email** in the
**Recipients** box, if the email is [configured](/help/configure-email-visibility)
to be visible to **Admins, moderators, members and guests**. Otherwise, enter
`user` + [user ID](/help/view-someones-profile) + `@your Zulip domain`. For
example: `user123@acme.zulipchat.com`.
To receive notifications as direct messages, if your email
in Zulip is [configured](/help/configure-email-visibility)
to be visible to **Admins, moderators, members and guests**,
enter the email associated with your Zulip account in the
**Recipients** field. Otherwise, enter `user` +
[your user ID](/help/view-someones-profile) +
`@` + your Zulip domain, e.g., `user123@acme.zulipchat.com`.
1. When everything has been configured as desired, click **Publish** to enable
your Zap.
1. Click **Publish** to enable your Zap.
{end_tabs}
**Congratulations! You're done!**
[1]: https://zapier.com/apps/zulip/integrations