Workplace by Facebook

Last updated 3 months ago

Connecting your space to Workplace by Facebook.

Workplace is a collaborative platform run by Facebook. The software offers the social networks features in a corporate environment. Over 30,000 organizations use Workplace to communicate via groups and to chat with colleagues.

The Workplace Logo

Similarly to Facebook Messenger, Workplace supports a multitude of features, including quick replies and location prompts. It also has its own parametric codes that users can scan similarly to QR codes to easily connect to your space.

For a detailed list of features against the other channels, you can take a look at the comparison table.

Setting Up Workplace

In order to connect Workplace to your space, you will need the following:

Create a Workplace Custom Integration

First, you will have to create a new Slack Custom Integration to connect your space to. On your Workplace admin account, navigate to the Workplace Admin Panel. You find the panel page by clicking on "Admin panel" from the top of the page.

From the Admin Panel, navigate to the Integrations page. You can do this by pressing "Integrations" on the navigation menu on the left.

The Integrations Page

On the Integrations page, press the blue "Create a Custom Integration" button under the Custom Integrations section. This should open up a menu to create a custom integration.

Creating a Custom Integration

Enter an appropriate name for your integration. This will the display name that contacts will see when speaking to you. You also have the option of entering a description of your integration. Once you are ready, press the blue "Create" button to create your integration.

Connecting to Workplace

To add a new channel to an existing space, navigate to Space Settings and select Manage Channels. From the Channels Management Menu, select the "Add New Channel" button.

On the Rocketbots Platform, select the Workplace Logo under the Channel Connection menu. Enter a suitable name for the channel and press the "Continue" button.

Once you have done so, you should be asked for the App ID and an Access Token under Channel Settings.

Channel Settings for Workplace

App ID

On the Workplace Integration page, you should be presented with the Edit Integration menu after you created your custom integration.

Edit Integration Menu

You can return to the Edit Integration Menu by clicking on your custom integration under the Custom Integrations section of the Integrations Page.

From here, you can access the App ID. Copy and paste the App ID into the respective field on the Rocketbots Platform.

Access Token

To generate the access token, return to the Edit Integration menu. Press the "Create Access Token" button to generate an one time app access token.

Paste the access token onto the Rocketbots Platform.

Take note of your access token and store it somewhere secure. You will not be able to access this token again.

Once you have copied down your access token, tick the "I understand" checkbox and press the blue "Done" button to close the menu.

Keep your access token secure and do not share it publicly to protect the security of your information!

Once you have filled out the two fields on the Rocketbots Platform, go ahead and press the blue "Continue" button.

Connecting to the Platform

Once you are done with the channel settings, the platform will generate a Webhook URL and a Verification URL.

Webhook URL and Verification URL

Grant Permissions

Under the Workplace Integration menu, take a look at the Grant Permissions tab. There should be a list of checkboxes for different permissions for your integration.

Grant the following permissions by ticking the checkboxes:

  • Manage Accounts

  • Message any Member

Granting Permissions

Configure Webhooks

Open the Configure Webhooks tab by pressing "Configure webhooks" below the Grant Permissions tab.

Configuring Webhooks

Copy the Webhook URL generated from the platform and paste it into the Callback URL field. For the Verification token field, copy the Verification URL from the platform.

For the subscription fields, make sure the following are selected:

  • messages

  • messaging_postbacks

Once these changes have been made, hit the blue "Save" button on the bottom right of the Integration menu.

Return to the Rocketbots Platform and press the "Finish" button. Your space is now connected to Workplace by Facebook!

You will now be able to handle messages sent from Workspace on the Rocketbots Platform.