Skip to main content
Integrationen erweitern FTS durch Verbindungen zu anderen Betriebstools. Synchronisieren Sie Cases mit Ticketing-Systemen oder automatisieren Sie Workflows durch Webhooks.

​
Verfügbare Integrationen

​
1. Webhooks (Allgemein)

Senden Sie Case-Events an externe Systeme in Echtzeit. Unterstützte Events:
  • case.created – Neuer Case erstellt
  • case.published – Case veröffentlicht
  • case.updated – Case bearbeitet
  • case.review_submitted – Zur Prüfung eingereicht
  • case.approved – Genehmigt
  • case.rejected – Abgelehnt
Event-Payload (JSON-Beispiel): 
{
  "event": "case.published",
  "case_id": "abc123",
  "title": "Motorlager austauschen",
  "status": "published",
  "timestamp": "2026-04-10T14:30:00Z",
  "workspace_id": "ws-123"
}

​
2. Jira Integration

Verbinden Sie FTS-Cases mit Jira-Tasks: Features:
  • Erstellen Sie Jira-Tickets bei Case-Veröffentlichung
  • Verlinken Sie Cases zu Jira-Issues
  • Synchronisieren Sie Feedback von Jira zu FTS
  • Bi-direktionale Status-Sync (In Prüfung ↔ In Progress)
Setup:
  1. Gehen Sie zu Einstellungen → Integrationen → Jira
  2. Klicken Sie „Authorize Jira”
  3. Anmelden mit Jira-Konto (Admin-Rechte erforderlich)
  4. Wählen Sie Jira-Projekte und Ticket-Typen
  5. Speichern – fertig

​
3. ServiceNow Integration

Synchronisieren Sie FTS-Cases mit ServiceNow ITSM-Tickets. Features:
  • Automatische Ticket-Erstellung in ServiceNow
  • Abbildung von FTS-Status zu ServiceNow-Status
  • Verknüpfung durch Referenznummern
  • Change-Management-Integration (optional)
Setup:
  1. Kontaktieren Sie FTS-Support für ServiceNow-Integration
  2. Admin stellt SOAP/REST-API-Credentials bereit
  3. FTS-Support führt dediziertes Setup durch
  4. Testlauf durchführen
  5. Aktivieren
ServiceNow-Integration ist ab Team-Plan verfügbar. Starter-Plan unterstützt nur Webhooks.

​
Webhook-Verwaltung

​
Neuen Webhook erstellen

1
Gehen Sie zu Einstellungen → Integrationen → Webhooks
2
Klicken Sie „+ Neuer Webhook”
3
Geben Sie eine Beschreibung ein (z.B. “Slack-Benachrichtigungen”)
4
Geben Sie die Webhook-URL ein (z.B. https://hooks.slack.com/services/…)
5
Wählen Sie Events aus Checkboxes:
  • ☑ case.published
  • ☐ case.rejected
  • ☐ case.updated
6
Optional: Authentication (Bearer-Token oder API-Key)
7
Klicken Sie „Erstellen” und testen Sie

​
Webhook-Test

Nach Erstellung können Sie einen Test-Event versenden:
  1. Klicken Sie auf den Webhook in der Liste
  2. Klicken Sie „Test senden”
  3. Wählen Sie ein Event-Beispiel
  4. Überprüfen Sie die Antwort (sollte HTTP 200 sein)
Nutzen Sie Webhook-Debugging-Tools wie Webhook.site, um Events vor Integration zu prüfen.

​
Webhook-Fehler

Falls der Webhook fehlschlägt:
HTTP-CodeBedeutungAktion
200-299ErfolgKeine Aktion erforderlich
400-499Client-FehlerURL oder Auth überprüfen
500-599Server-FehlerZielservice überprüfen, später erneut versuchen

​
API-Zugriff

FTS bietet eine REST-API für erweiterte Integrationen.
API ist aktuell in private beta. Kontaktieren Sie support@ferrufino-tech-solutions.com für Zugang.

​
Beispiel: Case auslesen

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.ferrufino-tech-solutions.com/v1/cases/abc123
Antwort: 
{
  "id": "abc123",
  "title": "Motorlager austauschen",
  "status": "published",
  "category": "Wartung",
  "steps": ["Vorbereitung", "Altes Lager entfernen", ...],
  "created_at": "2026-04-10T14:30:00Z"
}

​
API-Dokumentation

Lesen Sie die vollständige API-Dokumentation auf https://docs.ferrufino-tech-solutions.com/api

​
Best Practices

Erstellen Sie einen Test-Webhook, bevor Sie produktive Events senden.
Webhooks haben ein Retry-System: Fehlgeschlagene Events werden bis 3x erneut versucht (mit exponentieller Backoff-Verzögerung).
Webhooks: Max. 100 Events/Minute pro Workspace. API: Max. 1000 Requests/Stunde pro Token.
  • Verwenden Sie HTTPS für alle Webhooks
  • Aktivieren Sie API-Token-Rotation monatlich
  • Speichern Sie Tokens NICHT im Code (nutzen Sie Umgebungsvariablen)

​
Nächste Schritte

API-Dokumentation

Vollständige API-Referenz

Support kontaktieren

Hilfe bei Integration anfordern