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-, GitLab- 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

Damit der CI/CD-Status in der Pipelines-Ansicht erscheint, braucht die GitHub App zusätzlich die richtigen Webhook-Event-Abonnements (Check run, Check suite, Workflow run, …). Die genaue Liste und der „Checks: Read zuerst"-Stolperstein sind unter Pipelines → CI-Events einrichten dokumentiert.

GitLab

GitLab verwendet ein Personal Access Token zur Authentifizierung. Sowohl gitlab.com als auch selbst gehostete GitLab-Instanzen werden unterstützt.

1. Gehe zu deiner GitLab-Instanz und erstelle ein Personal Access Token mit dem api-Scope
2. In Spedy unter Einstellungen → Integrationen klicke auf Integration hinzufügen und wähle GitLab
3. Gib die URL deiner GitLab-Instanz ein (z. B. https://gitlab.com oder deine Self-Hosted-URL) und füge das Token ein
4. Spedy validiert die Zugangsdaten und zeigt den verbundenen Nutzer an
5. Nach erfolgreicher Validierung ist deine Integration aktiv

Nach dem Verbinden kannst du unter Board-Einstellungen → Integrationen → Repository hinzufügen GitLab-Repositories mit deinen Boards verknüpfen. Spedy erstellt automatisch einen Webhook im GitLab-Repository, um Push-, Merge-Request- und Pipeline-Events in Echtzeit zu empfangen. Du benötigst mindestens die Rolle Maintainer im GitLab-Projekt, damit der Webhook erstellt werden kann.

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.

Repositories mit einem Board verknüpfen

Unter Board-Einstellungen → Integrationen kannst du Repositories mit deinem Board verknüpfen. Die Repository-Auswahl unterstützt Mehrfachauswahl: Markiere die gewünschten Repos per Checkbox oder klicke Alle auswählen, um alle verfügbaren Repos auf einmal zu verknüpfen. Falls einzelne Repos nicht hinzugefügt werden können (z. B. weil sie bereits verknüpft sind), werden die übrigen trotzdem verknüpft.

Du kannst auch von einem Ticket aus starten: Ist der Code-Tab eines Tickets leer, weil noch kein Repository mit dem Projekt verknüpft ist, erscheint dort ein Button Repository verknüpfen, der dich direkt in die Integrations-Einstellungen des Boards führt. Der Button erscheint, wenn du Integrationen konfigurieren oder das Board bearbeiten darfst.

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.

Jira und Spedy synchron halten

Über einen einmaligen Import hinaus kann Spedy ein Board und ein Jira-Projekt in einer Live-Synchronisation in beide Richtungen halten: Status, Kommentare und jetzt auch Zuständige laufen in beide Richtungen.

Zuständige über eine Benutzer-Zuordnung synchronisieren

Damit Zuständige synchronisieren, muss Spedy wissen, welcher Jira-Benutzer welchem Spedy-Benutzer entspricht.

1. Gehe zu Einstellungen → Integrationen → Jira → Sync und wähle das Board
2. Öffne den Abschnitt Benutzer-Zuordnung
3. Ordne jeden Jira-Benutzer einem Spedy-Benutzer zu. Klicke E-Mail-Treffer übernehmen, damit Spedy Paare mit übereinstimmenden E-Mail-Adressen vorausfüllt, und passe einzelne Zeilen bei Bedarf an
4. Speichere die Konfiguration

Sobald die Zuordnung steht, synchronisieren Zuständige in beide Richtungen:

• Jira → Spedy: beim Import und bei jeder Aktualisierung erhält das Ticket den zugeordneten Bearbeiter
• Spedy → Jira: weist du ein Ticket in Spedy neu zu, wird der Bearbeiter in Jira gesetzt

Was du wissen solltest:

• Nur zugeordnete Benutzer synchronisieren. Ein nicht zugeordneter Jira-Bearbeiter lässt das Spedy-Ticket ohne Zuweisung, und ein nicht zugeordneter Spedy-Bearbeiter wird nie an Jira übertragen -- so wird niemand versehentlich entfernt.
• Die Zuordnung ist 1:1 und gilt pro Board, sodass unterschiedliche Boards unterschiedliche Teams abbilden können.

Vom Ticket direkt zum Jira-Vorgang springen

Ist ein Ticket mit Jira synchronisiert, erscheint im Ticket-Kopf ein Jira-Symbol. Ein Klick öffnet den passenden Jira-Vorgang in einem neuen Tab. Der Link ist für jede Rolle verfügbar, die das Ticket sehen darf -- ohne zusätzliche Integrations-Berechtigung.

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.

Aus GitLab importieren

Wenn du von GitLab zu Spedy wechselst, kannst du mit der GitLab-Integration ganze Projekte mit allen Issues, Kommentaren und Zuweisungen importieren.

So migrierst du ein GitLab-Projekt

1. Gehe zu Einstellungen → Integrationen → GitLab
2. Verbinde deine GitLab-Instanz mit einem Personal Access Token (siehe Git-Anbieter verbinden oben)
3. Klicke auf Projekt importieren und wähle das GitLab-Projekt, das du importieren möchtest
4. Status zuordnen: GitLab kennt „offen" und „geschlossen" als Grundzustände. Ordne jeden einem Spedy-Board-Status zu. Optional kannst du Labels als zusätzliche Status-Hinweise nutzen (z. B. „opened:doing" einem bestimmten Status zuweisen)
5. Nutzer zuordnen: Spedy schlägt automatisch Zuordnungen per E-Mail-Abgleich vor. Passe die Zuordnungen manuell an -- Issues von nicht zugeordneten Nutzern werden ohne Bearbeiter importiert
6. Prüfe die Zusammenfassung und klicke Start -- Spedy erstellt ein neues Board und beginnt mit dem Import

Was importiert wird

• Issues mit Titel, Beschreibung, Status und Fälligkeitsdaten
• Kommentare mit Autor und Zeitstempel
• Zuweisungen gemäß der konfigurierten Nutzer-Zuordnung
• Externe Referenzen -- jedes Ticket verweist zurück auf das Original-Issue in GitLab (z. B. GL-42)
• Priorität und Story Points -- werden aus vorhandenen Labels abgeleitet, sofern vorhanden

Während der Migration

Der Fortschritt wird in Echtzeit angezeigt, mit Zählern für importierte, ausstehende und fehlgeschlagene Issues. Bei einer Unterbrechung (z. B. durch ein Netzwerkproblem) setzt die Migration beim letzten Checkpoint fort. Du kannst jederzeit pausieren und fortsetzen. Ein detailliertes Protokoll verfolgt jedes importierte Element.

Migrationshistorie

Alle Migrationen werden auf der GitLab-Integrationsseite aufgelistet -- mit Quellprojekt, Zeitpunkt, Status und Anzahl importierter Issues. Klicke auf eine Migration, um das vollständige Protokoll einzusehen.

Importieren aus Asana, Trello, Monday, ClickUp oder CSV

Spedy unterstützt Einmal-Importe aus Asana, Trello, Monday.com, ClickUp und CSV-Dateien. So kannst du Projekte aus anderen Tools zu Spedy bringen, ohne eine permanente Sync-Verbindung.

So importierst du ein Projekt

1. Gehe zu Einstellungen und öffne die Integrationen-Seite
2. Klicke auf Importe, um die Import-Historie zu sehen und einen neuen Import zu starten
3. Wähle deine Quelle: Asana, Trello, Monday, ClickUp oder CSV
4. Gib deine Zugangsdaten ein (API-Schlüssel / Token) oder lade eine CSV-Datei hoch
5. Spedy schlägt automatisch Status- und User-Mappings vor, basierend auf deinen Quelldaten
6. Prüfe die Zuordnungen, passe sie an und starte den Import

CSV-Import

Der CSV-Importer erkennt gängige Spaltenbezeichnungen automatisch -- z. B. „Title", „Description", „Status", „Assignee" und „Priority". Unterstützte Trennzeichen: Komma, Semikolon, Tab und Pipe.

Wenn deine Header nicht den Standardnamen entsprechen, kannst du die Spalten-Zuordnung manuell festlegen, bevor du den Import startest.

Import-Historie und Protokolle

Alle Importe werden unter Einstellungen → Integrationen → Importe gespeichert. Jeder Eintrag zeigt Quelle, Status, Anzahl importierter Elemente und ein detailliertes Protokoll. Importe können bei Unterbrechung fortgesetzt werden.

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.

Benennung der Buchungsposten

Spedy legt pro Ticket automatisch ein MOCO-Projekt (Buchungsposten) an, wenn Zeit synchronisiert wird. Der Projektname wird aus der externen Referenz des Tickets abgeleitet — dem Wert im Feld „Externe Referenz" in den Ticket-Eigenschaften. Hat ein Ticket keine externe Referenz, wird wie bisher die interne Ticket-Nummer (z. B. ACME-42) verwendet.

Damit können deine MOCO-Buchungsposten kundenseitige Kennungen wie PO-Nummern oder Projektcodes tragen statt interner Ticket-IDs.

Alles auf ein festes MOCO-Projekt buchen

Wenn du keine einzelnen MOCO-Projekte pro Ticket möchtest, kannst du in der Projekt-Zuordnung zusätzlich zum Kunden ein festes MOCO-Projekt wählen. Dann werden alle Zeiteinträge des Spedy-Projekts auf dieses eine MOCO-Projekt gebucht — die Ticket-Referenz und der Titel stehen dabei am Anfang der Buchungsbeschreibung (z. B. #ACME-42 Login-Bug | Debugging), sodass die Zuordnung nachvollziehbar bleibt. Ohne ausgewähltes Projekt bleibt es beim bisherigen Verhalten (ein MOCO-Projekt pro Ticket).

Abrechnungsstatus abgleichen

Wird ein Zeiteintrag in MOCO fakturiert, markiert Spedy ihn als abgerechnet, damit deine Boards den bereits abgerechneten Stand widerspiegeln. Normalerweise passiert das sofort über MOCO-Webhooks -- ein Webhook kann aber gelegentlich verloren gehen (etwa bei einer Sammelrechnung), wodurch ein Eintrag in Spedy fälschlich als noch abrechenbar erscheint.

Damit das nicht passiert, gleicht Spedy den Abrechnungsstatus direkt aus MOCO ab:

• Stündlich automatisch. Ein Hintergrund-Job holt den maßgeblichen Abrechnungsstatus aus MOCO und zieht Spedy nach -- du musst nichts tun.
• Auf Knopfdruck. Klicke unter Einstellungen → Integrationen → MOCO auf Abrechnungsstatus abgleichen, um den Abgleich sofort auszuführen. Spedy zeigt danach, wie viele Einträge als abgerechnet markiert und wie viele zurückgesetzt wurden.

Die MOCO-Sync-Übersicht zeigt neben der synchronisierten und ausstehenden Anzahl auch die Anzahl der abgerechneten Zeiteinträge. Einträge, die als nicht abrechenbar markiert sind, werden vom Abgleich nie verändert.

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.