Conectar un webhook

Míralo primero

Lo que necesitas

• Una dirección que acepte un POST con JSON, que empiece por https://. La mayoría de las herramientas de automatización te dan una (consulta Ejemplos).
• Derechos de administrador en tu espacio de trabajo de UAT Studio.

Conecta tu webhook

2

Añade el webhook en UAT Studio

Abre tu espacio de trabajo, haz clic en Connections, elige Webhook en Add a connection y haz clic en Add. Después rellena:

• Webhook address: la dirección del paso 1.
• Send automatically:
  • Only when I click Send on an issue (la opción predeterminada): un administrador decide qué incidencias se envían.
  • Every new issue and every status change, by itself: todo se envía al instante.

Haz clic en Save settings. La opción de Send automatically se guarda en cuanto la cambias.

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

Cuándo envía

Una incidencia fusionada con otra como duplicado no envía un nuevo issue.created.

Qué envía

Un POST con Content-Type: application/json. Todos los eventos de incidencias tienen la misma forma:

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

Los campos pueden ser null y es posible que añadamos campos más adelante, así que haz que tu flujo ignore lo que no conoce. Las capturas de pantalla y los archivos nunca se envían; se quedan en UAT Studio.

Construir el extremo receptor

Power Automate

1. Crea un Instant cloud flow con el disparador When an HTTP request is received, para Anyone.
2. En Request Body JSON Schema, haz clic en Use sample payload to generate schema y pega el ejemplo de arriba.
3. Añade una Condition sobre event (por ejemplo: is not equal to test) y después las acciones que quieras: una tarea en Planner, una fila en Excel, un correo, un elemento en SharePoint.
4. Guarda el flujo. El disparador muestra ahora la HTTP URL: esa es la dirección del webhook.

Nota: el disparador HTTP es un conector premium en Power Automate. Para publicar en un canal de Teams no lo necesitas: usa la conexión con Microsoft Teams.

Zapier

Crea un Zap con el disparador Webhooks by Zapier › Catch Hook, copia la dirección, haz clic en Test connection en UAT Studio y después envía una incidencia, para que Zapier conozca los campos. Luego añade la acción que quieras, como un mensaje en Slack.

Make

Empieza un escenario con Webhooks › Custom webhook, copia la dirección y haz clic en Redetermine data structure antes de enviar una incidencia desde UAT Studio.

Tu propio servicio

Acepta un POST con JSON, compara la cabecera Authorization con tu secreto, responde 200 rápido y haz el trabajo lento después. Los mensajes no se reenvían tras un fallo, así que registra lo que recibes.

Si algo sale mal

¿Sigues atascado? Escribe a [email protected] con el mensaje que ves. Nunca nos envíes el secreto.

Qué sale de UAT Studio

• Los mensajes salen solo por HTTPS.
• Contienen el texto de la incidencia, la prueba y el nombre del tester, nunca archivos ni capturas de pantalla. Envíalos solo a un servicio al que tu organización confíe esa información.
• El secreto se guarda cifrado (AES-256), con la clave guardada aparte de la base de datos. Nadie puede volver a leerlo.
• Pon la conexión en Off o elimínala y ya no se envía nada.