Bring Your Visual Reviews to Microsoft Teams

Integrate Percy with Microsoft Teams.

The Percy and Microsoft Teams integration enables you to view the notifications of your visual tests within Microsoft Teams. With this integration, you can configure unlimited connections between Microsoft Teams channels and Percy projects. You can also specify what kinds of notifications you want to receive for each connection.


What you’ll learn

  • How to generate an Incoming Webhook URL to integrate Microsoft Teams with Percy.
  • How to add integration on Percy’s dashboard.

Generate an Incoming Webhook URL

To integrate Microsoft Teams with Percy, we use an Incoming Webhook URL to enable communication between these two applications. Follow these steps to generate an Incoming Webhook URL:

  1. Open the Microsoft Teams dashboard.
  2. Click the three dots (More added apps) on the left pane and search for incoming webhook in the search field.
  3. Click Add next to Incoming Webhook in the search results.
  1. Click Add to a team.
  1. Select the team which should receive the Percy build notifications in the Type a team or channel name field, and then click Set up a connector.
  1. Enter a name for the Incoming Webhook. Optionally, upload a custom image for the webhook.
  1. Click Create. The webhook is created.
  2. Copy the generated URL. You use it to integrate Microsoft Teams with Percy.
  1. Click Done.

Integrate a Microsoft Teams channel with Percy

The next step is to integrate Microsoft Teams with Percy. To do that, follow these steps:

  1. Go to the Integrations page, and click Connect for Microsoft Teams. You’ll be directed to a Microsoft Teams authorization page giving Percy permission to connect to a Microsoft Teams channel.



In order to authorize Microsoft Teams, you must both be an admin of your Percy organization and have permission within your Microsoft Teams workplace to install apps. Check your workspace permissions settings.

  1. Click Add Microsoft Teams Channel. Enter the generated Webhook URL and specify a channel\team name present on Microsoft Teams.

    Note: It is recommended to use the same channel\team name which you used to add Incoming Webhook in Microsoft Teams.

  1. Edit the configuration according to your requirements and save your changes.

Supported notifications:

You can choose to receive different notifications for a Percy build in Microsoft Teams. The following is the list of notifications that are currently supported:

  • Unreviewed and Changes requested: Get notifications when builds with the status "Unreviewed" or "Changes requested" have completed processing. These alerts will automatically update whenever the status of the related build changes. This is the default selection.
  • No changes: Get notifications when builds finish with no visual changes.
  • Auto-approved: Get notifications when builds are auto-approved from your auto-approved branches.
  • Approved: Get information about the person who approves a build and the corresponding PR details in addition to the Unreviewed notice when the build is approved.

After you save your configuration, Percy will start sending your custom notifications to Microsoft Teams channel. You can edit, add, or delete configurations any time.


Your Microsoft Teams integration will show up as below on the Percy Integrations page.