Skip to content

Slack Output

The Slack output allows you to send notifications to Slack channels or users. It's ideal for team collaboration and workspace-based notifications.

How It Works

When you create a Slack output, Relaye uses Slack's OAuth system to securely connect to your workspace. When a notification is sent:

  1. Relaye formats the message according to your template
  2. The message is sent to Slack via their API
  3. The message appears in the configured Slack channel
  4. Relaye logs the delivery status

Slack supports rich formatting, code blocks, images, and files, making it an excellent choice for detailed notifications in team environments.

Setting Up Slack Output

To set up a Slack output:

  1. Go to the Outputs section
  2. Click New Output
  3. Select Slack as the output type
  4. Click the Add to Slack button
  5. You'll be redirected to Slack's authorization page
  6. Select the workspace you want to connect to
  7. Choose the channel where notifications should be sent
  8. Grant the requested permissions
  9. You'll be redirected back to Relaye
  10. Give your output a name (e.g., "Production Alerts")
  11. Click Save

Handling Images and Files

Slack can display images and files sent with notifications. If your input includes images or files, they will be automatically forwarded to Slack where supported.

Testing Your Slack Output

To test your Slack output:

  1. Go to the output's details page
  2. Click Test
  3. Relaye will send a test notification to your Slack channel
  4. Check your Slack channel to confirm receipt

Common Uses

Slack outputs are frequently used for:

  • Team Alerts: Send important notifications to team channels
  • Deployment Updates: Notify teams of successful or failed deployments
  • Monitoring Alerts: Forward monitoring system alerts to appropriate channels
  • Customer Support: Notify support teams of urgent customer issues
  • Sales Notifications: Alert sales teams of new leads or opportunities

Troubleshooting

Common Issues

Authorization Issues

If you're having trouble connecting to Slack:

  1. Verify you have the necessary permissions in your Slack workspace
  2. Try removing the integration from Slack and reconnecting
  3. Check if your Slack workspace has restrictions on app installations

Messages Not Appearing

If your messages aren't appearing in Slack:

  1. Verify the channel still exists and the integration has access
  2. Check if your template is generating valid content
  3. Verify the Slack app hasn't been removed from your workspace
  4. Check the output logs in Relaye for error messages

Viewing Slack Logs

You can view all outgoing Slack notifications by:

  1. Going to the Outputs section
  2. Clicking on your Slack output
  3. Navigating to the Outgoing Logs tab

This will show you all sent notifications, their status, and any error messages.

Best Practices

  • Use channel-specific outputs for targeted notifications
  • Keep messages concise and actionable
  • Use formatting to highlight important information
  • Include links to detailed information
  • Use mentions sparingly and only when immediate attention is needed
  • Consider creating dedicated alert channels for different severity levels
  • Include context in your notifications (source, environment, etc.)
  • Use emojis to quickly convey status or severity