Notifications

Get notified when deployments start, succeed, fail, or when preview environments are created. Rock8Cloud supports Slack and custom webhooks.

Accessing Notification Settings

1. Navigate to your project
2. Click the Settings tab
3. Scroll to the Notifications section

Supported Events

Setting Up Slack

Slack notifications are connected at the organization level via OAuth. Once connected, you can select channels from a dropdown when configuring notifications.

Step 1: Connect Slack Workspace

1. Go to Settings (gear icon in sidebar)
2. Open the Slack tab
3. Click Connect Slack Workspace
4. Authorize the app in the Slack OAuth popup
5. You should see a green "Connected" status

Step 2: Add the Bot to Channels

Before a channel appears in the channel picker, the Slack bot must be a member of that channel.

In Slack, open each channel where you want to receive notifications and run:

/invite @Stratos

Step 3: Add a Notification Channel

1. Navigate to your project's Settings tab
2. Scroll to the Notifications section
3. Click Add Channel
4. Select Slack as the type
5. Enter a name (e.g., "Deploys channel")
6. Select a channel from the dropdown
7. Select which events you want to receive
8. Click Create

Threaded Messages and Reactions

Rock8Cloud automatically groups deployment notifications into Slack threads for a cleaner channel experience.

How it works:

1. When a deployment starts, Rock8Cloud sends a "Deployment Started" message to your channel
2. When the deployment completes, the success or failure message is posted as a reply in the same thread
3. An emoji reaction is added to the original "Deployment Started" message:
   • :white_check_mark: for successful deployments
   • :x: for failed deployments

This keeps your channel organized and makes it easy to see deployment status at a glance.

Preview environments: PR preview notifications also use threading. All messages related to a single pull request (preview created, deployments, cleanup) are grouped in one thread.

Multiple channels: If you have multiple Slack channels configured for the same project, each channel maintains its own independent threads.

Setting Up Webhooks

Webhooks send JSON payloads to any HTTP endpoint when events occur.

Adding a Webhook

1. In your project's notification settings, click Add Channel
2. Select Webhook as the type
3. Enter a name (e.g., "Custom integration")
4. Enter your Webhook URL
5. Select which events you want to receive
6. Click Create

Webhook Payload Format

Webhooks receive a JSON payload:

{
  "event": "deployment:success",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "data": {
    "serviceName": "api",
    "serviceId": "uuid",
    "projectId": "uuid",
    "deploymentId": "uuid",
    "environmentId": "uuid",
    "environmentType": "stable",
    "branch": "main",
    "commitSha": "abc1234def5678",
    "commitMessage": "feat: add new endpoint",
    "url": "https://api.example.com",
    "appUrl": "https://rock8cloud.example.com/projects/.../deployments/..."
  }
}

Event-Specific Fields

deployment:started:

• branch, commitSha, commitMessage, deploymentId, environmentId, environmentType

deployment:success / deployment:rollback:

• branch, commitSha, commitMessage, deploymentId, environmentId, environmentType, url

deployment:failed:

• branch, commitSha, deploymentId, environmentId, environmentType, error

preview:created:

• branch, commitSha, deploymentId, environmentId, previewUrl, pr

preview:cleanup:

• branch, environmentId, pr

code-review:completed:

• branch, commitSha, pr, findings

code-review:failed:

• branch, commitSha, pr, error

Managing Channels

Enable/Disable

Toggle the switch next to any channel to enable or disable it without deleting the configuration.

Edit

Click on a channel to expand it, then click Edit to modify:

• Channel name
• Configuration (token/URL)
• Subscribed events

Delete

Click the trash icon to permanently remove a channel.

Troubleshooting

Slack: No channels in dropdown

The bot hasn't been invited to any channels. Run /invite @Stratos in each Slack channel where you want notifications. Then click the refresh button next to the dropdown.

Slack: "not_in_channel" error

The bot was removed from the channel after the notification was configured. Run /invite @Stratos in the channel again.

Slack: Notifications stopped working

The Slack workspace connection may have expired. Go to Settings > Slack and reconnect the workspace.

Webhook: No notifications received

1. Check that the webhook URL is accessible from the internet
2. Verify the channel is enabled
3. Confirm the event types you want are selected
4. Check your webhook endpoint logs for incoming requests