Chapter 5. Integrating Microsoft Teams with the Hybrid Cloud Console

Procedure

1. Create a new channel in Microsoft Teams or select an existing channel.
2. Navigate to Apps and search for the Incoming Webhook application.
3. Select the Incoming Webhook application and click Add to a team.
4. Select the team or channel name and click Set up a connector.
5. Enter a name for the incoming webhook (for example, Red Hat Notifications). This name appears on all notifications that the Microsoft Teams channel receives from the Red Hat Hybrid Cloud Console through this incoming webhook.
6. Optional: Upload an image to associate with the name of the incoming webhook. This image appears on all notifications that the Microsoft Teams channel receives from the Hybrid Cloud Console through this incoming webhook.
7. Click Create to complete creation and display the webhook URL.
8. Copy the URL to your clipboard. You need the URL to configure notifications in the Hybrid Cloud Console.
9. Click Done. The Microsoft Teams page displays the channel and the incoming webhook.
10. In the Hybrid Cloud Console, navigate to Settings > Integrations.
11. Click the Communications tab.
12. Click Add integration.
13. Select Microsoft Office Teams as the integration type, and click Next.
14. In the Integration name field, enter a name for your integration (for example, console-teams).
15. Paste the incoming webhook URL that you copied from Microsoft Teams into the Endpoint URL field.
16. Click Next.
17. Review the integration details and click Submit to enable the integration.

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.

Procedure

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.

Verification

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 Troubleshooting notification failures with the event log and integration settings in the notifications documentation for more details.