mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-04 05:53:43 +00:00 
			
		
		
		
	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:
		@@ -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
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user