Skip to main content

Slack Integration Setup

Transform your team communication with real-time AstroPulse notifications delivered directly to your Slack channels. Enterprise-grade integration with webhook validation ensures reliable, formatted alerts for your entire organization.

📋 Prerequisites​

  • Enterprise Plan: Slack integration is an Enterprise-only feature
  • Organization Owner: Only organization owners can configure Slack channels
  • Slack Workspace Admin: Ability to create incoming webhooks in your Slack workspace

🚀 Quick Setup​

Step 1: Create Slack Webhook​

  1. Open Slack and navigate to your workspace

  2. Visit Slack Apps: Go to https://api.slack.com/apps

  3. Create New App: Click "Create New App" → "From scratch"

  4. Configure App:

    • App Name: AstroPulse Notifications (or your preferred name)
    • Workspace: Select your target workspace

  5. Add Incoming Webhooks:

    • Navigate to "Incoming Webhooks" in the left sidebar
    • Activate incoming webhooks
    • Click "Add New Webhook to Workspace"
    • Select Channel: Choose the channel for notifications
    • Authorize the integration

  6. Copy Webhook URL: Save the generated webhook URL (format: https://hooks.slack.com/services/...)

Step 2: Configure in AstroPulse​

  1. Navigate to Settings: Go to Console → Settings → Notifications
  2. Add Channel: Click "Add Channel"
  3. Select Slack: Choose "Slack" from the channel type dropdown
  4. Enter Webhook URL: Paste your Slack webhook URL
  5. Test Webhook: Click "Test Webhook" to verify the integration
    • A test message will be sent to your Slack channel
    • ✅ Success: Test passes, channel can be created
    • ❌ Failure: Check webhook URL and permissions
  6. Create Channel: Click "Create Channel" after successful test

Step 3: Subscribe to Topics​

  1. Subscribe to Topics: Click "Subscribe to Topic"
  2. Select Topics: Choose events you want to receive:
    • Cluster Pipeline Events - Infrastructure updates
    • Application Pipeline Events - Deployment notifications
    • System Events - Platform alerts
  3. Select Channels: Check "Slack" to receive notifications via Slack
  4. Enable Subscription: Ensure the subscription is enabled

Visual Elements​

  • 🎨 Rich Blocks: Structured layouts with sections and fields
  • 🔗 Action Buttons: Direct links to AstroPulse Console
  • 📊 Status Indicators: Color-coded severity levels
  • 📱 Mobile Optimized: Perfect formatting on all devices

🔧 Troubleshooting​

Common Issues​

❌ "Test failed" or "Failed to fetch"​

  • Problem: Webhook is unreachable or returns error
  • Solutions:
    • ✅ Verify webhook URL is complete and unmodified
    • ✅ Check Slack app permissions in workspace
    • ✅ Ensure channel exists and app has access
    • ✅ Regenerate webhook if necessary

❌ "Enterprise Only" Message​

  • Problem: Slack integration requires Enterprise plan
  • Solution: Upgrade to Enterprise plan or use Email notifications

❌ Messages Not Appearing​

  • Problem: Integration created but no messages received
  • Check:
    • ✅ Subscription Status: Ensure subscriptions are enabled
    • ✅ Channel Selection: Verify Slack is selected in subscription
    • ✅ Event Activity: Confirm events are occurring
    • ✅ Webhook Health: Re-test webhook URL

🔒 Security & Best Practices​

Security Guidelines​

  • 🔐 Secure URLs: Webhook URLs contain sensitive tokens—never share publicly
  • 🏢 Workspace Control: Only workspace admins should create webhooks
  • 🔄 Rotation: Regenerate webhook URLs periodically
  • 📋 Audit: Monitor webhook usage in Slack app settings

Best Practices​

  • 📍 Dedicated Channels: Create specific channels for AstroPulse notifications
  • 👥 Team Access: Ensure relevant team members have access to notification channels
  • 🔕 Channel Settings: Configure notification preferences per channel
  • 📱 Mobile: Enable mobile notifications for critical alerts

Channel Organization​

#astropulse-critical     → System Events (high priority)
#astropulse-deployments  → Application Pipeline Events  
#astropulse-infra        → Cluster Pipeline Events
#astropulse-general      → All events (development)

📈 Advanced Configuration​

Multiple Webhooks​

Create separate integrations for different channels:

  1. Create Multiple Apps: Different Slack apps for different purposes
  2. Channel-Specific URLs: Unique webhook per channel type
  3. Topic Targeting: Subscribe different topics to different channels

Integration Management​

  • ✏️ Edit Integration: Use the pencil icon to modify existing Slack channels
  • 🔄 Re-test Webhooks: Test existing integrations periodically
  • 📊 Monitor Usage: Track message delivery and engagement

Compliance & Audit​

  • 📋 Permanent Records: All notification subscriptions and changes are logged
  • 🔍 Audit Trail: Full history of webhook tests and configurations
  • 📑 Compliance Export: Export notification settings for compliance review

🆘 Support​

Need help with Slack integration?

  • 📖 Documentation: Check Slack API documentation
  • 🎫 Support: Contact AstroPulse support with webhook configuration details
  • 💬 Community: Join our community for integration tips and best practices

Next Steps: Subscribe to notification topics or explore Email notifications as an alternative.