cortif.ai logo
Cortif.ai

Integrations

Connect Cortif.AI with Slack, email, webhooks, and other tools to streamline your AI monitoring workflow

Integrations

Connect Cortif.AI with your favorite tools and services to streamline your AI monitoring workflow. Our integrations help you stay informed about model performance, drift detection, and system health across your entire stack.

Slack Integration

Get real-time alerts directly in your Slack workspace. Cortif.AI can post alert cards for model drift, accuracy drops, and other monitoring events straight to your chosen channels.

Setup Steps

Step 1 – Connect & Authorize

  1. In Cortif.AI, go to Integrations → Slack
  2. Click Connect to Slack
  3. A Slack window will open - pick your workspace
  4. Click Allow so Cortif.AI can send messages
    • We only request what's needed to post alerts and list channels
    • If your team uses private channels, you may need to invite the bot to that channel later

Step 2 – Choose a Channel & Test

  1. Back in Cortif.AI, open the Slack settings
  2. Select the channel where you want alerts to appear (e.g., #ml-alerts)
  3. Click Send test
  4. You should see a "Slack is connected!" message in that channel
  5. If nothing shows up:
    • Make sure the bot is a member of that channel
    • For private channels, use "Invite" in Slack
    • Try the test again

Step 3 – Configure Alerts

  1. Head to Projects → Your Project → Alerts
  2. Create or edit an alert rule
  3. Under Notification Channels, enable Slack
  4. Save the rule

From now on, when that alert triggers, Cortif.AI will send a rich card to your Slack channel with:

  • Alert name and severity
  • Triggering condition
  • Key metrics (accuracy drop, drift score, etc.)
  • Quick link to the dashboard

Advanced Settings

  • Mention users: Tag specific users or @channel in alert messages
  • Custom channels per alert: Route different types of alerts to different channels
  • Quiet hours: Pause Slack notifications during off-hours (still logged in dashboard)

Email Integration

Receive alert emails directly in your inbox. Perfect for keeping your entire team in the loop without requiring everyone to be in Slack.

Setup Steps

Step 1 – Add Email Recipients

  1. Go to Integrations → Email
  2. Click Add recipient
  3. Enter the email address
  4. Repeat for each recipient you want to notify

Step 2 – Test It

  1. Click Send test email next to a recipient
  2. Check your inbox
  3. You should receive a test email from alerts@cortif.ai

Step 3 – Enable for Alerts

  1. Navigate to Projects → Your Project → Alerts
  2. Create or edit an alert rule
  3. Under Notification Channels, enable Email
  4. Select which recipients should receive this alert
  5. Save

Email Alert Format

Alert emails include:

  • Subject: Clear alert summary (e.g., "🚨 High Drift Detected: Production Model")
  • Body:
    • Alert details
    • Triggering metrics
    • Timestamp
    • Link to dashboard
  • Attachments (optional): CSV of relevant metrics

Best Practices

  • Distribution lists: Use team email aliases (e.g., ml-team@company.com) instead of individual emails
  • Email filters: Set up filters in Gmail/Outlook to label Cortif.AI alerts
  • Escalation: Use email for critical alerts, Slack for warnings

Webhook Integration

Push alert data to any external system via HTTP webhooks. Great for integrating with PagerDuty, Jira, custom dashboards, or your own notification systems.

Setup Steps

Step 1 – Create a Webhook

  1. Go to Integrations → Webhooks
  2. Click Add webhook
  3. Enter a name (e.g., "PagerDuty Production")
  4. Enter the webhook URL (e.g., https://events.pagerduty.com/v2/enqueue)
  5. (Optional) Add custom headers for authentication:
    Authorization: Bearer YOUR_TOKEN
    Content-Type: application/json
  6. Click Save

Step 2 – Test the Webhook

  1. Click Send test payload next to your webhook
  2. Cortif.AI will POST a sample alert payload
  3. Check your external system to verify receipt
  4. If it fails, check:
    • URL is correct and reachable
    • Authentication headers are valid
    • Your endpoint accepts POST requests

Step 3 – Connect to Alerts

  1. Go to Projects → Your Project → Alerts
  2. Create or edit an alert rule
  3. Under Notification Channels, enable Webhook
  4. Select which webhook(s) to trigger
  5. Save

Webhook Payload Format

When an alert fires, Cortif.AI sends a POST request with this JSON payload:

{
  "event": "alert.triggered",
  "timestamp": "2025-10-02T14:35:00Z",
  "alert": {
    "id": "alert_abc123",
    "name": "High Drift Detected",
    "severity": "critical",
    "project_id": "proj_xyz789",
    "project_name": "Production Model"
  },
  "trigger": {
    "metric": "drift_score",
    "threshold": 0.7,
    "current_value": 0.85,
    "comparison": "greater_than"
  },
  "run": {
    "id": "run_def456",
    "started_at": "2025-10-02T14:30:00Z",
    "completed_at": "2025-10-02T14:35:00Z"
  },
  "links": {
    "dashboard": "https://app.cortif.ai/projects/proj_xyz789/runs/run_def456",
    "project": "https://app.cortif.ai/projects/proj_xyz789"
  }
}

Webhook Security

  • HTTPS only: We only support secure HTTPS endpoints
  • Signature verification: Coming soon - verify requests came from Cortif.AI
  • IP allowlist: Contact support for our webhook IP ranges
  • Retry logic: Failed webhooks are retried up to 3 times with exponential backoff

Common Webhook Integrations

PagerDuty

URL: https://events.pagerduty.com/v2/enqueue
Headers:
  Authorization: Token token=YOUR_INTEGRATION_KEY

Jira (create ticket)

URL: https://your-domain.atlassian.net/rest/api/3/issue
Headers:
  Authorization: Basic YOUR_BASE64_CREDENTIALS
  Content-Type: application/json

Microsoft Teams

URL: YOUR_WEBHOOK_CONNECTOR_URL
(No special headers needed)

Integration Management

Viewing All Integrations

  1. Go to Settings → Integrations
  2. You'll see all configured integrations:
    • Status: Active, inactive, or error
    • Last used: When the integration last sent a notification
    • Alert count: Number of alerts using this integration

Editing an Integration

  1. Click the integration name or the Edit button
  2. Update settings (e.g., Slack channel, email recipients, webhook URL)
  3. Click Save
  4. Existing alerts using this integration will automatically use the new settings

Disabling an Integration

  1. Click Disable next to the integration
  2. Alerts will stop sending to this channel
  3. The integration config is saved - you can re-enable anytime

Deleting an Integration

  1. Click Delete (⚠️ this is permanent)
  2. Confirm the deletion
  3. Any alerts using this integration will automatically remove it from their notification channels

Best Practices

Alert Routing Strategy

  • Critical alerts: Email + Slack + PagerDuty webhook
  • Warnings: Slack only
  • Info: Dashboard only (no notifications)

Avoid Alert Fatigue

  • Start with fewer alerts, add more as needed
  • Use appropriate severity levels
  • Set up quiet hours for non-critical alerts
  • Review alert history monthly and disable noisy ones

Testing Integrations

  • Always send a test message/webhook after setup
  • Test each alert rule individually
  • Verify message formatting in each channel
  • Check that links in notifications work

Troubleshooting

Slack Issues

Problem: Test message doesn't appear in channel

Solutions:

  • Verify the bot is in the channel (type /invite @Cortif.AI)
  • Check that the correct workspace is connected
  • Try disconnecting and reconnecting Slack
  • Check Slack's API status page

Problem: Messages appear but links don't work

Solutions:

  • Make sure your Cortif.AI domain is allowlisted in Slack settings
  • Check browser popup blockers

Email Issues

Problem: Emails not arriving

Solutions:

  • Check spam/junk folder
  • Add alerts@cortif.ai to contacts/safe senders
  • Verify email address is correct
  • Check email server logs (if corporate email)

Problem: Emails delayed by 5+ minutes

Solutions:

  • This is usually due to email server processing
  • Check with your IT team about mail gateway delays
  • Consider using Slack or webhooks for time-sensitive alerts

Webhook Issues

Problem: Webhook returns 401 Unauthorized

Solutions:

  • Verify authentication headers are correct
  • Check that API tokens haven't expired
  • Test the endpoint with curl/Postman first

Problem: Webhook times out

Solutions:

  • Ensure endpoint responds within 30 seconds
  • Check network/firewall rules
  • Verify the URL is publicly accessible
  • Contact support if behind VPN

Team Integration

Roles & Permissions

Different team members have different integration permissions:

  • Owner/Admin: Full access - create, edit, delete any integration
  • Member: Can view integrations and test them
  • Viewer: Can only see which integrations are configured

Shared Integrations

All integrations are workspace-level:

  • Set up once, use across all projects
  • Changes apply to all alerts using that integration
  • Deletion affects all alerts

Audit Log

Track integration changes:

  1. Go to Settings → Audit Log
  2. Filter by Integration category
  3. See who created, edited, or deleted integrations
  4. View when alerts were sent via each channel

Need help with integrations? Email support@cortif.ai or check our Integration Examples repository.