Integrate with Google Chat

Google Chat helps teams collaborate via one-on-one chat and in dedicated groups called rooms. As cross-functional teams collaborate within a room, they need key updates as they happen. The Aha! Ideas integration for Google Chat allows you to send customized updates directly to a room in real time.

By customizing which idea updates you stream, everyone in the room can focus on what matters most.

Click any of the following links to skip ahead:

• Prerequisites

• Configuration

  • In Google Chat

  • In Aha! Ideas

• Troubleshooting

  • From Google chat

  • From your Aha! account

Prerequisites

Integration type	One-way (Aha! Ideas to Google Chat)
Aha! Ideas level	Account level Workspace level
Required user permissions: Configuration	Administrator Workspace owner
Required user permissions: Use integration	Workspace owner Contributor

Top

Configuration

You can configure this integration either at the account or workspace level. To create it, navigate to:

• Settings ⚙️ → Account → Integrations for an account-level integration. You will need to be an administrator to do this.

• Settings ⚙️ → Workspace → Integrations for a workspace-level integration. You will need to be a workspace owner to do this.

An account-level Google Chat integration allows you to send an activity stream from Aha! Ideas to Google Chat for every workspace in your Aha! Ideas account.

Sending activity out of Aha! Ideas and into Google Chat bypasses the Aha! security controls. Anyone who has access to your Google Chat flow will be able to see your Aha! Ideas activity, regardless of whether they have access to that information as part of your Aha! Ideas account.

In Google Chat

1. Open your room in Google Chat, create a new room or select an existing one, and then click on the room name at the top to expand the room menu.

2. Click Configure webhooks, then in the modal that appears, click Add webhook.

3. Name your webhook (e.g. Aha! Updates).

4. Enter https://www.aha.io/aha_square_300.png into the Avatar URL field.

5. Save the webhook.

6. Copy the webhook URL.

In Aha! Ideas

1. Create your integration at either the account or workspace level.

   Click the text at the top of the integration configuration page to rename your integration. We suggest giving your integration the same name as your Google Chats room.

2. Enter the token from step 2 above into the Webhook URL field.

3. Click the Test connection button. After a short delay, you should see a message appear in the Google Chat room you copied the webhook from.

4. Select the Activities that you would like to appear in your Google Chat room.

5. Select the Users whose activity you would like to send to the Google Chat room

6. Enable the integration.

Top

Troubleshooting

From Google chat

If you try to access an Aha! record and see an error that says "is unable to process your request, you may have a configuration error preventing chat.google.com from being accessed from mail.google.com.

To fix this:

• Confirm that google chat is allowed by your organization

• Confirm that chat has been enabled in Google mail

These Google support articles may help you:

• For individuals

• For organizations

From your Aha! account

To help you troubleshoot errors from within your Aha! account, we provide detailed integration logs below the integration's configuration page.

All activity waits 5 minutes before posting to Google Chat. This is to keep communication concise and avoid excessive messaging when a user is performing multiple edits at once.

Top