Integrations

Noah integrates with popular communication and development tools to deliver notifications and enable seamless workflows. Configure integrations to receive alerts where your team already works.

Integration Architecture

Slack Integration

Connect Noah to Slack for real-time notifications, interactive alerts, and conversational AI access through the Noah bot.

Setup Process

Features

Alert Notifications: Receive real-time alerts in designated channels with interactive buttons to acknowledge, mute, or view details. Alerts include severity indicators, affected metrics, and quick action buttons.

Slash Commands: Use commands directly in Slack without leaving your conversation.

Command	Description
/noah alerts	List all active alerts
/noah status	Show system status
/noah mute [project]	Mute alerts for a project
/noah report	Generate instant report

Noah AI Bot: Ask questions in natural language and receive contextually-aware responses. The bot can analyze trends, generate reports, and provide troubleshooting guidance.

Thread Notifications: Alert replies are automatically threaded to keep channels organized and maintain context for team discussions.

Microsoft Teams Integration

Integrate with Microsoft Teams to deliver alerts as adaptive cards with rich formatting and interactive elements.

Setup Process

1. Navigate to Settings → Integrations → Microsoft Teams
2. Create incoming webhook in your Teams channel
3. Paste webhook URL into Noah configuration
4. Configure notification types and formatting
5. Test the integration with a sample alert

Features

Adaptive Cards: Notifications appear as formatted cards with visual hierarchy, making it easy to scan critical information quickly.

Rich Formatting: Cards include color-coded severity levels, metric charts, and clickable links to detailed dashboards.

Action Buttons: Team members can acknowledge alerts, view details, or mute notifications directly from Teams without switching applications.

Email Integration

Configure email notifications for team members who prefer traditional communication channels or need backup notification methods.

Configuration

SMTP Settings:

• Server address and port
• Authentication credentials
• TLS/SSL encryption
• From address and display name

Recipient Management:

• Individual email addresses
• Distribution lists
• Role-based recipients
• Escalation chains

Notification Types

Type	Frequency	Recipients
Critical Alerts	Immediate	All administrators
High Alerts	Immediate	Project team
Medium Alerts	Batched (hourly)	Project watchers
Low Alerts	Batched (daily)	Optional subscribers
Reports	Scheduled	Configurable

Email Templates

Customize email appearance to match your organization's branding. Configure header colors, logos, footer text, and contact information.

Webhook Integration

Send alert data to custom endpoints for integration with incident management systems, monitoring platforms, or custom automation workflows.

Configuration

{
  "url": "https://your-endpoint.com/webhook",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer your-token",
    "Content-Type": "application/json"
  },
  "retry_policy": {
    "max_attempts": 3,
    "backoff": "exponential"
  }
}

Payload Structure

{
  "event_type": "alert.triggered",
  "timestamp": "2024-01-15T10:30:00Z",
  "alert": {
    "id": "alert-123",
    "project_id": "proj-456",
    "project_name": "Customer Support Chatbot",
    "severity": "high",
    "metric": "content_drift",
    "current_value": 0.89,
    "threshold": 0.7,
    "message": "Content drift exceeded threshold"
  },
  "organization": {
    "id": "org-789",
    "name": "Acme Corp"
  }
}

Common Use Cases

PagerDuty Integration: Create incidents automatically for critical alerts with on-call engineer escalation.

Datadog Integration: Forward metrics to Datadog for unified monitoring dashboards combining infrastructure and AI system metrics.

Custom Automation: Trigger automated responses like scaling infrastructure, switching models, or running diagnostic scripts.

Integration Security

All integrations support secure authentication and encryption to protect sensitive alert data.

Security Features:

• Webhook signature verification
• TLS/SSL encryption for all communications
• API key rotation support
• IP whitelisting for webhook endpoints
• Audit logs for all integration activity

Testing Integrations

Before deploying integrations to production, test them to ensure proper configuration and delivery.

Test Process:

1. Navigate to integration settings
2. Click "Send Test Notification"
3. Verify receipt in target system
4. Check formatting and appearance
5. Test interactive features (buttons, links)
6. Confirm all required data is present

Troubleshooting

Common integration issues and their solutions.

Issue	Cause	Solution
Notifications not received	Incorrect webhook URL	Verify URL in target system
Slack bot not responding	Missing bot permissions	Re-authorize integration
Email delivery failures	SMTP authentication error	Check credentials and port
Webhook timeouts	Slow endpoint response	Implement async processing
Missing alert data	Outdated integration	Update to latest API version