Skip to content

Slack Notifications

Clarive can send automatic notifications to Slack channels when events occur in your projects. Notifications are configured per-project and can be triggered by topic, job, post, and repository events.

Prerequisites

Before configuring Slack notifications, you need a Slack Incoming Webhook URL. Create one in your Slack workspace under Apps > Incoming Webhooks.

Configuring Slack Notifications

Navigate to your project settings and select the Notifications tab. From there you can create, edit, enable/disable, test, and delete Slack notification rules.

Creating a Notification

Click New Notification and fill in:

  • Connection Name - A descriptive name for this notification (e.g. "Team Channel Alerts").
  • Webhook URL - The Slack Incoming Webhook URL from your Slack workspace.
  • Username (optional) - Override the default bot username for messages.

Then select which events should trigger a notification:

  • Topic created - When a new topic is created in the project.
  • Topic status changed - When a topic transitions to a new status.
  • New post - When a public comment is posted on a topic.
  • New internal post - When an internal comment is posted on a topic.
  • Job started - When a deployment job begins.
  • Job finished (success) - When a job completes successfully.
  • Job finished (failure) - When a job fails.
  • Job action - When a job is paused, trapped, or requires approval.
  • Repository updated - When code is pushed to a project repository.

Testing a Notification

After creating a notification, click the Test button to send a test message to your Slack channel. This verifies that the webhook URL is correct and the channel is accessible.

Enabling and Disabling

Use the toggle switch next to each notification to enable or disable it without deleting the configuration.

Slack Outgoing Webhooks

Clarive also supports Slack Outgoing Webhooks, which allow posting comments to topics from Slack. Configure a SlackOutgoingWebhook resource with the token provided by Slack, then use the trigger word followed by a topic MID and your comment:

cla 12345 This is my comment from Slack

The outgoing webhook endpoint is:

POST /slackwebhook/api?path=outgoing_webhook

Multi-Project Topics

When a topic belongs to multiple projects, Clarive checks all project notification configurations. The Slack message will display the correct project name for whichever project's notification rule matched.