Collegare un webhook

Guardalo prima

Cosa ti serve

• Un indirizzo che accetta una POST con JSON, che inizia con https://. La maggior parte degli strumenti di automazione te ne fornisce uno (vedi Esempi).
• Diritti di amministratore nella tua area di lavoro di UAT Studio.

Collega il tuo webhook

2

Aggiungi il webhook in UAT Studio

Apri la tua area di lavoro, fai clic su Connections, scegli Webhook in Add a connection e fai clic su Add. Poi compila:

• Webhook address: l'indirizzo del passo 1.
• Send automatically:
  • Only when I click Send on an issue (predefinito): un amministratore decide quali anomalie vengono inviate.
  • Every new issue and every status change, by itself: tutto viene inviato immediatamente.

Fai clic su Save settings. La scelta in Send automatically viene salvata non appena la modifichi.

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

Quando invia

Un'anomalia unita a un'altra come duplicato non invia un nuovo issue.created.

Cosa invia

Una POST con Content-Type: application/json. Tutti gli eventi delle anomalie hanno la stessa struttura:

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

I campi possono essere null e in futuro potremmo aggiungerne altri, quindi fai in modo che il tuo flusso ignori ciò che non conosce. Screenshot e file non vengono mai inviati; restano in UAT Studio.

Costruire il lato ricevente

Power Automate

1. Crea un Instant cloud flow con il trigger When an HTTP request is received, per Anyone.
2. In Request Body JSON Schema, fai clic su Use sample payload to generate schema e incolla l'esempio qui sopra.
3. Aggiungi una Condition su event (per esempio: is not equal to test), poi le azioni che vuoi: un'attività in Planner, una riga in Excel, un'email, un elemento in SharePoint.
4. Salva il flusso. Il trigger ora mostra l'HTTP URL: quello è l'indirizzo webhook.

Nota: il trigger HTTP è un connettore premium in Power Automate. Per pubblicare in un canale Teams non ti serve: usa la connessione Microsoft Teams.

Zapier

Crea uno Zap con il trigger Webhooks by Zapier › Catch Hook, copia l'indirizzo, fai clic su Test connection in UAT Studio e poi invia un'anomalia, così Zapier impara i campi. Poi aggiungi l'azione che vuoi, come un messaggio in Slack.

Make

Avvia uno scenario con Webhooks › Custom webhook, copia l'indirizzo e fai clic su Redetermine data structure prima di inviare un'anomalia da UAT Studio.

Il tuo servizio

Accetta una POST con JSON, confronta l'header Authorization con il tuo segreto, rispondi rapidamente 200 ed esegui il lavoro lento dopo. I messaggi non vengono reinviati dopo un errore, quindi registra ciò che ricevi.

Se qualcosa va storto

Ancora bloccato? Scrivi a [email protected] con il messaggio che vedi. Non inviarci mai il segreto stesso.

Cosa esce da UAT Studio

• I messaggi vengono inviati solo tramite HTTPS.
• Contengono il testo dell'anomalia, il test e il nome del tester, mai file o screenshot. Inviali solo a un servizio a cui la tua organizzazione affida tali informazioni.
• Il segreto è conservato cifrato (AES-256), con la chiave conservata separatamente dal database. Nessuno può rileggerlo.
• Imposta la connessione su Off o rimuovila, e non viene più inviato nulla.