Koppla en webhook

Titta först

Vad du behöver

• En adress som tar emot en POST med JSON, som börjar med https://. De flesta automationsverktyg ger dig en (se Exempel).
• Administratörsbehörighet i din arbetsyta i UAT Studio.

Koppla din webhook

2

Lägg till webhooken i UAT Studio

Öppna din arbetsyta, klicka på Connections, välj Webhook under Add a connection och klicka på Add. Fyll sedan i:

• Webhook address: adressen från steg 1.
• Send automatically:
  • Only when I click Send on an issue (standard): en administratör bestämmer vilka ärenden som skickas.
  • Every new issue and every status change, by itself: allt skickas direkt.

Klicka på Save settings. Valet under Send automatically sparas så snart du ändrar det.

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

När den skickar

Ett ärende som slås ihop med ett annat som dubblett skickar ingen ny issue.created.

Vad den skickar

En POST med Content-Type: application/json. Alla ärendehändelser har samma form:

{
  "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"
}

Fält kan vara null och vi kan lägga till fält senare, så låt ditt flöde ignorera det som det inte känner till. Skärmbilder och filer skickas aldrig; de stannar i UAT Studio.

Bygga den mottagande sidan

Power Automate

1. Skapa ett Instant cloud flow med triggern When an HTTP request is received, för Anyone.
2. Under Request Body JSON Schema klickar du på Use sample payload to generate schema och klistrar in exemplet ovan.
3. Lägg till ett Condition på event (till exempel: is not equal to test), och sedan de åtgärder du vill ha: en uppgift i Planner, en rad i Excel, ett mejl, ett objekt i SharePoint.
4. Spara flödet. Triggern visar nu HTTP URL: det är webhook-adressen.

Obs: HTTP-triggern är en premium-connector i Power Automate. För att publicera i en Teams-kanal behöver du den inte: använd Microsoft Teams-kopplingen.

Zapier

Skapa en Zap med triggern Webhooks by Zapier › Catch Hook, kopiera adressen, klicka på Test connection i UAT Studio och skicka sedan ett ärende, så att Zapier lär sig fälten. Lägg sedan till den åtgärd du vill ha, till exempel ett meddelande i Slack.

Make

Starta ett scenario med Webhooks › Custom webhook, kopiera adressen och klicka på Redetermine data structure innan du skickar ett ärende från UAT Studio.

Din egen tjänst

Ta emot en POST med JSON, kontrollera headern Authorization mot din hemlighet, svara 200 snabbt och gör det långsamma arbetet efteråt. Meddelanden skickas inte igen efter ett fel, så logga det du tar emot.

Om något går fel

Kommer du fortfarande inte vidare? Mejla [email protected] med meddelandet du ser. Skicka aldrig själva hemligheten till oss.

Vad som lämnar UAT Studio

• Meddelanden skickas bara över HTTPS.
• De innehåller ärendets text, testet och testarens namn, aldrig filer eller skärmbilder. Skicka dem bara till en tjänst som din organisation litar på med den informationen.
• Hemligheten lagras krypterad (AES-256), med nyckeln förvarad separat från databasen. Ingen kan läsa den igen.
• Sätt kopplingen till Off eller ta bort den, så skickas inget mer.