Webhooks

Receive real-time notifications when events occur in Compass.

Available Events

• interaction.evaluated — an interaction has been scored
• alert.triggered — an alert condition was met
• feedback.created — new feedback was posted

Configuration

Set up webhook endpoints in your project settings. Each webhook receives a JSON payload with event details.

Payload Format

{
  "event": "interaction.evaluated",
  "timestamp": "2026-01-15T14:30:00Z",
  "data": {
    "interaction_id": "...",
    "compass_score": 4,
    "signals": ["follow_up_required"]
  }
}

Security

Webhook payloads include a signature header for verification. Validate the signature to ensure requests originate from Compass.