Slack Notifications

Connect BambooSnow to Slack to receive real-time notifications about agent activity, approvals, and important events.

Features

• Agent notifications - Get alerted when agents run
• Approval requests - Approve actions directly from Slack
• Digest summaries - Daily/weekly activity summaries
• Interactive messages - Take action without leaving Slack

Setting Up

Step 1: Connect Slack

1. Go to Settings > Integrations > Slack
2. Click Connect to Slack
3. Select your Slack workspace
4. Choose a default channel for notifications
5. Click Allow

Step 2: Configure Notifications

Choose what notifications to receive:

# .bamboosnow/config.yml
notifications:
  slack:
    # Default channel for all notifications
    default_channel: "#bamboosnow"

    # Notification settings
    events:
      agent_started:
        enabled: false

      agent_completed:
        enabled: true
        channel: "#dev-notifications"

      agent_failed:
        enabled: true
        channel: "#dev-alerts"
        mention: "@oncall"

      approval_required:
        enabled: true
        channel: "#approvals"

      security_alert:
        enabled: true
        channel: "#security"
        mention: "@security-team"

Notification Types

Agent Run Notifications

🤖 BambooSnow Agent Completed

Agent: Code Reviewer
Repository: your-org/your-repo
PR: #123 - Add user authentication
Status: ✅ Success
Duration: 45s

Issues Found: 3 (0 errors, 2 warnings, 1 info)

[View PR] [View Details]

Approval Requests

🔔 Approval Required

Action: Merge dependency update
Repository: your-org/your-repo
PR: #456 - Update lodash to 4.17.21

Requested by: dependency-updater agent
Reason: Major version update requires approval

[✅ Approve] [❌ Reject] [👀 View Details]

Security Alerts

🚨 Security Alert

Repository: your-org/your-repo
Severity: HIGH

Found 2 vulnerabilities:
• CVE-2024-1234 in lodash@4.17.20
• CVE-2024-5678 in axios@0.27.0

[View Full Report] [Create Issue]

Channel Routing

Route notifications to specific channels:

notifications:
  slack:
    routing:
      # By repository
      - match:
          repository: "frontend-*"
        channel: "#frontend"

      - match:
          repository: "backend-*"
        channel: "#backend"

      # By severity
      - match:
          severity: critical
        channel: "#incidents"
        mention: "@oncall"

      # By agent type
      - match:
          agent: security-scanner
        channel: "#security"

Interactive Features

Approval Buttons

Approve or reject actions directly from Slack:

1. Receive approval notification
2. Click Approve or Reject
3. Optionally add a comment
4. Action is processed immediately

Quick Actions

Take common actions from notifications:

• View PR - Open the pull request
• View Details - See full agent report
• Rerun - Trigger the agent again
• Snooze - Temporarily mute notifications

Digest Summaries

Receive periodic summaries:

notifications:
  slack:
    digests:
      daily:
        enabled: true
        time: "09:00"
        timezone: "America/New_York"
        channel: "#bamboosnow-digest"

      weekly:
        enabled: true
        day: "monday"
        time: "09:00"
        channel: "#bamboosnow-digest"

Daily Digest Example

📊 BambooSnow Daily Digest

Yesterday's Activity:
• 45 agent runs (42 success, 3 failed)
• 156 issues found
• 12 PRs reviewed
• 3 security vulnerabilities detected

Top Issues:
1. Missing error handling (28 occurrences)
2. Unused variables (19 occurrences)
3. Type safety (15 occurrences)

[View Full Report]

Slash Commands

Use BambooSnow commands in Slack:

/bamboosnow status
→ Shows agent status for your repositories

/bamboosnow run code-reviewer repo/name#123
→ Manually runs an agent on a PR

/bamboosnow approve ABC123
→ Approves a pending action

/bamboosnow help
→ Shows available commands

Troubleshooting

"Notifications not appearing"

• Check the channel permissions
• Verify the BambooSnow bot is in the channel
• Test with the Slack command: /bamboosnow test

"Buttons not working"

• Ensure you're logged into BambooSnow
• Check your permissions for the repository
• Verify the action hasn't expired