# Google Chat Service

> @qajonatasmartins/wdio-google-chat-service is a 3rd party package, for more information please see [GitHub](https://github.com/qajonatasmartins/wdio-google-chat-service) | [npm](https://www.npmjs.com/package/wdio-google-chat-service)

Webdriverio library to send test results as notification/off message to google chat spaces.

## Installation[​](#installation "Direct link to Installation")

`npm install wdio-google-chat-service --save-dev`

or

`yarn add wdio-google-chat-service`

## settings[​](#settings "Direct link to settings")

First, import the service into the wdio configuration file `wdio.conf.js`

```
// wdio.conf.js
const GoogleChatService = require('wdio-google-chat-service');
```

To use the service you need to have the google chat webhook url to send the notification and add the url in 'webhook'

Example:

```
services: [[GoogleChatService, {
            webhookUrl: 'https://chat.googleapis.com/v1/spaces/xxxxxxxxx/messages?key=xxxxxxxx&token=xxxxxxxxx',
            notifyOnlyOnFailure: false //Send notification only in case of test failure
        }]
],
```

## Getting google chat webhook[​](#getting-google-chat-webhook "Direct link to Getting google chat webhook")

Note: Google chat only has the webhook for business accounts. If you use a personal account you should not have the webhook option.

1. Create a space on google chat
2. Click the arrow on the chat space name
3. Click \[Manage Webhooks]
4. Add one or copy the presented webhook Url.
5. Paste the URL of the webhook in the service inside the option 'webhookUrl' as in the example above.

## Features[​](#features "Direct link to Features")

* Support for mocha runner
* Error details
* Send notification only in case of test failure

## Results[​](#results "Direct link to Results")

![Test pass and fail](https://github.com/qajonatasmartins/wdio-google-chat-service/blob/main/./img/testPassAndFail.png)
