API & Webhooks
Diese Seite beschreibt die derzeit vorhandenen Integrationspunkte: organisationsgebundene API-Schlüssel, Webhooks, CSV-Exporte und den read-only Kontextzugang für externe Assistenten. API-Schlüssel, Webhooks und Freigaben richten Organisationsverantwortliche im angemeldeten Bereich unter Einstellungen › Integrationen ein.
API-Schlüssel & Authentifizierung
In den Integrationen-Einstellungen erzeugt die Organisationsverwaltung einen organisationsgebundenen 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>Kontextzugang für externe Assistenten
Der MCP-Endpunkt unter /api/mcp stellt ausschließlich zuvor geprüfte und veröffentlichte Prozesskontexte der eigenen Organisation bereit. Der Zugriff ist read-only, benötigt einen passenden organisationsgebundenen API-Schlüssel und ist getrennt von optionalen Schreibfunktionen.
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. |
Beispiel-Payload:
{
"event": "matching.requested",
"timestamp": "2026-07-02T09:12:00.000Z",
"data": {
"job_id": "…",
"process_id": "…",
"org_id": "…",
"consultant_id": "…"
}
}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.