Skip to main content

Slack Integration

Connect CICosts to Slack for real-time cost alerts and notifications directly in your team's channels.

Overview​

The Slack integration allows you to:

  • Receive alert notifications in Slack channels
  • Get daily/weekly cost summaries
  • Quickly view cost data via Slack commands
  • Share insights with your team

Setting Up Slack​

Prerequisites​

  • CICosts Pro or Team plan
  • Slack workspace admin or app management permissions

Installation Steps​

  1. Go to CICosts Dashboard → Settings → Integrations
  2. Click Connect Slack
  3. You'll be redirected to Slack's authorization page
  4. Select your workspace
  5. Choose which channel(s) to authorize
  6. Click Allow
  7. You'll be redirected back to CICosts

Permissions Requested​

CICosts requests these Slack permissions:

PermissionPurpose
chat:writeSend messages to channels
commandsRespond to slash commands
incoming-webhookPost messages via webhooks

We do not request access to:

  • Your messages
  • User information
  • Private channels (unless invited)

Configuring Notifications​

Alert Notifications​

When creating or editing alerts, select Slack as a notification channel:

  1. Go to Alerts → Create/Edit Alert
  2. Under "Notifications", check Slack
  3. Select the channel
  4. Save the alert

Channel Selection​

You can send alerts to:

  • Public channels - Any public channel you've added CICosts to
  • Private channels - After inviting @CICosts to the channel

To add CICosts to a private channel:

  1. Open the channel in Slack
  2. Type /invite @CICosts
  3. Confirm

Notification Format​

Alert notifications include:

🚨 CICosts Alert: Monthly Budget Warning

Your organization my-company has exceeded 75% of the monthly budget.

Current spend: $1,523.45
Budget: $2,000.00
Remaining: $476.55

View in CICosts →

Scheduled Summaries​

Set up automated cost summaries:

Daily Summary​

Receive a daily cost summary each morning:

  1. Go to Settings → Integrations → Slack
  2. Enable Daily Summary
  3. Select time (e.g., 9:00 AM)
  4. Select channel
  5. Save
📊 CICosts Daily Summary - Jan 15, 2024

Yesterday's spend: $47.82 (↑12% vs avg)
Top workflow: ci.yml ($18.45)
Runs: 23 total

Week-to-date: $312.50
Month-to-date: $1,247.00

View details →

Weekly Summary​

Get a weekly recap every Monday:

  1. Enable Weekly Summary
  2. Select time
  3. Select channel
  4. Save
📊 CICosts Weekly Summary - Week of Jan 8

Total spend: $312.50 (↓5% vs last week)
Total runs: 156
Avg cost/run: $2.00

Top repositories:
1. api-service: $156.78
2. web-app: $89.45
3. mobile-app: $66.27

View full report →

Slack Commands​

Use slash commands to query cost data (coming soon):

/cicosts status​

Get current cost status:

/cicosts status

Response:

Today: $47.82 (↑12% vs avg)
This week: $312.50
This month: $1,247.00
Projected: $1,890.00

/cicosts workflow [name]​

Get workflow cost details:

/cicosts workflow ci.yml

/cicosts top [n]​

Get top N expensive workflows:

/cicosts top 5

Troubleshooting​

Not Receiving Notifications​

  1. Check channel permissions

    • Ensure CICosts is added to the channel
    • For private channels, invite @CICosts

  2. Check alert configuration

    • Verify Slack is enabled for the alert
    • Confirm the correct channel is selected

  3. Check Slack connection

    • Go to Settings → Integrations
    • Verify Slack shows as "Connected"
    • Try reconnecting if needed

Wrong Channel​

To change the notification channel:

  1. Edit the alert
  2. Update the Slack channel
  3. Save

Disconnecting Slack​

To remove the Slack integration:

  1. Go to Settings → Integrations
  2. Click Disconnect next to Slack
  3. Confirm

This stops all Slack notifications immediately.

Reconnecting​

If you need to reconnect:

  1. Disconnect (if currently connected)
  2. Click Connect Slack
  3. Re-authorize with new permissions

Next: Email Integration →