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
- In Cortif.AI, go to Integrations → Slack
- Click Connect to Slack
- A Slack window will open - pick your workspace
- 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
- Back in Cortif.AI, open the Slack settings
- Select the channel where you want alerts to appear (e.g.,
#ml-alerts) - Click Send test
- You should see a "Slack is connected!" message in that channel
- 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
- Head to Projects → Your Project → Alerts
- Create or edit an alert rule
- Under Notification Channels, enable Slack
- 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
@channelin 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
- Go to Integrations → Email
- Click Add recipient
- Enter the email address
- Repeat for each recipient you want to notify
Step 2 – Test It
- Click Send test email next to a recipient
- Check your inbox
- You should receive a test email from
alerts@cortif.ai
Step 3 – Enable for Alerts
- Navigate to Projects → Your Project → Alerts
- Create or edit an alert rule
- Under Notification Channels, enable Email
- Select which recipients should receive this alert
- 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
- Go to Integrations → Webhooks
- Click Add webhook
- Enter a name (e.g., "PagerDuty Production")
- Enter the webhook URL (e.g.,
https://events.pagerduty.com/v2/enqueue) - (Optional) Add custom headers for authentication:
Authorization: Bearer YOUR_TOKEN Content-Type: application/json - Click Save
Step 2 – Test the Webhook
- Click Send test payload next to your webhook
- Cortif.AI will POST a sample alert payload
- Check your external system to verify receipt
- If it fails, check:
- URL is correct and reachable
- Authentication headers are valid
- Your endpoint accepts POST requests
Step 3 – Connect to Alerts
- Go to Projects → Your Project → Alerts
- Create or edit an alert rule
- Under Notification Channels, enable Webhook
- Select which webhook(s) to trigger
- 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_KEYJira (create ticket)
URL: https://your-domain.atlassian.net/rest/api/3/issue
Headers:
Authorization: Basic YOUR_BASE64_CREDENTIALS
Content-Type: application/jsonMicrosoft Teams
URL: YOUR_WEBHOOK_CONNECTOR_URL
(No special headers needed)Integration Management
Viewing All Integrations
- Go to Settings → Integrations
- 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
- Click the integration name or the Edit button
- Update settings (e.g., Slack channel, email recipients, webhook URL)
- Click Save
- Existing alerts using this integration will automatically use the new settings
Disabling an Integration
- Click Disable next to the integration
- Alerts will stop sending to this channel
- The integration config is saved - you can re-enable anytime
Deleting an Integration
- Click Delete (⚠️ this is permanent)
- Confirm the deletion
- 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.aito 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:
- Go to Settings → Audit Log
- Filter by Integration category
- See who created, edited, or deleted integrations
- View when alerts were sent via each channel
Need help with integrations? Email support@cortif.ai or check our Integration Examples repository.