---
title: "RocketChat integration"
description: "Connect Guardian to RocketChat so actions can post messages."
product: "Guardian"
edition: "Classic"
type: "workflow"
url: "https://docs.cloudhouse.com/guardian/classic/control/integrations/rocketchat-integration/"
---
# RocketChat integration

A RocketChat integration with Guardian allows you to trigger RocketChat messages to be sent after certain events take place. For example, in the event of a failed scan, you can configure this as an **Action** that automatically sends a RocketChat message every time a scan fails in your Guardian instance.

Applies to: `Guardian Classic`

!!! note

    This topic focuses on setting up the RocketChat integration. If you've already set up the integration and want to configure RocketChat actions, see [Action: Send a Message to RocketChat](https://docs.cloudhouse.com/guardian/classic/control/events/actions/rocketchat-message/index.md).

## Dependencies

To add a RocketChat integration, a RocketChat user account is required. This could be an existing user account, but we recommend setting up a brand new user account named 'Guardian' for easier identification. You will need the user account’s username and password.

## Add RocketChat integration

Integrating RocketChat with Guardian establishes a seamless connection to trigger RocketChat messages to be sent after certain events take place.

To add a RocketChat integration to Guardian, complete the following:

1. In the Guardian web application, navigate to the **Integrations** tab (**Control** > **Integrations**) and click **Add Integration**. The **Add Integration** page is displayed.

    ![Addinteg](https://docs.cloudhouse.com/guardian/classic/assets/images/guardian/control/integrations/addinteg.png)

2. Select **RocketChat** from the list of available integrations. Here, you are required to complete the following options:

    ![Rocketchat integration](https://docs.cloudhouse.com/guardian/classic/assets/images/guardian/control/integrations/rocketchat-integration.png)

**Server URL** field
:   The base URL to the RocketChat server. For example,`https://my.rocket.chat`.

**Channel** field
:   The name of the RocketChat channel that messages will be posted to. For example, '#general' or '#qa-team'.

**Username** field
:   The username of the RocketChat account that the messages will be posted under.

**Password** field
:   The password for the corresponding RocketChat user account.

3. Once you have set the correct values for each of the options displayed, click **Done** to create the RocketChat integration.

If successful, a confirmation message is displayed and the RocketChat integration is added to the **Integrations**tab of yourGuardian instance. You'll also receive a test message by a bot in the RocketChat channel you provided while adding the RocketChat integration. If unsuccessful, an error message is displayed. Use the information displayed in the error message(s) to troubleshoot the values in your **RocketChat Integration** options.

## Troubleshooting

If you are experiencing issues with your integration, try the following:

- Verify that the values supplied for the integration are correct.
- To confirm the status of the integration sync, check the integration sync event in the **Events** tab (**Control** > **Events**) of your Guardian instance. For more information, see [Events](https://docs.cloudhouse.com/guardian/classic/control/events/events/index.md).