Prerequisites
- The Admin role in Openlayer to add, edit, pause, or delete destinations. Other roles can view them.
- A Google Chat space you can add webhooks to. Your Google Workspace admin can turn incoming webhooks off for your organization. If the space doesn’t let you add one, ask them to allow incoming webhooks.
- On a self-hosted Openlayer deployment, the platform must be able to reach
chat.googleapis.comover HTTPS (port 443).
Create a webhook in the space
1
Open the space's webhooks
In Google Chat on the web, open the space and choose Apps &
integrations → Webhooks.
2
Add a webhook
Give it a name your team recognizes, such as
Openlayer. Google Chat shows
that name as the sender of Openlayer’s messages.3
Copy the webhook URL
The URL looks like
https://chat.googleapis.com/v1/spaces/<space>/messages?key=…&token=….
Copy all of it, including the key and token.Add the destination
On Workspace settings → Notifications, click Add destination and choose Google Chat. Enter a Space name and paste the Webhook URL. Google Chat doesn’t share a space’s name with webhooks, so the name you enter is how the destination is listed in Openlayer. Then choose the events the space receives and the projects they come from, as for any destination. After you save, open the destination’s ⋯ menu and choose Send test message. A test card from Openlayer appears in the space. A space can be a destination only once per workspace. To send different events to different spaces, create a webhook in each space and add each one as its own destination.What the messages look like
- Each notification is a card with a button that opens the related page in Openlayer, such as the commit or test.
- When a failing test recovers, the recovery posts as a new message. Google Chat destinations don’t reply in the failure’s thread the way Slack does.
- If the destination receives the Weekly digest, the digest posts to the space too.