UAT Studioby Salvion
Help · Connections

Post new issues in Microsoft Teams

Let your project team hear about new issues where they already talk: a card in a Teams channel with the severity, the test step, who found it and a button to open it in UAT Studio. You choose which issues are worth a message.

Takes about 5 minutesWho a workspace admin, and someone who may add workflows to the channelPlans Team, Partner and Enterprise
Before you start

What you need

  • A Teams channel for the messages, for example UAT in the project's team.
  • Permission to add workflows to that channel. In most organisations every team member may; some IT departments switch Workflows off. Then ask your IT department.
  • Admin rights in your UAT Studio workspace.
No account or tokenTeams gives you an address for the channel. UAT Studio sends its messages to that address and can do nothing else in Teams: it cannot read the channel or post anywhere else.
Set up · once per channel

Connect a Teams channel

1

Create the workflow in Teams

  1. In Teams, open the channel, click ⋯ (More options) next to its name and choose Workflows.
  2. Choose the template Post to a channel when a webhook request is received.
  3. Give it a name such as UAT Studio, check the account it runs under and click Next.
  4. Check the team and channel, then click Add workflow.
  5. Teams shows an address that starts with https://. Click the copy button next to it. Keep the window open until you have pasted it in step 3.
Treat the address as a passwordAnyone with this address can post in the channel. Paste it only in UAT Studio, and don't send it in chat or by mail.

Lost the address? In Teams, open Workflows, open the workflow, and click the first step (When a Teams webhook request is received) to see it again.

2

Add Microsoft Teams in UAT Studio

In UAT Studio, open your workspace and click Connections. Under Add a connection, choose Microsoft Teams and click Add.

Add a connection: Microsoft Teams chosen, with the Add button

Then choose which issues get a message:

  • Post new issues from: Critical only, High and Critical (the default), Medium and higher or Every new issue. Status changes of those issues are posted too, such as when one is fixed.
  • Projects: tick the projects this channel is about. Tick none, and every project of the workspace is posted.

Click Save settings. One channel per project? Add Microsoft Teams once more for each channel.

3

Store the workflow address

Paste the address from step 1 under Workflow address and click Store token. You'll see Token stored with the last four characters. From then on the address can't be read back, only replaced.

4

Test the connection

Click Test connection. A card UAT Studio is connected appears in the channel, and the connection shows a green check with the time of the test.

The Microsoft Teams connection: High and Critical, project CRM UAT ticked, address stored and tested
A tested Teams connection. Switch it Off to pause the messages without losing the settings.
Using it

What gets posted

  • A new issue at or above the severity you chose: a card with the title, the description, severity, status, the test and step, who found it and the ticket in Jira or Azure DevOps if there is one.
  • A status change of such an issue, for example ISS-012 is now Ready for retest.
  • Every card has a button Open in UAT Studio. Only people with access to the project can open it.
  • By hand: on any issue, an admin can click Send to Microsoft Teams to share it, whatever its severity.
What stays outScreenshots and files are not posted in Teams; they stay in UAT Studio, behind sign-in.
Roles

Who can do what

Workspace adminAdds, changes, tests and removes the connection, and sends issues by hand.
Testers and stakeholdersReport issues as always. They don't see the connection.
Everyone in the channelSees the cards. Opening an issue needs access to the project in UAT Studio.
Help

If something goes wrong

You seeWhat to do
This is not a Teams workflow addressCopy the address of the workflow itself (step 1), not the link to the channel or the team.
Teams does not know this address any more (404 or 401)The workflow was removed or switched off. Create it again and store the new address.
The test works, but no cards for new issuesCheck the severity you chose and the ticked projects, and that the connection is On. Then send one issue by hand with Send to Microsoft Teams: if Teams refuses it, you see why.
No Workflows in the channel menuYour IT department has switched Workflows (Power Automate) off. Ask them to allow the template Post to a channel when a webhook request is received.
Connections are not part of your planConnections come with Team, Partner and Enterprise. Your admin can upgrade under Plan & billing.

Still stuck? Mail support@uat.studio with the message you see. Never send us the workflow address itself.

Want the messages somewhere else, such as Slack or your own system? See Connect a webhook.

Security

How we handle the address

  • The address goes from your browser to our server once, over an encrypted connection.
  • It is stored encrypted (AES-256). The key to decrypt it is kept separately from the database.
  • Nobody can read it back: not in the app, not through support.
  • Cards contain the issue text and the name of the tester who found it, never files. Choose a channel whose members may see the UAT.
  • Remove the connection in UAT Studio or the workflow in Teams, and the messages stop straight away.