Set up a Microsoft Teams integration

You can configure the Red Hat Hybrid Cloud Console to send event notifications to all users on a new or existing channel in Microsoft Teams. The Microsoft Teams integration supports events from all services in the Hybrid Cloud Console and uses incoming webhooks to receive event data.

If you have any issues with integrating the Hybrid Cloud Console with Microsoft Teams, contact Red Hat for support. To open a Red Hat support case directly from the Hybrid Cloud Console:

  1. Click Help (the ? icon) to open the help panel.
  2. Select the My support cases tab.
  3. Click Open a support case and add information about the issue.

Microsoft will not provide troubleshooting. The Hybrid Cloud Console integration with Microsoft Teams is fully supported by Red Hat.

Configure incoming webhooks in Microsoft Teams
Copy link

You can configure incoming webhooks in Microsoft Teams to receive event notifications from the Red Hat Hybrid Cloud Console in a Microsoft Teams channel.

Before you begin
Copy link

  • You have administrator permissions for Microsoft Teams.
  • You have Organization Administrator or Notifications administrator permissions for the Hybrid Cloud Console.
Important
The Microsoft Teams integration workflow now uses incoming webhooks with the Adaptive Card format. If you have an existing Microsoft Teams integration configured with the Hybrid Cloud Console, you must re-configure it using the new workflow described in this section before the end of 2025. For more information about incoming webhooks and Adaptive Cards, see Create Incoming Webhooks in the Microsoft Teams documentation.

Procedure
Copy link

  1. In Microsoft Teams, find the Workflows app.
  2. From the Workflows home page, click Select a trigger to open a drop-down list, then select Build with Power Automate to see more triggers from the list.
  3. Click Go To Power Automate.
  4. Configure the trigger:
    1. Enter webhook in the search bar.
    2. From the Triggers list, select the trigger for When a Teams webhook request is received.
    3. For Who can trigger the flow, select Anyone from the drop-down list.
  5. Click the New step button.
  6. Configure the action:
    1. Enter card in the search bar for Choose an operation.
    2. From the Actions list, select Post card in a chat or channel.
    3. For Post as, ensure Flow bot is selected.
    4. For Post in, select Channel. Selecting Channel reveals more options.
    5. For Team, select the team you want to send event notifications to.
    6. For Channel, select the channel you want to send event notifications to.
    7. For Adaptive Card, click the list to open a dialog. Select Adaptive Card in the dialog under Dynamic content.
  7. Click Save.
  8. Copy the webhook URL:
    1. Click the trigger area (When a Teams webhook request is received) to expand the information.
    2. Refresh your screen if needed to build and display the HTTP POST URL.
    3. Copy the HTTP POST URL to configure the integration in the Hybrid Cloud Console.

Configure the Microsoft Teams integration
Copy link

After you configure Microsoft Teams for integration with the Hybrid Cloud Console, add the Microsoft Teams incoming webhook URL in the Hybrid Cloud Console so you can receive notifications about events from your Red Hat services in Microsoft Teams.

Before you begin
Copy link

Procedure
Copy link

  1. In the Hybrid Cloud Console, navigate to Settings > Integrations.
  2. Click the Communications tab.
  3. Click Add integration.
  4. Select Microsoft Office Teams as the integration type, and then click Next.
  5. In the Integration name field, enter a name for your integration (for example, console-teams).
  6. Paste the incoming webhook URL (HTTP POST URL) that you copied from Microsoft Teams into the Endpoint URL field.
  7. Click Next.
  8. Optional: Associate events with the integration. Doing this automatically creates a behavior group.
    Note
    You can skip this step and associate the event types later.
    1. Select a product family, for example OpenShift, Red Hat Enterprise Linux, or Console.
    2. Select the event types you would like your integration to react to.
  9. Click the Integrations tab.
  10. Click Add Integration:
    1. In the Integration name field, enter a name for your integration (for example, console-teams).
    2. Select Microsoft Teams from the Type drop-down list.
    3. Paste the incoming webhook URL that you copied from Microsoft Teams into the Endpoint URL field.
    4. Click Save to enable the integration.

      Your Microsoft Teams integration is now listed on the Integrations > Communications page. Under Last connection attempt, the status is Ready to show the connection can accept notifications from the console.

  11. To enable the integration, review the integration details and click Submit.
  12. Refresh the Integrations page to show the Microsoft Teams integration in the Integrations > Communications list. Under Last connection attempt, the status is Ready to show the connection can accept notifications from the Hybrid Cloud Console.

What to do next
Copy link

Verify your configuration:

Create a test notification to confirm you have correctly connected Microsoft Teams to the Hybrid Cloud Console:

  1. Next to your Microsoft Teams integration on the Integrations > Communications page, click the options icon (⋮) and click Test.
  2. In the Integration Test screen, enter a message and click Send. If you leave the field empty, the Hybrid Cloud Console sends a default message.
  3. Open your Microsoft Teams channel and check for the message sent from the Hybrid Cloud Console.
  4. In the Hybrid Cloud Console, go to Notifications > Event Log and check that the Integration: Microsoft Teams event is listed with a green label.

Create the behavior group for the Microsoft Teams integration
Copy link

A behavior group defines which notifications will be sent to external services such as Microsoft Teams when a specific event is received by the notifications service. You can link events from any Red Hat Hybrid Cloud Console service to your behavior group.

Before you begin
Copy link

  • You are logged in to the Hybrid Cloud Console as an Organization Administrator or as a user with Notifications administrator permissions. Note
    You cannot log in to the Hybrid Cloud Console with your email address unless your email address is the same as your Red Hat login. For more information, see ../get-started/access-hcc.dita#finding-login.
  • The Microsoft Teams integration is configured. For information about configuring Microsoft Teams integration, see Configure incoming webhooks in Microsoft Teams.

Procedure
Copy link

  1. In the Hybrid Cloud Console, navigate to Settings > Notifications.
  2. Under Notifications, select Configure Events.
  3. Select the application bundle tab you want to configure event notification behavior for: Red Hat Enterprise Linux, Console, or OpenShift.
  4. Click the Behavior Groups tab.
  5. Click Create new group to open the Create behavior group wizard.
  6. Type a name for the behavior group and click Next.
  7. In the Actions and Recipients step, select Integration: Microsoft Teams from the Actions drop-down list.
  8. From the Recipient drop-down list, select the name of the integration you created (for example, console-teams) and click Next.
  9. In the Associate event types step, select one or more events for which you want to send notifications (for example, Policies: Policy triggered) and click Next.
  10. Review your behavior group settings and click Finish. The new behavior group appears on the Notifications > Configure Events page in the Behavior Groups tab.

What to do next
Copy link

Verify your integration:

  1. Create an event that will trigger a Hybrid Cloud Console notification. For example, run insights-client on a system that will trigger a policy event.
  2. Wait a few minutes, and then navigate to Microsoft Teams.
  3. Select the channel that you configured from the left menu. If the setup process succeeded, the page displays a notification from the Hybrid Cloud Console. The notification contains the name of the host that triggered the event and a link to that host, as well as the number of events and a link that opens the corresponding Hybrid Cloud Console service.
  4. In the Hybrid Cloud Console, go to Settings > Notifications > Event Log and check for an event that shows the label Integration: Microsoft Teams.
    • If the label is green, the notification succeeded.
    • If the label is red, verify that the incoming webhook connector was properly created in Microsoft Teams, and that the correct incoming webhook URL is added in the Hybrid Cloud Console integration configuration. Note
      See ../troubleshoot/troubleshoot-notif-failures.dita#proc-troubleshoot in the notifications documentation for more details.