Back to Docs

Integrations

Connect Encompass to Slack, Discord, email, webhooks, and more to receive alerts where you work.

Overview

Integrations let you receive notifications when incidents occur. You can set up multiple integrations to ensure alerts reach the right people through the right channels.

All integrations can be managed from the "Integrations" page in your dashboard.

Slack

Send alerts to Slack channels for team visibility:

  1. 1.Create a Slack Incoming Webhook in your Slack workspace
  2. 2.Go to Integrations → Create Integration → Slack
  3. 3.Paste your webhook URL and save

Tip: Create dedicated channels like#alerts or#incidentsto keep notifications organized.

Discord

Receive rich embed notifications in Discord:

  1. 1.In Discord, go to Channel Settings → Integrations → Webhooks
  2. 2.Create a new webhook and copy the URL
  3. 3.Go to Integrations → Create Integration → Discord
  4. 4.Paste your webhook URL and save

Microsoft Teams

Send alerts to Microsoft Teams channels:

  1. 1.In Teams, go to the channel → Connectors → Incoming Webhook
  2. 2.Configure the webhook and copy the URL
  3. 3.Go to Integrations → Create Integration → Microsoft Teams
  4. 4.Paste your webhook URL and save

Email

Receive beautifully formatted email alerts:

  1. 1.Go to Integrations → Create Integration → Email
  2. 2.Enter the email address to receive alerts
  3. 3.Click the verification link sent to that email address
  4. 4.Once verified, the integration is active

Important: Email integrations require verification to prevent spam. Check your inbox for the verification email after creating the integration.

Webhooks

Send alerts to any HTTP endpoint for custom integrations:

  1. 1.Go to Integrations → Create Integration → Webhook
  2. 2.Enter your endpoint URL
  3. 3.Optionally add custom headers (e.g., for authentication)

Webhook Payload

{
  "event_type": "incident_created",
  "incident_id": "uuid",
  "title": "Monitor Down: API Server",
  "description": "Health check failed for API Server",
  "severity": "sev2",
  "status": "triggered",
  "source_type": "monitor",
  "service_name": "API Server",
  "timestamp": "2024-01-15T10:30:00Z",
  "webhook_version": "1.0"
}

Testing Integrations

After creating an integration, you can send a test notification to verify it works:

  1. 1.Find your integration in the list
  2. 2.Click the "Test" button
  3. 3.Check that the test notification arrives in your channel/inbox

Enabling/Disabling Integrations

You can temporarily disable an integration without deleting it:

  • Toggle the "Enabled" switch on any integration
  • Disabled integrations won't receive any notifications
  • Re-enable anytime to resume notifications
  • Useful for temporary maintenance or vacation periods