API & Webhooks

AgenticWende ist von Grund auf so gebaut, dass sich die Plattform an Ihre Systeme anbinden lässt. Auf dieser Seite finden Sie die wichtigsten Bausteine: Webhooks für Ereignisse, API-Schlüssel zur Authentifizierung und den Export Ihrer Daten als CSV. Alle Funktionen richten Sie im angemeldeten Bereich unter Einstellungen › Integrationen ein.

API-Schlüssel & Authentifizierung

In den Integrationen-Einstellungen erzeugen Sie einen persönlichen API-Schlüssel. Der Schlüssel wird aus Sicherheitsgründen nur ein einziges Mal angezeigt – bewahren Sie ihn sicher auf. Sie können ihn jederzeit neu erzeugen; ältere Schlüssel verlieren dann ihre Gültigkeit.

Übergeben Sie den Schlüssel als Bearer-Token im Authorization-Header:

Authorization: Bearer <IHR_API_SCHLÜSSEL>

CRM-Webhooks

Hinterlegen Sie eine Webhook-URL Ihres CRM- oder ERP-Systems und einen Secret-Token. AgenticWende sendet dann bei den ausgewählten Ereignissen eine HTTP-POST-Anfrage mit einem JSON-Body an Ihre URL. Fehlgeschlagene Zustellungen werden bis zu dreimal wiederholt.

Ereignis	Bedeutung
process.created	Ein neuer Prozess wurde angelegt.
matching.requested	Eine Berater-Anfrage wurde gestellt.
matching.selected	Ein Berater-Vorschlag wurde ausgewählt.
community.post.flagged	Ein Community-Beitrag wartet auf die Moderation.
newsletter.subscribed	Eine neue Newsletter-Anmeldung ist eingegangen.

Beispiel-Payload:

{
  "event": "matching.new_proposal",
  "timestamp": "2026-07-02T09:12:00.000Z",
  "data": {
    "proposalId": "…",
    "processTitle": "…"
  }
}

Jede Anfrage enthält den Header X-AgenticWende-Signature: sha256=<HMAC>. Die Signatur ist der HMAC-SHA256 des rohen Anfrage-Bodys, berechnet mit Ihrem Secret-Token. Prüfen Sie sie auf Ihrer Seite, um die Echtheit der Anfrage sicherzustellen.

Datenexport (CSV)

Ihre Daten gehören Ihnen. Über die folgenden Endpunkte laden Sie sie als CSV-Datei herunter. Der Zugriff erfolgt im angemeldeten Zustand; je nach Rolle stehen unterschiedliche Exporte bereit.

Endpunkt	Inhalt	Rolle
/api/export/processes	Ihre dokumentierten Prozesse als CSV.	Unternehmen
/api/export/leads	Eingegangene Anfragen als CSV.	Berater
/api/export/portfolio	Ihr Berater-Portfolio als CSV.	Berater

Wir bauen die API weiter aus.

Fehlt Ihnen ein Endpunkt oder ein Ereignis? Schreiben Sie uns an info@agenticwende.de – wir richten die Plattform gezielt an den Bedürfnissen des Mittelstands aus.