In order to use this service, you must have a Rocket.Chat domain.  Rocket.Chat is available as a paid-for cloud service.  Trial Accounts are available by signing up here: https://rocket.chat/cloud

Create Rocket.Chat User

  • Login to Rocket.Chat as an Administrator

  • Navigate to Administration

  • Click on Users in the left side menu and Click icon to add new user

  • Configure a new user noting username and password, and select the Role of “bot” for the user.

  • Click “Save” to save user

Obtain Rocket.Chat authorization token

  • Send a POST request to the login endpoint of the Rocket.Chat API URL using username and password configured above in order to obtain an authorization token. Note: Do not include < > brackets.

    • POST request
      curl -s -k -H 'Content-Type: application/json' -d '{"user":"<username>","password":"<password>"}' -X POST https://<domain>.rocket.chat/api/v1/login

    • Result
      {
      "status": "success",
      "data": {
      "userId": "<userid>",
      "authToken": "<authtoken>"
      }
      }

  • Note userid and authtoken above

NOTE:  This step can be accomplished using CURL or Postman.  If you have trouble with this step, SkySwitch Support can assist you.  You must provide to the SkySwitch Control Tower the admin username and password that was created in the previous step.

Configure Rocket.Chat Incoming WebHook

A SMS DID can only be routed to a single Rocket.Chat channel.  An Incoming Webhook is required for each Rocket.Chat channel that will receive SMS messages. It is NOT possible to route a SMS DID to more than one channel.

  • Login to Rocket.Chat as administrator

  • Navigate to Administration > Integrations

  • Click “New integration”

  • Select “Incoming WebHook”

  • Configure WebHook with following details

    • Enabled: True

    • Name: <a meaningful name - eg. ‘Incoming SMS to the Support channel’>

    • Post to Channel: <channel to which incoming messages should be posted>

    • Post as: <username configured above>

  • Click “Save Changes”

  • Copy the full Webhook URL displayed after saving as this will be used in the configuration of the routing for the SMS enabled DID.

An example of an incoming webhook

Configure Rocket.Chat Outgoing WebHook

A separate Outgoing Webhook is required for the DID that is routed to a channel. This DID will be the same as the one mentioned in the configuration of the Incoming Webhook.

An example of an outgoing webhook

Configure ReachUC SMS Routing

  • In Dashmanager, go to Manage DID.

  • Navigate to Manage Inventory

  • Search for the DID

  • Click on the SMS icon to open the SMS Routing modal

  • If SMS has not been enabled for the DID then enable it now by clicking on the toggle switch for SMS. Note: MMS is not supported by Rocket.Chat.

  • Choose in Assign To the option Rocket Chat and the domain for us

  • For the Incoming Webhook URL paste: https://api.reachuc.com/api/rocket/send?url=<Incoming webhook_url_copied_above>

  • Click disk icon    to save.

Sending an SMS Message from Rocket.Chat

To send an outgoing SMS message from Rocket.Chat use the format #<mobile_number> <message> just like the one used below:

Receiving SMS Messages in Rocket.Chat

Messages received in the Rocket.Chat channel will appear as below:

Replying to SMS Messages in Rocket.Chat

  1. Click the three dots that appear when you hover over a message

  2. Select the “Reply” option

Sample Images of Integration in Use

  • Sending an SMS from Rocket.Chat

  • SMS Received from Rocket.Chat

  • Conversation with Rocket.Chat as seen in mobile

  • Conversation with mobile phone as seen in Rocket.Chat