Integration

Slack

Send alerts to a Slack channel using incoming webhooks.

Prerequisites

  • A Slack workspace where you can add apps
  • A Talarius account with a project created
1

Create an Incoming Webhook

Go to your Slack workspace's App Directory:

  1. Open api.slack.com/apps
  2. Click Create New App
  3. Choose From scratch
  4. Name it (e.g., "Talarius Alerts") and select your workspace
  5. Click Create App
2

Enable Incoming Webhooks

In your app settings:

  1. Click Incoming Webhooks in the sidebar
  2. Toggle Activate Incoming Webhooks to On
  3. Click Add New Webhook to Workspace
  4. Select the channel where you want alerts
  5. Click Allow
3

Copy the Webhook URL

You'll see your new webhook URL. It looks like:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Keep this URL secret

Anyone with this URL can post messages to your channel. Treat it like a password.

4

Configure in Talarius

In your Talarius dashboard:

  1. Go to your project settings
  2. Select Slack as destination type
  3. Paste your Webhook URL
  4. Click Test Connection
  5. Save the configuration

Send a Test Alert

Test your integration:

curl 
curl -X POST https://v1.talarius.io/alerts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Test Alert", "body": "Slack integration is working!"}'

How alerts appear

Alerts are sent as Slack messages with attachments:

T

Talarius Alerts

APP 2:34 PM

Server Alert

CPU usage exceeded 90% on production-web-1

Priority: high

Troubleshooting

Webhook URL not working?

Make sure the URL starts with https://hooks.slack.com/services/. Older Slack URLs have a different format.

Getting "channel_not_found" error?

The webhook is tied to a specific channel. If the channel was deleted or renamed, you'll need to create a new webhook.

Need to change the channel?

Create a new webhook for the new channel in your Slack app settings. Each webhook is bound to one channel.

Optional: Customize your app

Make your alerts more recognizable in Slack:

  1. Go to your app settings at api.slack.com/apps
  2. Click Basic Information
  3. Scroll to Display Information
  4. Upload an icon and customize the name

Next steps

API Reference

Full endpoint documentation

Examples

Real-world use cases