DocumentationAgent Action Firewall

Slack Integration

Receive approval requests and manage actions directly from Slack.

Features

  • Real-time approval notifications
  • Approve or deny actions with buttons
  • View action details and context
  • Threaded discussions for team decisions
  • Configurable channels per risk level

Setup

1. Install the Slack App

  1. Go to Settings > Integrations in the dashboard
  2. Click "Add to Slack"
  3. Select the workspace and authorize permissions

2. Configure Channels

After installation, configure which channels receive notifications:

JSON
{
  "channels": {
    "default": "#agent-approvals",
    "high_risk": "#security-alerts",
    "critical": "#security-critical"
  }
}

3. Invite the Bot

Invite @Agent Firewall to your approval channels:

TEXT
/invite @Agent Firewall

Using Slack Approvals

Approval Messages

When an action requires approval, you'll receive a message like:

TEXT
🔔 Action Requires Approval

Agent: customer-service-agent
Tool: http_proxy
Operation: POST
URL: https://api.company.com/customers/update

Risk Level: 🟡 Medium
Reason: Write operation to customer data

[✅ Approve] [❌ Deny] [📋 Details]

Approving Actions

Click Approve to allow the action. You can optionally add a comment explaining the approval.

Denying Actions

Click Deny to block the action. You'll be prompted to provide a reason.

Configuration Options

OptionDescription
mention_on_criticalMention specific users/groups for critical actions
thread_repliesKeep approval discussions in threads
show_full_paramsInclude full action parameters in message
dm_on_assignmentDM users when assigned as approvers

Slash Commands

/firewall status     - View pending approvals
/firewall recent     - Show recent actions
/firewall approve    - Approve by action ID
/firewall deny       - Deny by action ID

Troubleshooting

Not receiving messages?

  • Ensure the bot is invited to the channel
  • Check that the integration is active in Settings
  • Verify the correct channel is configured

Buttons not working?

  • Ensure you have approver permissions
  • Check if the action has already been handled
  • Try refreshing the Slack app

Next Steps