Een webhook koppelen

Wat je nodig hebt

• Een adres dat een POST met JSON aanneemt, beginnend met https://. De meeste automatiseringstools geven je er een (zie Voorbeelden).
• Adminrechten in je workspace van UAT Studio.

Koppel je webhook

2

Voeg de webhook toe in UAT Studio

Open je workspace, klik op Connections, kies Webhook onder Add a connection en klik op Add. Vul dan in:

• Webhook address: het adres uit stap 1.
• Send automatically:
  • Only when I click Send on an issue (standaard): een admin bepaalt welke issues verstuurd worden.
  • Every new issue and every status change, by itself: alles gaat meteen weg.

Klik op Save settings. De keuze onder Send automatically wordt opgeslagen zodra je hem wijzigt.

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

Wanneer er iets verstuurd wordt

Een issue dat als dubbel in een ander wordt samengevoegd, stuurt geen nieuwe issue.created.

Wat er verstuurd wordt

Een POST met Content-Type: application/json. Alle issue-events hebben dezelfde vorm:

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

Velden kunnen null zijn en we voegen later misschien velden toe, dus laat je flow negeren wat hij niet kent. Screenshots en bestanden worden nooit verstuurd; die blijven in UAT Studio.

De ontvangende kant bouwen

Power Automate

1. Maak een Instant cloud flow met de trigger When an HTTP request is received, voor Anyone.
2. Klik onder Request Body JSON Schema op Use sample payload to generate schema en plak het voorbeeld hierboven.
3. Voeg een Condition toe op event (bijvoorbeeld: is not equal to test), en daarna de acties die je wilt: een taak in Planner, een rij in Excel, een mail, een item in SharePoint.
4. Sla de flow op. De trigger toont nu de HTTP URL: dat is het webhookadres.

Let op: de HTTP-trigger is een premium connector in Power Automate. Om in een Teams-kanaal te plaatsen heb je hem niet nodig: gebruik de koppeling met Microsoft Teams.

Zapier

Maak een Zap met de trigger Webhooks by Zapier › Catch Hook, kopieer het adres, klik in UAT Studio op Test connection en stuur daarna één issue, zodat Zapier de velden leert kennen. Voeg dan de actie toe die je wilt, zoals een bericht in Slack.

Make

Begin een scenario met Webhooks › Custom webhook, kopieer het adres en klik op Redetermine data structure voordat je een issue vanuit UAT Studio stuurt.

Je eigen dienst

Neem een POST met JSON aan, controleer de header Authorization tegen je geheim, antwoord snel met 200 en doe het langzame werk daarna. Na een fout wordt een bericht niet opnieuw verstuurd, dus log wat je ontvangt.

Als er iets misgaat

Kom je er niet uit? Mail [email protected] met de melding die je ziet. Stuur ons nooit het geheim zelf.

Wat UAT Studio verlaat

• Berichten gaan alleen via HTTPS de deur uit.
• Ze bevatten de tekst van het issue, de test en de naam van de tester, nooit bestanden of screenshots. Stuur ze alleen naar een dienst die je organisatie die informatie toevertrouwt.
• Het geheim wordt versleuteld opgeslagen (AES-256), met de sleutel los van de database. Niemand kan het teruglezen.
• Zet de koppeling Off of verwijder hem, en er wordt niets meer verstuurd.