Facebook Workplace

Facebook Workplace is a communication tool that connects everyone in your company, even if they are working remotely. It uses familiar features like Groups, Chat, Video calls and Live video broadcasting.

Setup Guide

  1. Navigate to Facebook workplace and login as an administrator.

  2. On the left hand vertical tool bar, select the admin panel button

  3. Now, under the new menu select integrations, opening the page before you.

  4. From under the "Custom Integrations" segment you will be able to view and edit your existing Facebook bots. Yet firstly, create a new bot via the "Create Custom Integration" button.

  5. A create modal will appear where you will enter the "Name" of the bot, and perhaps a "Description". Once all fields have been completed, select the create button, finalising the credentials and creating the integration.

  6. Navigating back to Humley studio, we will be linking the two platforms via channels. To view the selection of channels within Studio, select the vertical more menu in the top left hand corner and selecting "Manage Channels".

  7. The page will display a selection of channels for your conversational deployment, yet we will focus on Facebook Workplace.

  8. Select the channel card, opening the "Configuration" panel on the right hand side. You will see that there are three pieces of information required to successfully activate the channel:

    • Access Token
    • Callback URL
    • Verification Token
  9. In terms of the access token, navigate to the Facebook Workplace and under integration details select "Create Access Token" button. The token is generated, allowing you to copy the values back into the Humley Platform. Select the "Access Token" input field and past the values.

  10. Back in Facebook Workplace, from the modal, select the "I Understand" bot and the "Done" button to continue.

  11. Still in Facebook Workplace, let’s set up the integration permissions. For our conversational assistant we require the following permissions to be selected:

    • Mention Bot
    • Message any member
    • Delete Chat messages
  12. Once these have been selected, scroll down the page to the "Configure Webhooks" segment.

  13. From Humley studio, copy the "Callback URL" in the configuration panel into the "Callback URL" input field.

  14. A verification token is also required which is a unique password to your bot. To create this, navigate back to Humley and enter your desired password as an alphanumeric. Copy the created value and pass into the "Verification Token" Input field back in Facebook Workplace.

  15. Once these fields have been completed, select the below options:

    • Mention
    • Messaging_postbacks
    • Message_deliveries
    • Message_reads
    • Messages
  16. All specific fields have now been set up. The final step is to navigate to the bottom of the page and select the save button. The callback URL will be verified saving the credentials and closing the configuration tab.

  17. Now navigate back to Facebook Workplace and select the save button at the bottom of the page. The callback URL will be verified saving the credentials and closing the configuration tab.

  18. Back under the "Custom Integrations" on the "Integrations Page", you will see the newly created bot.

  19. Navigate back to the Facebook Workplace home and under the Bots segment of the side menu you will see your newly created Bot. If it is not visible, select the integrations button to view all bots.

  20. Select the newly created bot, which opens a new chat window in the bottom right hand side of the screen. Ask the bot a question from your Humley Project and view the responses appearing in the chat window.

Still need help? Get in touch!
Last updated on 19th May 2020