Schnittstellen
Sentry verbinden
Offene Fehler deiner Sentry-Projekte erscheinen in den Projekten, neue sofort.
Wo du verbindest
In VentionDesk unter Betrieb › Quellen › „Quelle hinzufügen“, Kategorie Fehler, dann Sentry. Verbinden, bearbeiten und entfernen darf nur der Inhaber.
Schritt für Schritt
- Öffne in Sentry Settings › Developer Settings › Custom Integrations und klicke auf „Create New Integration" › „Internal Integration". Name: „VentionDesk".
- Berechtigungen so knapp wie möglich: Project „Read", Issue & Event „Read", Organization „Read", alles andere „No Access". Mehr braucht VentionDesk nicht — es ändert in Sentry nichts.
- Unter „Webhooks" das Häkchen bei „issue" setzen. Die Webhook-Adresse zeigt VentionDesk nach dem Speichern unter „Betrieb" › „Quellen" › Sentry; trage sie danach als „Webhook URL" ein.
- Speichere die Integration, kopiere unter „Tokens" das Token und unter „Credentials" das Client Secret und trage beides hier mit dem Organisations-Slug ein. VentionDesk prüft den Zugang mit einer Abfrage der offenen Issues.
- VentionDesk holt alle zehn Minuten die offenen Issues der zugeordneten Projekte; der Webhook meldet neue und wieder geöffnete sofort. Ordne danach in der Projektakte unter „Analytics" › „Fehlerquelle zuordnen" jedes Projekt seinem Projekt beim Anbieter zu.
- VentionDesk übernimmt je Fehler nur Kennung, gekürzten Titel (E-Mail- und IP-Adressen darin werden unkenntlich gemacht), Stufe, Status, Anzahl der Ereignisse und betroffenen Nutzer, erstes und letztes Auftreten und den Link zum Anbieter. Stacktraces, Ereignisse, Nutzerdaten, IP-Adressen und Anfragen bleiben beim Anbieter und werden auch aus Webhooks nicht gespeichert.
Was der Dialog abfragt
| Feld | Angabe | Woher |
|---|---|---|
| API-Token | Pflicht · geheim | Das Token der Internal Integration (Settings › Developer Settings › Custom Integrations › deine Integration › Tokens). |
| Organisations-Slug | Pflicht | Steht in der Adresse: sentry.io/organizations/<slug>/ oder <slug>.sentry.io. |
| Region | freiwillig | „de" für Konten in der EU-Region (de.sentry.io), sonst leer lassen. Selbst betriebene Sentry-Server werden nicht unterstützt. |
| Client Secret | freiwillig · geheim | Nur für den Webhook: Damit prüft VentionDesk die Signatur (Sentry-Hook-Signature). Steht in der Integration unter „Credentials". |
| Aufgaben automatisch anlegen | freiwillig | „an" (Vorgabe) oder „aus". An: Ein Fehler, der die Schwelle erreicht oder die Stufe „fatal" trägt, wird einmal als Aufgabe für Claude angelegt. |
| Schwelle (Ereignisse) | freiwillig | Ab so vielen Ereignissen entsteht die Aufgabe. Leer lassen für 10. |
Geheime Angaben speichert VentionDesk verschlüsselt und zeigt sie nie wieder an. Gespeichert wird erst, wenn der Anbieter den Zugang bestätigt; wer eine Anbindung bearbeitet und ein geheimes Feld leer lässt, behält den bisherigen Wert.
Alle Anbieter im Überblick: Schnittstellen · Webhook-Adressen: Webhooks