zulip/zerver/webhooks/zapier/doc.md

47 lines
1.7 KiB
Markdown
Raw Normal View History

2018-08-10 17:11:30 +02:00
Zapier supports integrations with
[hundreds of popular products](https://zapier.com/apps). Get notifications
sent by Zapier directly in Zulip.
1. {!create-stream.md!}
1. {!create-an-incoming-webhook.md!}
1. Create an account on [Zapier](https://zapier.com).
1. Go to [Zulip Integrations](https://zapier.com/apps/zulip/integrations).
2018-08-10 17:11:30 +02:00
1. Scroll down to click on the app you want to connect to Zulip, or find it via
the search box.
2018-08-10 17:11:30 +02:00
1. Under **Choose a Trigger**, select an event in the app you are connecting to Zulip.
1. Under **Choose an Action**, select **Send a Private Message** or **Send a
Stream Message**.
1. Follow the instructions in the right sidebar to set up the trigger event.
2018-08-10 17:11:30 +02:00
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**.
!!! 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`.
1. When everything has been configured as desired, click **Publish** to enable
your Zap.
2018-08-10 17:11:30 +02:00
2018-08-10 17:11:30 +02:00
**Congratulations! You're done!**