Facebook Workplace Connector Prerequisites

User Accounts and Application Permissions

Required Permission Description
App Integration Permissions

The connector needs permissions to read group content. This requires access to all groups.

The connector does not use webhooks and does not require app secret proof.
Authentication

This Connector uses an access token for authentication when interacting with Facebook Workplace. 

  • The access token is generated by creating a Workplace App.

Ensure you store your token securely.

  • If the token is compromised, you must create a new token.
  • When a new token is created, all requests made using the previous token fail.

Connector Features and Requirements

Features Supported Additional Information
Application version
Searchable content types Yes All content types.
Content Update Full and Incremental

All BA Insight Connectors support both Full and Incremental crawls, unless noted.

Note: Facebook connector crawls different types of items: like groups, posts, files. Incremental crawl Scanning and capturing only new data from all of your content sources. This data did not exist when the last crawl was run. is not supported for groups and files and consequently these will be full recrawled with each incremental crawl.
Permission Types Yes All BA Insight Connectors support fetch ACLs from the source system Your Source System is the repository where your data is stored (data to be indexed). This repository is managed by applications such as: - SharePoint O365 - SharePoint 2013/16/19 - Documentum - File Share - OpenText - Lotus Notes - etc. Your Source System repository can also be a database such as SQL or Oracle.. To make items public or restricted to a single user/set of users, you can do so within the Connector Framework.
Required Software

.NET Framework v4.7.2

Registered as Facebook app

 See above table and topic on registering your connector as a Facebook app.

How to Register the Connector as a Facebook App

  1. Navigate to https://workplace.facebook.com/ (or https://mycompany.facebook.com).

  2. Go to the Admin panel.

  3. Go to Integrations from the left side menu.

  4. Click the "Create Custom Integration" button and complete the Name and Description fields.

  5. Set Permissions using the steps below.

How to Set Permissions for App Integration

  1. Select the proper permissions for the newly created integration.

    1. The connector needs permissions to read group content. This requires access to all groups.

    2. The connector does not use webhooks and does not require app secret proof.

  2. Click the button "Create Access Token" from the "Integration Details" section.