Zoom Team Chat (Beta)

This integration is in beta. Send a test notification to confirm messages reach your Zoom channel. If you run into a problem, let us know.

Receive monitoring alerts in the Zoom Team Chat channel your team already uses. Oh Dear sends a summary of each event and a link to the report, so you can investigate without searching for the monitor.

This integration sends notifications only. Actions such as acknowledging alerts, snoozing notifications, and running a check again are available in Oh Dear, not inside the Zoom message.

Create a connection in Zoom #

You'll need a Zoom Pro, Business, Education, or Enterprise account, and admin approval to install the Incoming Webhook app. Zoom lists the requirements in its Incoming Webhook guide.

1. Install Incoming Webhook, published by Zoom, from the Zoom App Marketplace.
2. Open the Zoom Team Chat channel where you want to receive alerts.
3. Send /inc connect OhDear in that channel.
4. The app sends you a private message with an endpoint and verification token. Keep both for the next step.

Use the standard connection command above. Connections created with -s (signature authentication) or -b (basic authentication) aren't supported by this integration.

Create a separate connection for each Zoom channel you want to notify. Keep the URL and token private.

Add the connection to Oh Dear #

You can add Zoom at the team level, or in the notification settings for a monitor, tag, or tag group.

1. Click Add configuration and choose Zoom Team Chat (Beta).
2. Paste the Webhook URL. It starts with https://integrations.zoom.us/chat/webhooks/incomingwebhook/. Copy the endpoint itself, not the entire example curl command.
3. Paste the Verification token exactly as Zoom supplied it, without adding Bearer or quotes.
4. Under Advanced settings, you can add a label, such as "Operations chat", and choose which events you want to receive.
5. Save the destination.

Oh Dear uses Zoom's full message format automatically. You don't need to add a format parameter to the URL; an existing ?format=full is also accepted.

Send a test notification #

Open the three-dot menu on your new destination and choose Send test notification. Check that "This is a test notification sent by Oh Dear." appears in the intended Zoom channel.

Failure and recovery notifications include the event summary and a link back to Oh Dear. Long summaries are shortened; follow the link for the full report.

If messages aren't arriving #

Check that the Incoming Webhook app is still installed and approved, and that the connection belongs to the channel you expected.

If Zoom rejects the verification token, run /inc regenerate OhDear in Zoom and update the destination's token in Oh Dear. If the connection was removed, create a new one and update both the URL and token. Send another test after saving.

If Zoom rate-limits delivery, Oh Dear retries using its notification queue. Other delivery failures follow our usual retry handling; a failed request isn't treated as a delivered notification.