Skip to main content

​
Webhooks

Receive real-time notifications from Visent services through webhooks for events like alert triggers, benchmark completion, and system status changes. Configure webhook endpoints to integrate Visent notifications with your existing workflow and monitoring systems. Supports multiple webhook destinations with retry logic, authentication, and event filtering.

​
Webhook Events

Coming soon - complete list of available webhook events and payloads.

​
Configuration

​
Creating Webhooks

# Create a new webhook
POST /webhooks

# Example request
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/visent",
    "events": ["alert.triggered", "benchmark.completed"],
    "secret": "your_webhook_secret",
    "active": true
  }' \
  "https://api.visent.ai/webhooks"

# Example response
{
  "webhook_id": "wh_12345",
  "url": "https://your-app.com/webhooks/visent",
  "events": ["alert.triggered", "benchmark.completed"],
  "active": true,
  "created_at": "2024-01-15T10:30:00Z"
}

​
Managing Webhooks

# List webhooks
GET /webhooks

# Update webhook
PUT /webhooks/{webhook_id}

# Delete webhook
DELETE /webhooks/{webhook_id}

​
Event Types

​
Alert Events

{
  "event": "alert.triggered",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "alert_id": "alert_789",
    "name": "High GPU Temperature",
    "severity": "critical",
    "node": "gpu-worker-1",
    "gpu": 0,
    "metric": "temperature",
    "value": 87.5,
    "threshold": 85.0
  }
}

​
Benchmark Events

Coming soon - benchmark completion and status change events.

​
System Events

Coming soon - node status changes and system health events.

​
Security

​
Webhook Authentication

import hmac
import hashlib

def verify_webhook(payload, signature, secret):
    """Verify webhook signature"""
    expected = hmac.new(
        secret.encode('utf-8'),
        payload.encode('utf-8'),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, f"sha256={expected}")

​
IP Allowlisting

Coming soon - IP address restrictions for webhook endpoints.

​
Delivery

​
Retry Policy

Coming soon - webhook delivery retry logic and backoff strategies.

​
Delivery Logs

Coming soon - tracking webhook delivery status and debugging failures.

​
Timeout Settings

Coming soon - configuring webhook timeout and reliability settings.

​
Testing

​
Webhook Testing

# Test webhook delivery
POST /webhooks/{webhook_id}/test

# Send test event
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.visent.ai/webhooks/wh_12345/test"

​
Event Simulation

Coming soon - simulating events for webhook testing and development.

​
Troubleshooting

Coming soon - common webhook issues and debugging guide.

​
Code Examples

​
Python Flask Handler

from flask import Flask, request, jsonify
import hmac
import hashlib

app = Flask(__name__)

@app.route('/webhooks/visent', methods=['POST'])
def handle_webhook():
    payload = request.get_data(as_text=True)
    signature = request.headers.get('X-Visent-Signature')
    
    # Verify signature
    if not verify_webhook(payload, signature, WEBHOOK_SECRET):
        return jsonify({'error': 'Invalid signature'}), 401
    
    event = request.json
    
    # Handle different event types
    if event['event'] == 'alert.triggered':
        handle_alert(event['data'])
    elif event['event'] == 'benchmark.completed':
        handle_benchmark(event['data'])
    
    return jsonify({'status': 'received'})

​
Next Steps