Integrieren Sie den Clawdbot KI-Assistenten mit externen Diensten über Webhooks. Erfahren Sie, wie Sie Webhook-Ereignisse für die Automatisierung empfangen und senden.

Clawdbot Webhooks Übersicht

Clawdbot unterstützt Webhooks zur Integration mit externen Diensten. Webhooks ermöglichen ereignisgesteuerte Automatisierung, externe Trigger und Dienst-zu-Dienst-Kommunikation.

Eingehende Webhooks

Konfiguration

{
  "webhooks": {
    "incoming": {
      "enabled": true,
      "port": 3011,
      "secret": "your-webhook-secret"
    }
  }
}

Endpunkt

POST http://localhost:3011/webhook/<hook-id>

Authentifizierung

curl -X POST http://localhost:3011/webhook/my-hook \
  -H "X-Webhook-Secret: your-webhook-secret" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from external service"}'

Webhook-Handler

Handler definieren

{
  "webhooks": {
    "handlers": [
      {
        "id": "github-events",
        "path": "/github",
        "action": "run_agent",
        "agentId": "devops",
        "template": "New GitHub event: {{event.action}} on {{event.repository.name}}"
      }
    ]
  }
}

Handler-Aktionen

Aktion	Beschreibung
`send_message`	Nachricht an Kanal senden
`run_agent`	Agenten mit Prompt auslösen
`forward`	An anderen Endpunkt weiterleiten
`custom`	Benutzerdefinierte Handler-Funktion

Sitzungsverwaltung

Webhook-Sitzungsschlüssel

Webhooks verwenden dedizierte Sitzungen:

hook:<uuid>

Sitzungsoptionen

{
  "webhooks": {
    "handlers": [
      {
        "id": "alerts",
        "sessionMode": "persistent",
        "sessionKey": "alerts-session"
      }
    ]
  }
}

Ausgehende Webhooks

Konfiguration

{
  "webhooks": {
    "outgoing": [
      {
        "id": "slack-notify",
        "url": "https://hooks.slack.com/services/xxx",
        "events": ["message_received", "agent_response"],
        "method": "POST"
      }
    ]
  }
}

Ereignistypen

Ereignis	Beschreibung
`message_received`	Neue Nachricht eingetroffen
`agent_response`	Agent hat Antwort generiert
`session_started`	Neue Sitzung erstellt
`session_ended`	Sitzung abgelaufen/geschlossen
`error`	Ein Fehler ist aufgetreten

Payload-Format

Eingehende Payload

{
  "event": "custom_event",
  "data": {
    "key": "value"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Ausgehende Payload

{
  "type": "message_received",
  "session": "agent:main:whatsapp",
  "message": {
    "from": "+15551234567",
    "text": "Hello",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Sicherheit

Geheimnis-Verifizierung

{
  "webhooks": {
    "incoming": {
      "secretHeader": "X-Webhook-Secret",
      "secret": "your-secret"
    }
  }
}

IP-Whitelist

{
  "webhooks": {
    "incoming": {
      "allowedIPs": [
        "192.168.1.0/24",
        "10.0.0.1"
      ]
    }
  }
}

Fehlerbehandlung

Wiederholungskonfiguration

{
  "webhooks": {
    "outgoing": [
      {
        "id": "notify",
        "retry": {
          "maxAttempts": 3,
          "backoff": "exponential"
        }
      }
    ]
  }
}

Fehlerbehandlung

Fehlgeschlagene Webhooks werden protokolliert
Wiederholung mit exponentiellem Backoff
Optionale Dead-Letter-Queue

Beispiele

GitHub-Integration

{
  "webhooks": {
    "handlers": [
      {
        "id": "github",
        "path": "/github",
        "action": "send_message",
        "target": {
          "channel": "discord",
          "peer": "dev-channel"
        },
        "template": "🔔 {{event.action}}: {{event.pull_request.title}}"
      }
    ]
  }
}

Alarm-Weiterleitung

{
  "webhooks": {
    "handlers": [
      {
        "id": "alerts",
        "path": "/alerts",
        "action": "run_agent",
        "agentId": "oncall",
        "template": "Alert: {{alert.name}} - {{alert.message}}"
      }
    ]
  }
}

Nächste Schritte

Clawdbot Cron-Jobs - Geplante Aufgaben
Clawdbot Gateway - Gateway-Konfiguration
Clawdbot Tools - Tool-Konfiguration

Clawdbot Webhooks

On this page