Integrationen (Webhooks)

Eine Integration ist eine Adresse (Webhook-URL), an die ein anderes System eine Anfrage schicken kann. frego legt daraus eine Aufgabe in deinem Projekt an. Das eignet sich zum Beispiel für Fehlermeldungen von deiner Website, ein Kontaktformular für Kunden oder Fehler aus Sentry.

Neue Integration

1. Öffne im Projekt im Menü Integrationen.
2. Klick auf Integration hinzufügen und gib ihr einen Namen.
3. Wähl den Typ: Generisch oder Sentry.
4. Leg fest, welche Aufgaben erstellt werden sollen: Titel, Priorität, Tag und die Spalte, in die sie kommen.
5. Kopier die Webhook-URL und füg sie im anderen System ein.

Du kannst in einem Projekt mehrere Integrationen haben, jede mit eigener Einstellung und eigener Adresse. Wenn du eine gerade nicht brauchst, schaltest du sie einfach über den Schalter aus.

Generische Integration

Das andere System schickt an die Adresse einen POST-Request mit JSON-Inhalt. Pflichtfeld ist nur description. Optional kann es auch title, priority (high, medium oder low) und tag mitschicken, die deine Standardeinstellung überschreiben. Es kann auch ein Bild mitgeschickt werden, das der Aufgabe als Anhang hinzugefügt wird.

Im Feld description reicht einfacher Text. Es darf auch einfaches HTML enthalten: Absätze, Listen, Links und Bilder. Alles andere, einschließlich Skripte, entfernt frego aus der Beschreibung.

Sentry

Beim Typ Sentry zeigt dir frego direkt in der Integration, wie du sie mit Sentry verbindest. Aus dem Fehler übernimmt frego automatisch Titel, Beschreibung und Priorität der Aufgabe. Taucht derselbe Fehler erneut auf, wird keine neue Aufgabe angelegt.

Wer erfährt davon

Wenn eine Integration eine Aufgabe anlegt, bekommen alle Projektmitglieder eine Benachrichtigung.

FREE oder PRO

Integrationen werden vom Projektinhaber eingerichtet und sind Teil von PRO. Wenn PRO endet, legen bereits bestehende Integrationen trotzdem weiter Aufgaben an. Neue kannst du aber nicht mehr hinzufügen, und bestehende kannst du nicht mehr bearbeiten.

Achtung

Die Adresse der Integration funktioniert wie ein Passwort. Falls sie in falsche Hände gerät, klick auf Token neu generieren. Die alte Adresse funktioniert dann nicht mehr, und du musst die neue im anderen System einrichten.