Zum Hauptinhalt springen

Trello

Verfügbar

Diese Integration ist aktiv und bereit zur Nutzung in Frihet.

Verbinde deine Trello-Boards mit Frihet. Sieh Boards, Listen und Karten direkt in deinem ERP ein, um beim Rechnungsstellen den Projektkontext zu haben.

Wozu dient es?​

Mit integriertem Trello:

  • Boards anzeigen — Sieh alle deine Trello-Boards von Frihet aus ein
  • Listen und Karten anzeigen — Navigiere durch die Struktur deiner Projekte
  • Kontext bei der Rechnungsstellung — Prüfe erledigte Aufgaben, bevor du eine Rechnung erstellst
  • Zentrale Sichtbarkeit — Ohne Wechsel zwischen Anwendungen

Voraussetzungen​

  • Aktives Trello-Konto — trello.com
  • Trello API-Schlüssel — Erhältlich über das Entwicklerportal
  • Autorisierungstoken — Wird bei der Autorisierung deiner Anwendung generiert
  • Frihet Pro oder höher

Trello mit Frihet verbinden​

Schritt 1: Deinen API-Schlüssel erhalten​

  1. Gehe zu trello.com/power-ups/admin
  2. Melde dich bei deinem Trello-Konto an
  3. Klicke auf New, um ein neues Power-Up oder eine Integration zu erstellen
  4. Fülle die Felder aus:
    • Name: "Frihet ERP"
    • Workspace: Wähle deinen Workspace aus
  5. Nach der Erstellung gehe zum Tab API Key
  6. Kopiere deinen API-Schlüssel

Schritt 2: Einen Token generieren​

  1. Klicke auf derselben Seite, neben dem API-Schlüssel, auf den Link Token
  2. Eine Trello-Autorisierungsseite wird geöffnet
  3. Überprüfe die angeforderten Berechtigungen und klicke auf Allow
  4. Kopiere den generierten Token
Zwei Anmeldedaten

Du benötigst beide: den API-Schlüssel und den Token. Kopiere sie, bevor du fortfährst.

Schritt 3: In Frihet konfigurieren​

  1. Gehe zu Einstellungen → Integrationen
  2. Suche nach Trello
  3. Klicke auf Verbinden
  4. Gib deinen API-Schlüssel ein
  5. Gib deinen Token ein
  6. Klicke auf Verbindung überprüfen
  7. Wenn korrekt, werden deine Boards aufgelistet

Wie es funktioniert​

Frihet verwendet die Trello REST API mit Authentifizierung über Query-Parameter:

  1. Du gibst API-Schlüssel und Token an
  2. Frihet fügt beide als Query-Parameter in jede Anfrage ein: ?key=<api-key>&token=<token>
  3. Boards, Listen und Karten werden bei Bedarf abgefragt
  4. Beide Anmeldedaten werden verschlüsselt (AES-256-GCM) in Frihet gespeichert

Synchronisierte Daten​

DatenRichtungHäufigkeit
BoardsTrello → FrihetBei Bedarf
ListenTrello → FrihetBei Bedarf
KartenTrello → FrihetBei Bedarf
MitgliederTrello → FrihetBei jeder Abfrage

Anwendungsfälle​

Freelancer, der Projekte in Trello verwaltet​

Du hast ein Board pro Kunde mit Spalten wie "To Do", "In Bearbeitung" und "Abgeschlossen". Bevor du eine Rechnung stellst, prüfst du die abgeschlossenen Karten aus Frihet, um zu verifizieren, welche Arbeit einzubeziehen ist.

Agentur mit Kunden-Boards​

Dein Team arbeitet mit kundenbezogenen, geteilten Boards. Von Frihet aus kannst du den Status jedes Boards sehen, um zu wissen, wann ein Projekt abrechnungsbereit ist.

Lieferobjekte vor der Rechnungsstellung überprüfen​

Bevor du eine Projekt-Rechnung ausstellst, prüfst du von Frihet aus die Karten des entsprechenden Boards in Trello. Du bestätigst, dass alle Lieferobjekte abgeschlossen sind.

Funktionalitäten​

Boards anzeigen​

  1. Greife von Frihet aus auf den Trello-Bereich zu
  2. Du siehst alle Boards, auf die dein Konto Zugriff hat
  3. Wähle ein Board aus, um dessen Listen und Karten anzuzeigen

Listen und Karten anzeigen​

  1. Wähle ein Board aus
  2. Frihet zeigt die Listen (Spalten) mit ihren Karten an
  3. Jede Karte zeigt Titel, zugewiesene Mitglieder und Labels

Karten navigieren​

  1. Klicke auf eine Karte, um weitere Details anzuzeigen
  2. Sieh dir Beschreibung, Checkliste, Kommentare und Anhänge an
  3. Nutze diese Informationen als Referenz bei der Rechnungsstellung

API-Limits​

Frihet implementiert automatische Drosselung (100 ms zwischen Anfragen), um die Trello API-Limits einzuhalten. Abfragen großer Boards können einige zusätzliche Sekunden dauern.

Fehlerbehebung​

"Authentifizierungsfehler"​

  • Überprüfe, ob der API-Schlüssel und der Token korrekt sind
  • Der Token muss zum selben Konto wie der API-Schlüssel gehören
  • Wenn du den Token widerrufen hast, generiere einen neuen und aktualisiere ihn in Frihet

"Ich sehe nicht alle meine Boards"​

  • Überprüfe, ob dein Konto in Trello Zugriff auf diese Boards hat
  • Private Boards anderer Mitglieder sind nicht sichtbar
  • Wenn du zu einem Board eingeladen bist, hängt der Zugriff von den Board-Berechtigungen ab

"Der Token ist abgelaufen"​

  • Trello-Tokens laufen standardmäßig nicht ab, es sei denn, du konfigurierst sie so
  • Wenn der Token manuell widerrufen wurde, generiere einen neuen
  • Gehe zu trello.com/power-ups/admin, um Tokens zu verwalten

"Ich möchte die Verbindung trennen"​

  1. Gehe zu Einstellungen → Integrationen → Trello
  2. Klicke auf Trennen
  3. Optional widerrufe den Token von Trello aus unter Settings → Applications

Nächste Schritte​