Break down silos by integrating Happeo with Google Chat.
Package information: The Google Chat Bot Integration is available to all package users.
Note: If you are using a custom URL, you will still need to enable the Google Chat Integration while being logged into app.happeo.com as opposed to your custom URL.
Happeo Google Chat Bot helps you to show Happeo content in Google Chatrooms. Google Chat Bot requires 3 things to work (in order):
- Google administrators need to allow the installation of bots (more specifically the Happeo Google Chat bot) in Google Chatrooms
- For more information regarding the steps that need to be taken, please visit this article from Google
- Happeo administrators need to enable the Google Chat Bot integration
- Channel owners/editors need to connect a Google Chatroom with the Happeo Channel of their choice
Enabling the Google Chat integration
To enable the Google Chat integration in your organization, you'll need to be a Happeo admin and a Google Admin.
Please note that you should do this step after you've allowed the installation of the Happeo Google Chat Bot in Google.
- Open up the Admin panel > Integrations
- Click the enable toggle
- Follow the instructions
Enabling the Google Chat integration to a Channel
To enable the Google Chat integration to a Happeo Channel, you'll need to have Happeo Channel owner/editor permissions.
- Open up a Google Chat chatroom and add Happeo Chat bot to it. You can find how to install an app in Google Chat here
- Open a Happeo Channel and go to its Channel settings. You will be able to see Google Chat under integrations
- A command will be displayed there. You can copy and paste it to the Google Chat Chatroom you wish to connect to
- Follow the link that appears in the Chatroom and that's it!
Troubleshooting
Google icon appearing as the default thumbnail image for Posts and Articles in Google Chat
When the Google Chat Integration is enabled for a Channel, Posts and Articles from Happeo will be visible in Google Chat with their thumbnails displaying the default Google icon.
However, if your organization has a custom login URL and branding enabled, the default thumbnail icon will be replaced by your company logo, which was uploaded for the custom login branding in Happeo.
Therefore, depending on your organization's settings, you will either see the Google icon or your company logo as the default thumbnail icon in Google Chat.
I received an error when trying to integrate Google Chat Bot
When you try to integrate the Google Chat Bot and receive the error message "Oh no! Something is wrong" followed by "Error: NO_JWT_PROVIDED" after clicking "Connect," please uninstall and then reinstall the Google Chat Bot.
Happeo posts are not appearing in Google Chat
If your Happeo channel successfully connects with Google Chat and shows no errors, but Happeo posts aren't being forwarded to Google, the issue likely lies within your Google Workspace Marketplace app settings.
As a Google Workspace admin, you need to ensure that the Settings of Google Workspace Marketplace apps are configured correctly. Navigate to this link and confirm that the setting is either:
- "Allow users to install and run any app from the Marketplace"
- "Allow users to install and run allowlisted apps from the Marketplace"
If you choose the latter, make sure that the Happeo Chatbot is specifically included in your Allowlisted apps category.