Community Knowledge Base

RocketChat

RocketChat is a powerful team communication platform that enables real-time messaging, file sharing, and seamless integrations. By integrating with SmarterMail, users can receive email notifications, alerts, and messages directly within RocketChat channels, streamlining communication and enhancing collaboration. This integration ensures users stay informed without constantly switching between platforms.

Configuring RocketChat

This section is for users who will be using RocketChat in SmarterMail. Follow these steps to properly configure RocketChat in SmarterMail.

  1. Log into your RocketChat Workspace. For most domains, the URL is http://rocketchat.yourdomain.com. Use the credentials provided by your System Administrator or Domain Administrator.
  2. If Two-Factor Authentication (2FA) is enabled, you will receive a 6-digit verification code via email. Enter the code and click Verify.
  3. In your RocketChat Workspace, click on your user profile/avatar in the top-right corner, then click Preferences. Navigate to Personal Access Token in the left-hand menu.
  4. To create/add a Personal Access Token, Enter a name or phrase for the token (optional: enable Ignore Two-Factor Authentication).
  5. Click Add, then enter your RocketChat password when prompted.
  6. Click Verify to generate your Personal Access Token. Save the token details securely. Your Personal Access Token not be shown again.
  7. Log into the Marketplace settings for your account.
  8. Find the RocketChat card in the list of available integrations.
  9. Toggle Enable and enter the following details: RocketChat Server URL, RocketChat User ID, Personal Access Token. Click Test Connection to verify the setup, then click Save to finalize the integration.

If you are unsure of your RocketChat Server URL, most organizations use https://rocketchat.yourdomain.com. Contact your System Administrator or Domain Administrator if needed.

When you receive a new chat, a red notification box will appear in the lower right corner of your browser. Clicking on the message will open RocketChat in a new tab.

Enabling RocketChat (for Domain Administrators)

This section is for Domain Administrators only. Follow these steps to enable RocketChat in the Marketplace and configure it for your domain.

  1. Log into the Marketplace settings for your domain.
  2. Locate the RocketChat card in the list of available integrations. Enable RocketChat by toggling it on.
  3. note: Domain Administrators can Enable RocketChat if the System Administrator has enabled the Allow Domain Administrators to Override and included RocketChat as an option. In this case, Domain Administrators can turn it on or off for their domain. However, if the override is disabled, only the System Administrator can manage RocketChat settings.

  4. Your Domain Administrator or System Administrator should have sent you your user credentials and key from RocketChat's servers via email.
  5. When you receive a new chat, a red notification box will appear in the lower right corner of your browser. Clicking on the message will open RocketChat in a new tab.

Enabling RocketChat (for System Administrators)

This section is for System Administrators only. Follow these steps to enable RocketChat in the Marketplace and configure it for your domain.

  1. Log into the Marketplace settings for your domain.
  2. Locate the RocketChat card in the list of available integrations. Enable RocketChat by toggling it on.