Skip to main content

Microsoft Teams Integration | Cypress Documentation

info
What you'll learn​
  • How to enable the Cypress integration for Microsoft Teams
  • How to configure Microsoft Teams notifications for your Cypress Cloud organization and projects
  • How to manage Microsoft Teams notifications at the organization and project level
caution

Microsoft Teams integration is currently in beta

The Microsoft Teams integration allows you to see your Cypress test results directly in your Microsoft Teams channels.

Cypress notification feed in Microsoft Teams channel

Enable the Microsoft Teams integration​

caution
Ownership Requirements

In order to enable the Cypress integration for Microsoft Teams, you must be an admin or owner of both your Cypress Cloud organization and your Microsoft Teams workspace.

Per-organization configuration (all projects)​

  1. Go to Cypress Cloud Organizations page or open the organization switcher.

  2. Select the organization you wish to integrate with Microsoft Teams.

    Select an organization

  3. Visit the selected organization's Integrations page via the side navigation.

    Install Cypress Microsoft Teams from Integrations

  4. Click the Enable button in the Microsoft Teams section.

    Click enable under Microsoft Teams Integration

  5. You'll navigate to a window that manages webhooks as a way for Cypress Cloud to communicate with Microsoft Teams. First, you must configure an Incoming Webhook to a Teams channel.

    In Microsoft Teams:

    • Open the channel in which you want to add the webhook and select ••• from the upper-right corner.

    • Select Connectors from the dropdown menu.

      Visit project settings

    • Search for Incoming Webhook and select Configure. Provide a name, and upload an image for your webhook if necessary.

      Visit project settings

    • Copy and save the unique webhook URL present in the dialog. The URL maps to the channel and you can use it to send information to Teams.

    • Select Done.

      Visit project settings

      The webhook is now available in the Teams channel. For more information, see Microsoft Teams - Create Incoming Webhooks.

  6. Then, add the Teams webhook to your Cypress Cloud Organization.

    In Cypress Cloud:

    • Paste in the Teams webhook URL, choosing the types of notifications your team should receive.

      Click enable under Microsoft Teams Integration

    Once you've configured and added your webhooks, the installation is complete! Cypress Cloud will post run results for all projects in your organization to the specified Microsoft Teams channel.

Remove a webhook​

You can have Cypress Cloud stop posting notifications to a channel. You cannot delete the global notification channels from a project.

  1. Navigate to the Integrations page for the project with the installed integration.
  2. Scroll down to the Microsoft Teams section.
  3. Under Actions, select Delete for each webhook you want deleted.

Per-project configuration​

If your organization has multiple teams working on separate projects, you can tailor the Microsoft Teams notifications of each project to match your teams' needs. You can have Cypress Cloud post run results for a specific project.

  1. Select your organization in the organization switcher.

    Select an organization

  2. Select the project you wish to integrate with Microsoft Teams.

    Select a project

  3. Go to the project's settings page.

    Visit project settings

  4. Scroll down and click Add Teams webhook in the Microsoft Teams section.

  5. You'll navigate to a window that manages webhooks as a way for Cypress Cloud to communicate with Microsoft Teams. First, you must configure an Incoming Webhook to a Teams channel.

    In Microsoft Teams:

    • Open the channel in which you want to add the webhook and select ••• from the upper-right corner.

    • Select Connectors from the dropdown menu.

      Open channel menu menu and select Connectors

    • Search for Incoming Webhook and select Configure. Provide a name, and upload an image for your webhook if necessary.

      Click Configure Incoming Webhook

    • Copy and save the unique webhook URL present in the dialog. The URL maps to the channel and you can use it to send information to Teams.

    • Select Done.

      Copy url and Click Done

      The webhook is now available in the Teams channel. For more information, see Microsoft Teams - Create Incoming Webhooks.

  6. Then, add the Teams webhook to your Cypress Cloud Project.

    In Cypress Cloud:

    • Paste in the Teams webhook URL, choosing the types of notifications your team should receive.

      Paste in the Teams webhook URL

    Once you've configured and added your webhooks, the installation is complete! Cypress Cloud will post run results for this project to the specified Microsoft Teams channel.

Contents