Conectar um webhook

Veja primeiro

O que é preciso

• Um endereço que aceite um POST com JSON, que comece por https://. A maioria das ferramentas de automação dá-lhe um (ver Exemplos).
• Direitos de administrador no seu workspace do UAT Studio.

Conecte o seu webhook

2

Adicione o webhook no UAT Studio

Abra o seu workspace, clique em Connections, escolha Webhook em Add a connection e clique em Add. Depois preencha:

• Webhook address: o endereço do passo 1.
• Send automatically:
  • Only when I click Send on an issue (o padrão): um administrador decide que ocorrências são enviadas.
  • Every new issue and every status change, by itself: tudo é enviado de imediato.

Clique em Save settings. A escolha em Send automatically é guardada assim que a altera.

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

Quando envia

Uma ocorrência fundida noutra como duplicada não envia um novo issue.created.

O que envia

Um POST com Content-Type: application/json. Todos os eventos de ocorrências têm a mesma estrutura:

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

Os campos podem ser null e podemos acrescentar campos mais tarde, por isso faça o seu fluxo ignorar o que não conhece. Screenshots e arquivos nunca são enviados; ficam no UAT Studio.

Construir o lado que recebe

Power Automate

1. Crie um Instant cloud flow com o trigger When an HTTP request is received, para Anyone.
2. Em Request Body JSON Schema, clique em Use sample payload to generate schema e cole o exemplo acima.
3. Adicione uma Condition sobre event (por exemplo: is not equal to test) e depois as ações que quiser: uma tarefa no Planner, uma linha no Excel, um email, um item no SharePoint.
4. Guarde o fluxo. O trigger mostra agora o HTTP URL: esse é o endereço do webhook.

Nota: o trigger HTTP é um conector premium no Power Automate. Para publicar num canal do Teams não precisa dele: use a integração com o Microsoft Teams.

Zapier

Crie um Zap com o trigger Webhooks by Zapier › Catch Hook, copie o endereço, clique em Test connection no UAT Studio e depois envie uma ocorrência, para que o Zapier conheça os campos. Depois adicione a ação que quiser, como uma mensagem no Slack.

Make

Comece um cenário com Webhooks › Custom webhook, copie o endereço e clique em Redetermine data structure antes de enviar uma ocorrência do UAT Studio.

O seu próprio serviço

Aceite um POST com JSON, compare o header Authorization com o seu segredo, responda 200 rapidamente e faça o trabalho demorado depois. As mensagens não são reenviadas após uma falha, por isso guarde um log do que recebe.

Se algo falhar

Continua com dificuldades? Escreva para [email protected] com a mensagem que vê. Nunca nos envie o próprio segredo.

O que sai do UAT Studio

• As mensagens saem apenas por HTTPS.
• Contêm o texto da ocorrência, o teste e o nome do tester, nunca arquivos nem screenshots. Envie-as apenas para um serviço a que a sua organização confie essa informação.
• O segredo é guardado cifrado (AES-256), com a chave separada da base de dados. Ninguém o pode voltar a ler.
• Ponha a integração em Off ou remova-a, e nada mais é enviado.