Chatbot Overview
Conversational Bots
Intents & Entities
Intelligent Bots's Approach Conversational Platform
Bot Concepts and Terminology
Natural Language Processing (NLP)
Bot Types
Bot Tasks
Starting with Platform
How to Access Bot Builder
Working with Bot Builder
Building your first Bot
Getting Started with Building Bots
Using the Dialog Builder Tool
Creating a Simple Bot
Release Notes
Latest Updates
Older Releases
Bot Builder
Creating a Bot
Dialog Task
User Intent Node
Dialog Node
Entity Node
Supported Entity Types
Composite Entities
Supported Time Zones
Supported Colors
Supported Company Names
Message Nodes
Confirmation Nodes
Service Node
Custom Authentication
2-way SSL for Service nodes
Script Node
Agent Transfer Node
WebHook Node
Connections & Transitions
Managing Dialogs
Prompt Editor
Alert Tasks
Alert Tasks
Ignore Words and Field Memory
Digital Views
Knowledge Graph
Importing and Exporting
Knowledge Extraction
Small Talk
Action & Information Task
Action Tasks
Information Tasks
Establishing Flows
Natural Language
Machine Learning
ML Model
Fundamental Meaning
NLP Settings and Guidelines
Knowledge Graph Training
Ranking and Resolver
NLP Detection
Bot Intelligence
Context Management
Session and Context Variables
Context Object
Dialog Management
Amend Entity
Multi-Intent Detection
Sentiment Management
Tone Analysis
Sentiment Management
Default Conversations
Default Standard Responses
Channel Enablement
Test & Debug
Talk to Bot
Utterance Testing
Batch Testing
Record Conversations
Publishing your Bot
Analyzing your Bot
Custom Dashboard
Conversation Flows
Bot Metrics
Advanced Topics
Bot Authorization
Language Management
Collaborative Development
IVR Integration
koreUtil Libraries
Universal Bots
Enabling Languages
Smart Bots
Sample Bots
Travel Planning
Flight Search
Event Based Bot Actions
Bot Settings
Bot Functions
General Settings
PII Settings
Customizing Error Messages
Bot Management
Using Bot Variables
API Guide
API Overview
API List
API Collection
SDK Overview
SDK Security
SDK App Registration
Web SDK Tutorial
Message Formatting and Templates
Mobile SDK Push Notification
Widget SDK Tutorial
Widget SDK – Message Formatting and Templates
Web Socket Connect & RTM
Using the BotKit SDK
BotKit SDK Tutorial – Agent Transfer
BotKit SDK Tutorial – Flight Search Sample Bot
Using an External NLP Engine
Bot Administration
Bots Admin Console
User Management
Managing Users
Managing Groups
Managing Role
Bots Management
Inviting Users
Bulk Invites
Importing Users
Synchronizing Users from AD
Security & Compliance
Using Single Sign-On
Security Settings
Cloud Connector
How Tos
Creating a Simple Bot
Creating a Banking Bot
Transfer Funds Task
Update Balance Task
Context Switching
Using Traits
Schedule a Smart Alert
Configuring Digital Views
Custom Dashboard
Custom Tags to filter Bot Metrics
Patterns for Intents & Entities
Build Knowledge Graph
Global Variables
Content Variables
Using Bot Functions
Configure Agent Transfer
  1. Home
  2. Docs
  3. Bots
  4. Channel Enablement
  5. Adding the Workplace by Facebook Channel

Adding the Workplace by Facebook Channel

This channel enablement flow has been modified as per the changes implemented by Facebook post ver7.2 of the product.

To add the Workplace by Facebook channel to your bot, you will need a developer portal Facebook account to configure the connection between Facebook Workplace and application needs to be authorized to send and receive messages from the Workplace by Facebook channel.

To add the Workplace by Facebook channel
To complete the following procedure, you must have an admin account in the Facebook Workplace Developers Portal at https://< Your Domain >

  1. In Bot Builder, in the Bots section, click the bot that you want to enable the Workplace by Facebook channel.
  2. On the Channels tab, click the Workplace by Facebook icon.
  3. The Workplace by Facebook Channel page is displayed.
  4. Navigate to the Configurations tab
    • In the Communication Mode section, select one or both of the following:
      • Allow communication with a Bot in a Workplace Group
      • Allow communication with a Bot through a Work Chat
    • In Manage Permissions section, set the following as per your requirements (see here for more on the permissions):
      • Message any member – To send messages to any group member. This permission is selected by default and is mandatory hence not editable;
      • Mention bot – Needed when the bot is mentioned in a post, to see the post and to reply to comments. This permission is selected by default and is required for the bot to respond to users in groups;
      • Manage group content – Required to post and comment in groups. This permission is selected by default and is required for the bot to respond to users in groups;
      • Create link previews – Needed to see links added to posts in order to display preview for certain domains;
      • Read user email – Required to see any group member’s email address;
      • Read work profile – Required to see any group member’s complete profile, including phone number, department and location;
      • Read org chart – Needed to check a group member’s profile to see who they report to and who reports to them;

      Note: You are advised to set the permissions correctly after evaluating the above-mentioned link carefully. Managing the permissions for your bot after installing application on your workplace account needs you to uninstall the application on workplace account and re-authorize it in the bot platform.

  5. Click Authorize button.
  6. You will be redirected to Workplace by Facebook page.
  7. Log in to your Facebook Workplace admin account.
  8. Click the Add to Workplace to generate page access token to enable access for platform.
  9. Click Customize to provide the following details for the instance of application being installed on Workplace by Facebook account
    • integration logo,
    • name and
    • description.
  10. The permissions needed by the Bot will be selected based upon the configuration given in step 4.
  11. Select the groups to which the bot needs to be added and click Add to Workplace.
  12. Once the instance of application is added to your Workplace by Facebook account, you will be redirected back to Bot Builder.
  13. In Bot Builder, from the Configuration tab, click Yes in the Enable Channel section, and then click Save.
  14. The bot may require your Bots Admin approval and assignment before it is available to any users.

Editing the Channel

To edit the Workplace by Facebook channel, hover your mouse over the channel to modify, and then click the Settings  icon displayed to show the command menu displayed in the following illustration.
Channels Tab - Workplace By Facebook
Select one of the following commands to modify the channel:

  • Edit – Click to open the Workplace by Facebook channel setup page.
  • Disable/Enable – Click Disable to temporarily disable use of the Workplace by Facebook channel for your bot. When the channel is disabled, click Enable to enable use of the Workplace by Facebook channel.
  • Delete – Click Delete, and then click OK in the Delete Confirmation dialog to permanently delete the bot channel configuration.

    Warning: This operation is permanent, and cannot be undone.

On this Page