Slack Integration

DevRamps integrates with Slack to send real-time pipeline notifications to your team's channels. You can also approve or reject manual approvals directly from Slack.

Connecting Slack

1. Navigate to Organization Settings > Integrations
2. Click Connect on the Slack card
3. Authorize the DevRamps Slack app in your workspace
4. Once connected, the integration shows your workspace name

Only one Slack workspace can be connected per organization.

Configuring Pipeline Notifications

Add a notifications block to your pipeline YAML definition to configure which events trigger Slack messages:

metadata:
  version: "1"
  cloud_provider: AWS
  # ...

notifications:
  slack:
    channel: "#deployments"
    events:
      - stage_failed
      - approval_required

Configuration Options

Field	Required	Description
channel	Yes	The Slack channel to post notifications to (e.g., #deployments)
events	Yes	List of event keys to subscribe to

Supported Event Keys

Event Key	Description
stage_failed	A deployment stage has failed
approval_required	A step requires manual approval to proceed
stage_auto_rolled_back	A stage was automatically rolled back (future)
stage_rolled_back	A stage was manually rolled back (future)
stage_rolled_forward	A stage was manually rolled forward (future)
ephemeral_claimed	An ephemeral environment lock was acquired
ephemeral_released	An ephemeral environment lock was released
ephemeral_deployment_succeeded	An ephemeral environment deployment completed successfully
ephemeral_deployment_failed	An ephemeral environment deployment failed

If the notifications block is omitted from your pipeline definition, no Slack messages are sent (opt-in).

Notification Messages

Stage Failed

When a subscribed stage_failed event fires, a Slack message is posted with:

• Pipeline name and stage name
• Failure cause
• Commit information
• A View in DevRamps button linking to the stage page

Manual Approval Required

When an approval_required event fires, the Slack message includes:

• Pipeline name, stage name, and step name
• Approval context (content type)
• Three action buttons: Approve, Reject, View in DevRamps

Clicking Approve or Reject processes the action through the same approval flow as the web UI. The Slack message updates to show the result (e.g., "Approved by @user").

User Matching

To approve or reject from Slack, your Slack account email must match your DevRamps account email. If there's no match, you'll see an ephemeral message asking you to verify your email.

Disconnecting Slack

1. Navigate to Organization Settings > Integrations
2. Click Disconnect on the Slack card

Disconnecting revokes the bot token and removes the integration. Existing pipeline notifications config will remain in YAML but no messages will be sent.

Troubleshooting

Issue	Solution
Messages not appearing	Verify the channel name in your YAML is correct and the bot has access
"Channel not found"	Ensure the channel exists and the bot has been invited
Can't approve from Slack	Check that your Slack email matches your DevRamps email
"You don't have a linked DevRamps account"	Your Slack email doesn't match any DevRamps user in the organization