Integrationen

Spedy verbindet sich mit den Tools, die dein Team bereits nutzt, sodass du Code, Projektmanagement und Zeiterfassung synchron halten kannst, ohne zwischen Apps zu wechseln.

Unterstützte Integrationen

Git-Anbieter verbinden

Verknüpfe dein GitHub- oder Bitbucket-Konto mit Spedy, damit Code-Aktivitäten automatisch auf deinen Tickets erscheinen.

GitHub

1. Gehe zu Einstellungen und öffne die Integrationen-Seite
2. Klicke auf Integration hinzufügen und wähle GitHub
3. Autorisiere Spedy über den sicheren Anmeldeflow, auf deine Repositories zuzugreifen
4. Sobald verbunden, ist deine Integration aktiv und einsatzbereit

Bitbucket

Bitbucket verwendet Atlassian API Tokens mit Scopes zur Authentifizierung (Atlassian hat die alten App Passwords eingestellt).

1. Gehe zu id.atlassian.com und erstelle ein API Token mit Scopes -- wähle die Option mit Scopes, nicht das alte Format ohne Scopes
2. Wähle den Bitbucket-Workspace aus, den du verbinden möchtest
3. Vergib folgende Scopes:
   • Read: read:repository:bitbucket, read:webhook:bitbucket, read:user:bitbucket, read:pullrequest:bitbucket, read:workspace:bitbucket
   • Write: write:repository:bitbucket, write:webhook:bitbucket, write:pullrequest:bitbucket
   • Delete: delete:webhook:bitbucket
4. In Spedy unter Einstellungen → Integrationen klicke auf Integration hinzufügen und wähle Bitbucket
5. Gib deine Atlassian-Account-E-Mail ein (nicht deinen Bitbucket-Benutzernamen) und füge das API Token ein
6. Nach erfolgreicher Validierung ist deine Integration aktiv

Wenn ein erforderlicher Scope fehlt, zeigt Spedy dir genau an, welche Scopes benötigt werden.

Commits mit Tickets verknüpfen

Wenn ein Teammitglied eine Ticket-ID in seiner Commit-Nachricht erwähnt -- zum Beispiel fix: resolve login timeout KP-42 -- erkennt Spedy die Referenz automatisch und verknüpft den Commit mit dem Ticket. Der Zugewiesene des Tickets erhält eine Benachrichtigung, und der Commit erscheint im Aktivitäts-Feed des Tickets.

Das funktioniert mit jeder Commit-Nachricht, die eine Ticket-ID enthält, sodass dein Team nicht ändern muss, wie es Commits schreibt.

Verbindung verwalten

Du kannst eine Integration jederzeit über die Einstellungsseite trennen und wieder verbinden. Wenn deine Anmeldedaten ablaufen, informiert Spedy dich und führt dich durch die Wiederverbindung, ohne deine Konfiguration zu verlieren.

Aus Jira importieren

Wenn du von Jira zu Spedy wechselst, macht es das integrierte Migrationstool einfach, deine bestehenden Projekte mitzubringen.

So migrierst du ein Jira-Projekt

1. Gehe zu Einstellungen und öffne die Integrationen-Seite
2. Klicke auf Integration hinzufügen und wähle Jira
3. Gib deine Jira-Site-Adresse und ein Zugriffstoken ein, um dich zu verbinden
4. Wähle das Jira-Projekt, das du importieren möchtest
5. Spedy ordnet deine Jira-Status, Issue-Typen und Prioritäten automatisch den Spedy-Entsprechungen zu
6. Starte die Migration -- deine Tickets, Kommentare, Anhänge und Zuweisungen werden automatisch importiert

Während der Migration

Du kannst den Fortschritt deiner Migration in Echtzeit verfolgen. Wenn etwas schief geht (zum Beispiel eine Netzwerkunterbrechung), kann die Migration pausiert und von dort fortgesetzt werden, wo sie aufgehört hat. Ein detailliertes Protokoll verfolgt jedes importierte Element, damit du überprüfen kannst, ob alles korrekt übertragen wurde.

Aus YouTrack importieren

Wenn du von YouTrack wechselst, bietet Spedy eine ähnliche Migrationserfahrung wie beim Jira-Import.

So migrierst du ein YouTrack-Projekt

1. Gehe zu Einstellungen und öffne die Integrationen-Seite
2. Klicke auf Integration hinzufügen und wähle YouTrack
3. Gib deine YouTrack-URL und ein Zugriffstoken ein
4. Wähle das Projekt, das du importieren möchtest
5. Spedy ordnet deine YouTrack-Felder, Status und Prioritäten den Spedy-Entsprechungen zu
6. Starte die Migration -- Tickets, Kommentare und Zuweisungen werden automatisch importiert

Du kannst den Fortschritt verfolgen und ein detailliertes Protokoll einsehen, genau wie beim Jira-Import.

MOCO Zeiterfassungs-Sync

Wenn dein Team MOCO für Zeiterfassung, Abrechnung oder Rechnungsstellung nutzt, kannst du es mit Spedy verbinden, damit Zeiteinträge automatisch synchronisiert werden.

MOCO-Verbindung einrichten

1. Gehe zu Einstellungen und öffne die Integrationen-Seite
2. Klicke auf Integration hinzufügen und wähle MOCO
3. Gib deinen MOCO-API-Schlüssel und die Instanz-URL ein
4. Ordne deine MOCO-Projekte und -Nutzer ihren Spedy-Entsprechungen zu
5. Nach der Verbindung werden in Spedy erfasste Zeiteinträge zu MOCO synchronisiert

Die Synchronisation hält deine Abrechnungsdaten in MOCO aktuell, ohne manuellen Aufwand. Du kannst die Nutzer- und Board-Zuordnungen auf der Integrations-Einstellungsseite verwalten.

GitHub Issues Sync

Wenn du Issues auf GitHub verwaltest und sie in Spedy bearbeiten möchtest, erstellt der GitHub Issues Sync eine bidirektionale Live-Verbindung zwischen einem GitHub-Repository und einem Spedy-Board. Issues werden zu Tickets, Statusänderungen fließen in beide Richtungen, und Kommentare bleiben synchron.

Sync-Modi

GitHub Issues Sync einrichten

1. Stelle sicher, dass du bereits eine GitHub-Integration verbunden hast (siehe Git-Anbieter verbinden oben)
2. Gehe zu Einstellungen → Integrationen → GitHub Issues
3. Wähle ein Board und klicke auf Sync konfigurieren
4. Wähle das Repository, das du synchronisieren möchtest
5. Konfiguriere das Status-Mapping:
   • Eingehend (GitHub → Spedy): Ordne GitHub-Issue-Status (open, closed) und optional Labels den Spedy-Board-Status zu
   • Ausgehend (Spedy → GitHub): Ordne Spedy-Board-Status den GitHub-Status zu (open oder closed)
6. Optional konfigurieren:
   • Label-Mapping: GitHub-Labels auf Spedy-Prioritäten abbilden (z.B. bug → Hoch, enhancement → Mittel)
   • Filter-Labels: Nur Issues mit bestimmten Labels synchronisieren (leer lassen für alle)
   • Kommentar-Sync: Bidirektionale Kommentar-Spiegelung aktivieren oder deaktivieren
   • Polling-Intervall: Wie oft Spedy GitHub auf Änderungen prüft (5--60 Minuten, Standard 5)
7. Konfiguration speichern -- Spedy pollt sofort GitHub und importiert passende Issues

So funktioniert der Sync

Eingehend (GitHub → Spedy):

• Wenn ein neues Issue auf GitHub geöffnet wird, erstellt Spedy ein Ticket auf dem verbundenen Board mit dem zugeordneten Status und der Priorität
• Wenn ein Issue geschlossen oder wiedereröffnet wird, aktualisiert sich der Ticket-Status entsprechend
• Wenn jemand ein GitHub-Issue kommentiert, erscheint der Kommentar am Spedy-Ticket (dem GitHub-Autor zugeordnet)

Ausgehend (Spedy → GitHub):

• Wenn sich der Status eines Tickets in Spedy zu einer Spalte ändert, die auf closed gemappt ist, wird das verknüpfte GitHub-Issue automatisch geschlossen
• Wenn ein Ticket zurück zu einem open-gemappten Status wechselt, wird das GitHub-Issue wiedereröffnet
• Kommentare, die in Spedy hinzugefügt werden, werden auf dem GitHub-Issue gepostet

Loop-Prävention: Spedy ignoriert eingehende Updates, die durch den eigenen ausgehenden Sync ausgelöst wurden, sodass Änderungen nicht hin und her pendeln.

Sync überwachen

Auf der Sync-Konfigurationsseite siehst du:

• Synchronisierte Tickets: Wie viele Issues zwischen GitHub und Spedy verknüpft sind
• Sync-Status: Ob jedes Ticket synchronisiert, ausstehend oder fehlerhaft ist
• Audit-Log: Eine detaillierte Historie jedes Sync-Events -- nützlich zur Fehlersuche

Du kannst jederzeit eine manuelle Aktualisierung auslösen, um GitHub erneut nach neuen oder geänderten Issues zu durchsuchen.

Sync entfernen

Das Löschen der Sync-Konfiguration trennt alle verknüpften Tickets. Die Tickets bleiben in Spedy, werden aber nicht mehr aktualisiert, wenn sich das GitHub-Issue ändert. Du kannst den Sync jederzeit erneut einrichten.

Webhooks

Spedy unterstützt ausgehende Webhooks, damit du externe Systeme benachrichtigen kannst, wenn Ereignisse in deiner Organisation stattfinden. Konfiguriere Webhook-Endpunkte, um HTTP-Callbacks für Ereignisse wie Ticket-Erstellung, Aktualisierungen, Statusänderungen und mehr zu erhalten.

Webhook einrichten

1. Gehe zu Einstellungen und öffne die Webhooks-Seite
2. Klicke auf Webhook-Endpunkt erstellen
3. Gib einen Namen, die Ziel-URL ein und wähle, welche Ereignisse abonniert werden sollen
4. Kopiere das Signing-Secret -- Spedy signiert jede Zustellung mit HMAC-SHA256, damit du die Authentizität verifizieren kannst

Jede Zustellung wird protokolliert und du kannst den Payload und den Antwortstatus zur Fehlerbehebung einsehen.

Integrations-Berechtigungen

Das Einrichten und Verwalten von Integrationen erfordert die integrations:configure-Berechtigung (standardmäßig in der Administratoren-Gruppe enthalten). Sobald eine Integration aktiv ist, profitieren alle Teammitglieder auf den verbundenen Boards automatisch davon -- keine individuelle Einrichtung nötig.