Set up a Google Chat integration

You can configure the Red Hat Hybrid Cloud Console to send event notifications to a new or existing Google space in Google Chat. The Google Chat integration supports events from all Hybrid Cloud Console services.

The integration with the Hybrid Cloud Console notifications service uses incoming webhooks to receive event data. Each Red Hat account configures how and who can receive these events, with the ability to perform actions depending on the event type.

If you have any issues with the Hybrid Cloud Console integration with Google Chat, 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.

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

Configure incoming webhooks in Google Chat
Copy link

In Google spaces, create a new webhook to connect with the Hybrid Cloud Console.

Before you begin
Copy link

  • You have a new or existing Google space in Google Chat.

Procedure
Copy link

  1. In your Google space, click the arrow on the space name to open the dropdown menu:
    1. Select Apps & Integrations.
    2. Click Webhooks.
  2. Enter the following information in the Incoming webhooks dialog:
    1. Enter a name for the integration (for example, Engineering Google Chat).
    2. Optional: To add an avatar for the notifications, enter a URL to an image.
    3. Click Save to generate the webhook URL.
    4. Copy the webhook URL to use for configuration in the Hybrid Cloud Console.

Configure the Google Chat integration
Copy link

Create a new integration in the Hybrid Cloud Console using the webhook URL from Google Chat.

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. For more information about setting up Notifications administrator permissions, see Control team access to notification settings in the notifications documentation. 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.
  • You have a Google Chat incoming webhook.

Procedure
Copy link

  1. In the Hybrid Cloud Console, navigate to Settings > Integrations.
  2. Select the Communications tab.
  3. Click Add integration.
  4. Select Google Chat as the integration type, and then click Next.
  5. In the Integration name field, enter a name for your integration (for example, console-gchat).
  6. Paste the incoming webhook URL that you copied from your Google space into the Endpoint URL field, and click Next.
  7. 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.
  8. To enable the integration, review the integration details and click Submit.
  9. Refresh the Integrations page to show the Google Chat 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 successfully connected Google Chat to the Hybrid Cloud Console:

  1. Next to your Google Chat 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 Google space 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: Google Chat event is listed with a green label.

Create the behavior group for the Google Chat integration
Copy link

A behavior group defines which notifications will be sent to external services such as Google Chat 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.
  • You have configured the Google Chat integration.

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: Google Chat from the Actions drop-down list.
  8. From the Recipient drop-down list, select the name of the integration you created (for example, console-gchat) 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 is listed on the Notifications page.

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 Google Chat.
  3. In your Google Space, check for notifications from the Hybrid Cloud Console.
  4. In the Hybrid Cloud Console, go to Settings > Notifications > Event Log and check for an event that shows the label Integration: Google Chat.
    • If the label is green, the notification succeeded.
    • If the label is red, the integration might need to be adjusted.
  5. If the integration is not working as expected, verify that the incoming webhook connector was properly created in Google Chat, and that the correct incoming webhook URL is added in the Hybrid Cloud Console integration configuration. Note
    See Troubleshooting notification failures in the notifications documentation for more details.