−50%

50% off your first month on any paid plan · code WELCOME50 · until Nov 30

Start free →
Integration Team chat

How to send cron job and uptime alerts to Zulip

· Setup · 2 minutes

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.

WhereWhat to do
Settings → BotsAdd a new bot, type: Incoming webhook
Bot cardCopy the email and API key
Stream settingsMake 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:

FieldWhat to enterExample
Zulip URLYour organisation addresshttps://acme.zulipchat.com
Bot emailFrom the bot card[email protected]
API keyFrom the bot card••••••••••••
StreamWhere 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 fieldValueWhere you find it
Zulip URLhttps://acme.zulipchat.comYour browser address bar
Bot email[email protected]Settings → Bots → bot card
API key32-character stringSettings → Bots → bot card
StreamopsThe 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.

Troubleshooting#

Private streams need the bot to be subscribed. Go to the stream settings → Subscribers and add the bot there.

Not at the moment. All alerts go to the "WatchCron" topic. If you need separation, create multiple Zulip channels in WatchCron pointing to different streams.
Written by Vitalii Holben

Founder of WatchCron. Full-stack developer building monitoring tools that help teams keep cron jobs, uptime, and SSL certificates under control. Based in Europe, shipping code since 2014.

Start monitoring in under 2 minutes.

Free plan includes 20 checks · No credit card required
Pricing Docs
Log in Start free →