Skip to content

slack-integration.mdx

Latest commit

 

History

History
255 lines (209 loc) · 7.77 KB

slack-integration.mdx

File metadata and controls

255 lines (209 loc) · 7.77 KB
title Slack Integration
description Connect AetherFlow with Slack to automate notifications, team updates, and workflow communications

Overview

The Slack integration enables seamless communication between AetherFlow workflows and your Slack workspaces. Send automated notifications, post updates, create channels, and trigger workflows from Slack events. This integration supports both incoming and outgoing messages, webhooks, and real-time event handling.

- Automated notifications from workflows - Channel and direct message posting - Slack event triggers - Real-time message processing - Custom bot configurations - Workflow completion alerts - Team status updates - Incident notifications - Daily summary reports - Approval requests

Setting Up Slack Integration

Navigate to the Integrations dashboard in AetherFlow and select Slack from the available options. You'll need Slack workspace admin permissions to complete the setup.

Go to [Slack API](https://api.slack.com/apps) and create a new app for your workspace. Choose "From scratch" and provide a name and workspace. Add the following OAuth scopes in the "OAuth & Permissions" section: - `channels:read` - Access public channels - `channels:write` - Post messages to channels - `chat:write` - Send messages - `chat:write.public` - Post to public channels - `files:write` - Upload files - `users:read` - Access user information Install the app to your workspace and copy the Bot User OAuth Token. Paste the token in AetherFlow's integration setup and authorize the connection. ```bash # Alternative: CLI setup aetherflow integrations connect slack --token xoxb-your-bot-token ```

Configuration Options

Bot Configuration

Customize your Slack bot's appearance and behavior:

Set the bot name, icon, and default channel for notifications. ```json { "bot_name": "AetherFlow Bot", "icon_emoji": ":robot_face:", "default_channel": "#general" } ``` ```bash export SLACK_BOT_NAME="AetherFlow Bot" export SLACK_ICON_EMOJI=":robot_face:" export SLACK_DEFAULT_CHANNEL="#general" ``` Configure message formatting, retry logic, and rate limiting. Slack allows 1 message per second per channel. AetherFlow handles this automatically with queuing.

Channel Management

Manage which channels your bot can access and post to:

Permission Level Description Use Case
Public Channels Post to any public channel Team announcements
Private Channels Require invitation to private channels Sensitive updates
Direct Messages Send DMs to users Personal notifications

Using Slack in Workflows

Basic Message Posting

Reference Slack in your workflow prompts naturally:

When a new customer signs up, post a welcome message to #customer-success channel in Slack.

Advanced Automation Examples

```javascript // Post formatted message with attachments const message = { channel: '#alerts', text: '🚨 System Alert', blocks: [ { type: 'section', text: { type: 'mrkdwn', text: '*Alert:* Database connection issues detected' } }, { type: 'actions', elements: [ { type: 'button', text: { type: 'plain_text', text: 'Investigate' }, action_id: 'investigate_alert' } ] } ] };

await slack.postMessage(message);


```python
# Send file with workflow results
from aetherflow import SlackClient

slack = SlackClient()
slack.upload_file(
    channels=['#reports'],
    filename='weekly_summary.pdf',
    file=open('summary.pdf', 'rb'),
    title='Weekly Performance Summary',
    initial_comment='Here\'s this week\'s summary report 📊'
)

Event Triggers

Set up workflows that respond to Slack events:

  • Message Events: Trigger on specific keywords or patterns
  • Channel Events: React to new channels or member joins
  • Reaction Events: Process emoji reactions
  • Mention Events: Respond when the bot is mentioned

Example trigger prompt:

When someone mentions @AetherFlow in Slack with "urgent", create a high-priority ticket and notify the on-call engineer.

Webhook Integration

For real-time Slack events, configure webhooks:

In your Slack app settings, go to "Event Subscriptions" and enable events. Add bot event subscriptions like `message.channels`, `reaction_added`. Use your AetherFlow webhook URL: `https://api.aetherflow.com/webhooks/slack`

Monitoring and Analytics

Track your Slack integration performance:

Messages sent, delivery rates, response times Active channels, engagement rates Failed deliveries, permission issues

Troubleshooting

Common Issues

Verify your bot token is correct and has the required scopes. Reinstall the app if needed. Check channel permissions and ensure the bot is invited to private channels. Implement message queuing in your workflow. Slack allows 1 message/second per channel. Confirm the request URL is correct and events are properly subscribed in Slack.

Debug Commands

# Test connection
aetherflow integrations test slack

# View logs
aetherflow logs --integration slack --last 24h

# Reset integration
aetherflow integrations reset slack

Security Considerations

Store Slack tokens securely and rotate them regularly. Use the minimum required permissions for your use case.
  • Token Management: AetherFlow encrypts all integration tokens
  • Scope Limitation: Only request necessary OAuth scopes
  • Audit Logging: All Slack interactions are logged for compliance
  • Access Control: Integration access follows your workspace permissions

Best Practices

  1. Channel Organization: Use dedicated channels for different types of notifications
  2. Message Formatting: Use Slack's Block Kit for rich, interactive messages
  3. Error Handling: Implement fallback channels for critical notifications
  4. Testing: Always test integrations in a development workspace first
  5. Monitoring: Set up alerts for integration failures
The Slack integration transforms AetherFlow into your team's communication hub, ensuring everyone stays informed about automated processes.