Alerts arrive in a Zulip stream under one topic, so recoveries thread with the failures they close.
What the alerts look like#
WatchCron posts to a stream under the topic "WatchCron". Each message shows the monitor name, status, reason, and a link to the incident. Because Zulip threads by topic, a failure and its recovery sit right next to each other. No scrolling through unrelated chatter to find the pair.
Before you start#
You need:
- A Zulip organisation where you can create bots (self-hosted or zulipchat.com).
- A WatchCron account on any plan. Zulip alerts are included on Free, Starter, Pro and Business.
Setup takes about two minutes. Slightly longer than webhook-based integrations because Zulip uses bot credentials instead of a single URL.
Step 1 — Create a bot in Zulip#
Go to Settings → Personal settings → Bots → Add a new bot. Set the type to Incoming webhook and name it "WatchCron".
After creating the bot, you'll see a card with two values you need: the bot email (something like [email protected]) and the API key. Copy both.
Also note which stream you want alerts in. The bot must be allowed to post there. For private streams, add the bot as a subscriber first.
| Where | What to do |
|---|---|
| Settings → Bots | Add a new bot, type: Incoming webhook |
| Bot card | Copy the email and API key |
| Stream settings | Make sure the bot can post to the target stream |
Step 2 — Add the channel in WatchCron#
Go to Alerts → Channels → Add channel and choose Zulip. This one has four fields instead of the usual one:
| Field | What to enter | Example |
|---|---|---|
| Zulip URL | Your organisation address | https://acme.zulipchat.com |
| Bot email | From the bot card | [email protected] |
| API key | From the bot card | •••••••••••• |
| Stream | Where to post (topic is always "WatchCron") | ops |
Click Save.
Step 3 — Test and assign monitors#
Click Send test. A message should appear in the stream under the "WatchCron" topic. If it shows up, the connection works.
Open any monitor and tick the Zulip channel under Alert channels. All alerts from every assigned monitor go to the same stream and topic.
What to paste where#
| WatchCron field | Value | Where you find it |
|---|---|---|
| Zulip URL | https://acme.zulipchat.com | Your browser address bar |
| Bot email | [email protected] | Settings → Bots → bot card |
| API key | 32-character string | Settings → Bots → bot card |
| Stream | ops | The stream name in Zulip's sidebar |
What WatchCron sends#
Each message contains the monitor name, status, reason, and an incident link. Zulip's topic threading means every alert for "WatchCron" ends up in one scrollable timeline. That's the main advantage over flat-channel tools like Slack or Discord: you don't lose alerts between other conversations.