UAT Studioby Salvion
Hilfe · Verbindungen

Einen Webhook verbinden

Senden Sie Issues als JSON an Power Automate, Zapier, Make, n8n oder Ihren eigenen Dienst und leiten Sie sie dorthin weiter, wo Ihr Team arbeitet: Slack, ServiceNow, eine Tabelle oder ein Ticketsystem, mit dem wir noch keine Verbindung haben.

Dauer etwa 10 MinutenWer ein Workspace-Admin und jemand, der den Flow bautPakete Team, Business, Partner und Enterprise
In einer Minute

Erst ansehen

Einen Webhook für Power Automate, Zapier oder Make einrichten: die Adresse, automatisches Senden, das Secret, ein Test und die gesendete Nachricht (51 Sekunden, Untertitel im Bild).
Bevor Sie beginnen

Was Sie brauchen

  • Eine Adresse, die einen POST mit JSON annimmt, beginnend mit https://. Die meisten Automatisierungstools liefern Ihnen eine (siehe Beispiele).
  • Admin-Rechte in Ihrem UAT Studio Workspace.
Sie nutzen Jira, Azure DevOps oder Teams?Verwenden Sie stattdessen diese Verbindungen: Sie legen echte Tickets mit den Dateien an, holen den Status zurück und führen Duplikate zusammen. Siehe die Übersicht aller Anleitungen. Ein Webhook sendet nur; er bekommt keine Antwort zurück.
Einrichten · einmal pro Adresse

Ihren Webhook verbinden

1

Die Adresse Ihres Flows besorgen

Erstellen Sie zuerst die Empfangsseite in dem Tool, das Sie verwenden, und kopieren Sie ihre Adresse. Möchten Sie die Nachrichten ansehen, bevor Sie etwas bauen? Öffnen Sie webhook.site: Es gibt Ihnen eine temporäre Adresse und zeigt alles, was daran gesendet wird. Nur mit Testdaten verwenden.

2

Den Webhook in UAT Studio hinzufügen

Öffnen Sie Ihren Workspace, klicken Sie auf Connections, wählen Sie unter Add a connection die Option Webhook und klicken Sie auf Add. Füllen Sie dann aus:

  • Webhook address: die Adresse aus Schritt 1.
  • Send automatically:
    • Only when I click Send on an issue (Standard): Ein Admin entscheidet, welche Issues hinausgehen.
    • Every new issue and every status change, by itself: Alles geht sofort hinaus.

Klicken Sie auf Save settings. Die Auswahl unter Send automatically wird gespeichert, sobald Sie sie ändern.

Die Webhook-Verbindung: Adresse ausgefüllt, Send automatically auf jedes neue Issue und jede Statusänderung gesetzt
3

Ein Secret hinzufügen (optional, empfohlen)

Damit Ihr Flow weiß, dass eine Nachricht wirklich von UAT Studio kommt, denken Sie sich ein langes zufälliges Secret aus (mindestens 8 Zeichen, besser 32 oder mehr), fügen Sie es unter Secret (optional) ein und klicken Sie auf Store token. Jede Nachricht trägt dann den Header:

Authorization: Bearer <Ihr Secret>

Lassen Sie Ihren Flow Nachrichten ohne den richtigen Header ablehnen. Das Secret wird verschlüsselt gespeichert und kann nicht ausgelesen werden; fügen Sie ein neues ein, um es zu ersetzen.

4

Verbindung testen

Klicken Sie auf Test connection. UAT Studio sendet:

{ "event": "test", "message": "Test message from UAT Studio" }

Jede Antwort von 200 bis 299 gilt als Erfolg; Sie sehen The webhook answered 200. Sorgen Sie dafür, dass Ihr Flow das Test-Event ohne Fehler annimmt oder überspringt.

Nutzung

Wann gesendet wird

EventWann
issue.sentEin Admin klickt bei einem Issue auf Send to Webhook. Immer verfügbar, solange die Verbindung On ist.
issue.createdEin Tester meldet ein neues Issue. Nur wenn Send automatically auf jedes neue Issue steht.
issue.status_changedDer Status eines Issues ändert sich, zum Beispiel auf Ready for retest oder Closed. Nur mit Send automatically. Enthält from und to.
testSie klicken auf Test connection.

Ein Issue, das als Duplikat in ein anderes zusammengeführt wird, sendet kein neues issue.created.

Referenz

Was gesendet wird

Ein POST mit Content-Type: application/json. Alle Issue-Events haben denselben Aufbau:

{
  "event": "issue.status_changed",
  "project": { "id": "6b1f…", "name": "CRM UAT" },
  "issue": {
    "id": "a41c…",
    "key": "ISS-012",
    "title": "Save button greyed out",
    "description": "After changing the phone number, Save stays grey.",
    "severity": "High",
    "priority": "High",
    "status": "Ready for retest",
    "assignee": "Dev team",
    "ticket": "PORTAL-41",
    "ticket_url": "https://acme.atlassian.net/browse/PORTAL-41"
  },
  "test_case": { "num": 4, "title": "Edit a contact", "step": 3 },
  "reported_by": "Tess Tester",
  "from": "In progress",
  "to": "Ready for retest",
  "url": "https://app.uat.studio/p/6b1f…/issues"
}
FeldBedeutung
eventissue.sent, issue.created, issue.status_changed oder test.
projectDas UAT-Projekt: ID und Name.
issue.keyDie Nummer in UAT Studio, etwa ISS-012. Verwenden Sie issue.id, um dasselbe Issue in späteren Nachrichten wiederzuerkennen.
issue.severityCritical, High, Medium oder Low. issue.priority: High, Medium oder Low.
issue.statusDer Status in UAT Studio: New, In progress, Ready for retest, Closed oder Rejected.
issue.ticketDas verknüpfte Jira- oder Azure-DevOps-Ticket, falls vorhanden; sonst null.
test_caseTest und Schrittnummer, in denen das Issue gefunden wurde; null bei einem Issue außerhalb eines Tests. Bei issue.sent außerdem action und expected (erwartetes Ergebnis) des Schritts.
reported_byDer Name des Testers, der es gefunden hat.
from, toNur bei issue.status_changed: der alte und der neue Status.
urlDie Issues des Projekts in UAT Studio. Zum Öffnen ist eine Anmeldung nötig.

Felder können null sein, und wir fügen eventuell später Felder hinzu; lassen Sie Ihren Flow also ignorieren, was er nicht kennt. Screenshots und Dateien werden nie gesendet; sie bleiben in UAT Studio.

Beispiele

Die Empfangsseite bauen

Power Automate

  1. Erstellen Sie einen Instant cloud flow mit dem Trigger When an HTTP request is received, für Anyone.
  2. Klicken Sie unter Request Body JSON Schema auf Use sample payload to generate schema und fügen Sie das Beispiel oben ein.
  3. Fügen Sie eine Condition auf event hinzu (zum Beispiel: is not equal to test), dann die gewünschten Aktionen: eine Planner-Aufgabe, eine Zeile in Excel, eine E-Mail, ein Element in SharePoint.
  4. Speichern Sie den Flow. Der Trigger zeigt jetzt die HTTP URL: Das ist die Webhook-Adresse.

Hinweis: Der HTTP-Trigger ist in Power Automate ein Premium-Connector. Zum Posten in einem Teams-Kanal brauchen Sie ihn nicht: Verwenden Sie die Microsoft-Teams-Verbindung.

Zapier

Erstellen Sie einen Zap mit dem Trigger Webhooks by Zapier › Catch Hook, kopieren Sie die Adresse, klicken Sie in UAT Studio auf Test connection und senden Sie dann ein Issue, damit Zapier die Felder lernt. Fügen Sie dann die gewünschte Aktion hinzu, etwa eine Nachricht in Slack.

Make

Starten Sie ein Szenario mit Webhooks › Custom webhook, kopieren Sie die Adresse und klicken Sie auf Redetermine data structure, bevor Sie ein Issue aus UAT Studio senden.

Ihr eigener Dienst

Nehmen Sie einen POST mit JSON an, prüfen Sie den Header Authorization gegen Ihr Secret, antworten Sie schnell mit 200 und erledigen Sie die langsame Arbeit danach. Nach einem Fehler werden Nachrichten nicht erneut gesendet; protokollieren Sie also, was Sie empfangen.

Hilfe

Wenn etwas schiefgeht

Sie sehenWas zu tun ist
The webhook answered 401 or 403Ihr Flow lehnt die Nachricht ab: Prüfen Sie das Secret auf beiden Seiten oder ob der Flow von jedem aufgerufen werden darf.
The webhook answered 404Die Adresse ist falsch, oder der Flow wurde entfernt oder abgeschaltet. Kopieren Sie die Adresse erneut.
The webhook answered 400 or 500Ihr Flow nimmt die Nachricht nicht an. Oft verarbeitet er das Event test nicht oder ein Feld, das null ist. Sehen Sie sich den Ausführungsverlauf des Flows an.
Für neue Issues kommt nichts anPrüfen Sie, ob Send automatically auf jedes neue Issue steht und die Verbindung On ist. Senden Sie dann ein Issue manuell, um die Antwort Ihres Flows zu sehen.
Keine Schaltfläche Send to WebhookNur Admins sehen sie, und nur wenn die Verbindung On ist.
Connections are not part of your planVerbindungen gehören zu Team, Business, Partner und Enterprise und sind als Add-on für Project erhältlich. Ihr Admin kann unter Plan & billing upgraden.

Kommen Sie nicht weiter? Schreiben Sie an [email protected] mit der Meldung, die Sie sehen. Senden Sie uns nie das Secret selbst.

Sicherheit

Was UAT Studio verlässt

  • Nachrichten gehen nur über HTTPS hinaus.
  • Sie enthalten den Text des Issues, den Test und den Namen des Testers, nie Dateien oder Screenshots. Senden Sie sie nur an einen Dienst, dem Ihre Organisation diese Informationen anvertraut.
  • Das Secret wird verschlüsselt gespeichert (AES-256), der Schlüssel getrennt von der Datenbank. Niemand kann es wieder auslesen.
  • Schalten Sie die Verbindung auf Off oder entfernen Sie sie, und es wird nichts mehr gesendet.