System Integrationen

Verbinden Sie Exeoflow mit externen Systemen und Diensten.

Überblick

Exeoflow bietet umfangreiche Integrationsmöglichkeiten:

• Authentifizierung: SSO, LDAP, Active Directory
• E-Mail: Gmail, Outlook, SMTP
• Kalender: Google Calendar, Outlook Calendar
• Cloud-Speicher: Google Drive, Dropbox, OneDrive
• Kommunikation: Slack, Microsoft Teams
• Buchhaltung: DATEV, Lexoffice, sevDesk
• CRM: Salesforce, HubSpot
• Projektmanagement: Jira, Asana
• Webhooks: Beliebige REST APIs

Authentifizierung

Single Sign-On (SSO)

SAML 2.0:

1. Gehen Sie zu Einstellungen → Integrationen → SSO
2. Wählen Sie "SAML 2.0"
3. Konfigurieren Sie:
   • Identity Provider URL
   • Entity ID
   • X.509 Zertifikat
4. Testen Sie die Verbindung
5. Aktivieren Sie SSO

OAuth 2.0 / OpenID Connect:

Unterstützte Provider:

• Google Workspace
• Microsoft Azure AD
• Okta
• Auth0

LDAP / Active Directory

# LDAP-Konfiguration
LDAP_URL=ldap://ldap.ihredomain.de:389
LDAP_BIND_DN=cn=admin,dc=ihredomain,dc=de
LDAP_BIND_PASSWORD=admin-passwort
LDAP_SEARCH_BASE=ou=users,dc=ihredomain,dc=de
LDAP_SEARCH_FILTER=(uid={{username}})

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → LDAP
2. Geben Sie die LDAP-Konfiguration ein
3. Testen Sie die Verbindung
4. Konfigurieren Sie Attribut-Mapping
5. Aktivieren Sie LDAP-Authentifizierung

E-Mail-Integration

Gmail

1. Gehen Sie zu Einstellungen → Integrationen → E-Mail
2. Wählen Sie "Gmail"
3. Klicken Sie auf "Mit Google verbinden"
4. Autorisieren Sie Exeoflow
5. Konfigurieren Sie:
   • Synchronisation von E-Mails
   • Benachrichtigungen
   • E-Mail-Vorlagen

Microsoft Outlook

1. Wählen Sie "Outlook"
2. Klicken Sie auf "Mit Microsoft verbinden"
3. Melden Sie sich mit Ihrem Microsoft-Konto an
4. Erteilen Sie die erforderlichen Berechtigungen

SMTP (Eigener Server)

# SMTP-Konfiguration
MAIL_HOST=smtp.ihredomain.de
MAIL_PORT=587
MAIL_ENCRYPTION=tls
MAIL_USER=noreply@ihredomain.de
MAIL_PASSWORD=mail-passwort
MAIL_FROM_NAME=Exeoflow
MAIL_FROM_ADDRESS=noreply@ihredomain.de

Kalender-Integration

Google Calendar

Features:

• Automatische Terminerfassung
• Synchronisation von Arbeitszeiten
• Meeting-Integration
• Abwesenheitskalender

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → Kalender
2. Wählen Sie "Google Calendar"
3. Autorisieren Sie den Zugriff
4. Wählen Sie zu synchronisierende Kalender
5. Konfigurieren Sie Synchronisationsregeln

Outlook Calendar

Analog zu Google Calendar mit Microsoft-Authentifizierung.

Cloud-Speicher

Google Drive

Verwendung:

• Dokumente speichern
• Automatische Synchronisation
• Versionierung
• Freigaben

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → Cloud-Speicher
2. Wählen Sie "Google Drive"
3. Autorisieren Sie den Zugriff
4. Wählen Sie den Zielordner
5. Konfigurieren Sie Synchronisationsregeln

Dropbox

1. Wählen Sie "Dropbox"
2. Autorisieren Sie Exeoflow
3. Wählen Sie den Synchronisationsordner

OneDrive / SharePoint

1. Wählen Sie "OneDrive" oder "SharePoint"
2. Melden Sie sich mit Microsoft-Konto an
3. Wählen Sie Bibliotheken für Synchronisation

Kommunikation

Slack

Features:

• Benachrichtigungen in Slack-Channels
• Zeiterfassung per Slash-Command
• Spesen einreichen
• Aufgaben-Updates

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → Slack
2. Klicken Sie auf "Zu Slack hinzufügen"
3. Wählen Sie Ihren Workspace
4. Autorisieren Sie die App
5. Konfigurieren Sie:
   • Benachrichtigungs-Channels
   • Slash-Commands
   • Bot-Verhalten

Verfügbare Slash-Commands:

/exeo time start [Projekt]    - Zeiterfassung starten
/exeo time stop               - Zeiterfassung stoppen
/exeo expense [Betrag]        - Spesen einreichen
/exeo tasks                   - Meine Aufgaben anzeigen

Microsoft Teams

Ähnliche Integration wie Slack:

1. Wählen Sie "Microsoft Teams"
2. Installieren Sie die Exeoflow-App aus dem Teams Store
3. Konfigurieren Sie Benachrichtigungen und Bot

Buchhaltung

DATEV

Features:

• Export von Spesen
• Zeiterfassungs-Export
• Rechnungsdaten
• Mitarbeiterstammdaten

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → Buchhaltung
2. Wählen Sie "DATEV"
3. Geben Sie Ihre DATEV-Zugangsdaten ein
4. Konfigurieren Sie Konten-Mapping
5. Testen Sie den Export

Lexoffice

1. Wählen Sie "Lexoffice"
2. Geben Sie Ihren API-Schlüssel ein
3. Konfigurieren Sie Synchronisationsregeln

sevDesk

1. Wählen Sie "sevDesk"
2. Autorisieren Sie die Verbindung
3. Konfigurieren Sie Daten-Mapping

CRM-Integration

Salesforce

Features:

• Kontakte synchronisieren
• Projekte mit Opportunities verknüpfen
• Zeiterfassung auf Cases
• Automatische Updates

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → CRM
2. Wählen Sie "Salesforce"
3. Autorisieren Sie mit Salesforce-Konto
4. Konfigurieren Sie Feld-Mapping
5. Definieren Sie Synchronisationsregeln

HubSpot

1. Wählen Sie "HubSpot"
2. Geben Sie Ihren API-Schlüssel ein
3. Konfigurieren Sie Kontakt- und Deal-Synchronisation

Projektmanagement

Jira

Features:

• Issues als Aufgaben importieren
• Zeiterfassung auf Jira-Tickets
• Status-Synchronisation
• Kommentare synchronisieren

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → Projektmanagement
2. Wählen Sie "Jira"
3. Geben Sie Ihre Jira-URL ein
4. Erstellen Sie einen API-Token in Jira
5. Konfigurieren Sie Projekt-Mapping
6. Aktivieren Sie Synchronisation

Asana

1. Wählen Sie "Asana"
2. Autorisieren Sie mit Asana-Konto
3. Wählen Sie zu synchronisierende Projekte

Webhooks

Ausgehende Webhooks

Senden Sie Daten an externe Systeme:

Einrichtung:

1. Gehen Sie zu Einstellungen → Integrationen → Webhooks
2. Klicken Sie auf "Neuer Webhook"
3. Konfigurieren Sie:
   • URL: Ziel-Endpoint
   • Events: Welche Ereignisse auslösen
   • Methode: POST, PUT, etc.
   • Headers: Authentifizierung
   • Payload: Datenformat

Verfügbare Events:

• time.created - Neue Zeiterfassung
• time.updated - Zeiterfassung aktualisiert
• expense.created - Neue Spesen
• expense.approved - Spesen genehmigt
• task.created - Neue Aufgabe
• task.completed - Aufgabe abgeschlossen
• user.created - Neuer Benutzer
• project.created - Neues Projekt

Beispiel-Payload:

{
  "event": "time.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "workspace_id": "ws_123",
  "data": {
    "id": "time_456",
    "user_id": "user_789",
    "project_id": "proj_012",
    "duration": 3600,
    "description": "Meeting mit Kunde"
  }
}

Eingehende Webhooks

Empfangen Sie Daten von externen Systemen:

1. Erstellen Sie einen Webhook-Endpoint
2. Kopieren Sie die Webhook-URL
3. Konfigurieren Sie im externen System
4. Definieren Sie Verarbeitungsregeln

API-Integration

REST API

Exeoflow bietet eine vollständige REST API:

Authentifizierung:

# API-Token erstellen
curl -X POST https://api.exeoflow.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "password"}'

Beispiel-Anfragen:

# Zeiterfassung erstellen
curl -X POST https://api.exeoflow.com/v1/time \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj_123",
    "duration": 3600,
    "description": "Development"
  }'

# Spesen abrufen
curl -X GET https://api.exeoflow.com/v1/expenses \
  -H "Authorization: Bearer YOUR_TOKEN"

Dokumentation:

Vollständige API-Dokumentation unter: https://api.exeoflow.com/docs

Zapier / Make (Integromat)

Zapier

Verbinden Sie Exeoflow mit 5000+ Apps:

1. Suchen Sie nach "Exeoflow" in Zapier
2. Erstellen Sie einen neuen Zap
3. Wählen Sie Trigger und Actions
4. Autorisieren Sie Exeoflow
5. Konfigurieren Sie den Workflow

Beliebte Zaps:

• Neue Zeiterfassung → Google Sheets
• Neue Spesen → E-Mail an Buchhaltung
• Neue Aufgabe → Slack-Benachrichtigung
• Neuer Kontakt in CRM → Exeoflow-Projekt

Make (Integromat)

Ähnliche Integration mit visuellen Workflows.

Best Practices

• Testen Sie Integrationen zunächst in einer Test-Umgebung
• Dokumentieren Sie Ihre Integrations-Konfiguration
• Überwachen Sie Integration-Logs regelmäßig
• Setzen Sie Fehler-Benachrichtigungen ein
• Implementieren Sie Retry-Logik für Webhooks
• Verwenden Sie API-Rate-Limiting
• Sichern Sie API-Schlüssel und Tokens

Troubleshooting

Integration funktioniert nicht

1. Überprüfen Sie Authentifizierung
2. Prüfen Sie API-Limits
3. Kontrollieren Sie Berechtigungen
4. Sehen Sie Logs ein
5. Testen Sie Verbindung

Synchronisations-Probleme

1. Prüfen Sie Feld-Mapping
2. Kontrollieren Sie Datenformate
3. Überprüfen Sie Synchronisationsregeln
4. Manuelle Synchronisation auslösen

Nächste Schritte

• AI Integration - KI-Features nutzen
• Eigenes Hosting - Self-Hosted Integrationen