Integrations
Permissions
This article is only applicable to users of Workplace Essential and Workplace Advanced.
To check which permissions the integrations you've enabled have access to:
  1. From your Admin Panel, click Integrations > Permissions & Data.
  2. From there, you'll be able to see all the integrations enabled in your community. If you click on the individual integrations, you'll be able to see which permissions they have access to. You'll also be able to change those permissions.
Note: For a custom integration access token, permissions that haven't been used in the last 60 days will be revoked and admins of the community notified. Admins will see a notification within the Integrations Permissions Panel in the Admin Panel when the permissions for a custom integration have been changed following this process.
Was this information helpful?
Third-Party Integrations
This article is only applicable to users of Workplace Essential and Workplace Advanced.
Note: If you’re receiving a notification from Workplace regarding “integrations that haven't passed our updated Review Process”, learn more here.
Third-party integrations are integrations between Workplace and other SaaS tools. Third-party integrations are unique and can be found in groups and Workplace Chat. They offer the ability to easily share content in Workplace, receive automatic notifications or complete workflows.
Third-party integrations must be enabled by a System Admin in the Admin Panel under the Integrations tab. Once an integration is enabled, it will only be available for the groups identified by the System Admin.
You can see all third-party integrations by going to our Integration Directory.
Was this information helpful?
This article is only applicable to users of Workplace Essential and Workplace Advanced.
You can see all third-party integrations in our Integration Directory.
These integrations are made available only after entering into a contract with Facebook, passing a functional review by the Workplace team and passing a security audit by a third-party auditor.
Was this information helpful?
This article is only applicable to users of Workplace Essential and Workplace Advanced. Only a System Admin can enable and disable third-party integrations.
Third-party integrations are set up in the Admin Panel from the Integrations tab. Though each integration's functionality and access differs, the process to setup is as follows:
  1. Click the integration you want to add.
  2. Determine if all groups or select groups should have access to the integration.
  3. Review the permissions granted to the integration when enabled.
  4. Click Add.
  5. Complete authentication with the third-party app.
Was this information helpful?
This article is only applicable to admins on Workplace Essential and Workplace Advanced.
Note: If you’re receiving a notification from Workplace regarding “integrations that haven't passed our updated Review Process”, learn more here.
System Admins are able to add, manage and remove integrations at any time. Reporting on Workplace integrations is available in the Admin Panel under Integrations > Permissions and Data. Here, an admin can view all integrations, see which groups they're enabled on, review permissions, export API activity logs and disable the integrations at any time.
Was this information helpful?
Users can request an integration by going to the Integrations tab under the Explore section of their account or from posts that contain links to content providers.
Once a user requests an integration, the request will go to a system admin. To see all requested integrations along with who requested them, system admins can go to their Admin Panel's Integrations tab. System admins can choose to install the integration or mark the request as seen. System admins can't disable requests.
Was this information helpful?
Cloud Storage Integrations
If you're a Workplace Essential or Workplace Advanced admin, you can enable cloud storage integrations with Box, Dropbox, Quip, Google Drive, and Microsoft OneDrive.
If you use Workplace Standard, you can link a Workplace group with a folder in Dropbox, Google Drive, Microsoft SharePoint and Microsoft OneDrive.
Was this information helpful?
If you're a Workplace Advanced admin, you can enable cloud storage integrations by visiting the Integration Directory, and clicking Add to Workplace.
Once you've set up a cloud storage integration, the members of your community will see that integration listed in the Integrations tab of the groups they're administrators of. Those group admins will be able to link a folder stored in the cloud service to their Workplace group.
If you use Workplace Essential, you can enable a cloud storage integration by going to the Integrations tab within any Workplace group that you're an admin of. From there, you can link a folder in the cloud storage service with that Workplace group.
Was this information helpful?
Cloud storage integrations provide several benefits:
  • When someone shares a link to a file or document stored in a cloud storage service, people who have permission to view the file will see a preview and/or the file or document's title. Exactly what people see depends on the type of file, the cloud storage service and permissions that person has to view the file or document.
  • You may also see the cloud storage service's logo in the group Composer on web and mobile. Clicking this will open a window that lets you navigate the files and folders stored in the cloud service. You can also search across multiple cloud storage services using the search box at the top of this window. When you've found the file you want to share, a link to this file will be added to your post in the Composer.
  • You can link a folder in a cloud storage service to a group on Workplace.
Was this information helpful?
PPT, PPTX, DOC, DOCX and PDF files will generate a preview, with each page being shown as an image. Google Docs and Slides will also generate a preview. Other file types supported by your service provider will be shown as an icon with a title of the file or document.
If enabled, files and documents stored in Box will render in Box's preview window on web.
Was this information helpful?
If a file is public to everyone in your organization, coworkers who have enabled the cloud storage integration for their Workplace account will see a rich preview and/or the files' title. If the file isn't public, they'll see a prompt to connect their accounts to determine if they have permissions to view the title and/or a preview from within Workplace.
Workplace will only show a preview and/or title to those who have permission to view the file. If a coworker hasn't enabled the integration, they'll have the choice to enable the integration and see the previews.
Note: Content integration file previews don't work in multi-company groups. The files will still appear as URL links.
Keep in mind that if a file is encrypted/password protected, no preview will be shown.
Was this information helpful?
If you edit a file stored in a cloud storage service file after sharing it in Workplace, the updates to the title and description will be reflected in Workplace immediately. However, the images in the preview will remain the same since they were captured when you first made the post.
Was this information helpful?
If you change the permission of the file from private/accessible to some to public to everyone at your company:
  • For users of Workplace Advanced:
Since the file wasn't public to everyone when you originally made the post, people will only see the icon of the file type and they'll be prompted to confirm they have permission to view the file. Only people who have permission will then be able to see the preview and access the file. If you change the permission to public, nothing will change in the preview, but everyone will be able to access the file.
  • For users of Workplace Essential:
Only coworkers who have permission and have enabled integration will be able to see the preview and access the file. If you change the permission to public, nothing changes in the preview, but everyone will be able to access the file. If a coworker hasn't enabled the integration, they'll have the choice to enable the integration and see previews going forward.
If you change the permission of the file from public so that everyone at your company can access the file, to private/accessible by some:
  • For users of Workplace Advanced:
Since the file is public to everyone at the time the post is made, everyone will see a preview and/or title. If you change the permission to private/accessible by some, previews that show images remain the same since they were captured at the moment you first made the post. However, only people who have permission will be able to access the file when they click on the link. Users may be prompted to log in to the cloud services provider.
  • For users of Workplace Essential:
Same as above if integrations are enabled.
Was this information helpful?
This article is only applicable to admins on Workplace Essential and Workplace Advanced.
Google Drive integration lets people easily share files from Drive directly in Workplace on web and mobile. It also enables authenticated previews so people can see more information about a Drive file without leaving Workplace. You can link a Drive folder to a Workplace group so teams can easily access their files and see who's working on what.
From your computer:
  1. Go to the Workplace Integrations Directory.
  2. Select Google Drive.
  3. Click Add to Workplace.
  4. On the popup dialog that follows, click Install.
  5. Sign into your G Suite account — you must be a G Suite administrator for your organization.
  6. When asked if you want to give Workplace from Facebook access to your Google Account, click Allow.
  7. You'll be redirected back to Workplace and the Google Drive integration will have been enabled for everyone in your community.
Was this information helpful?
This article is only applicable to admins of Workplace Essential and Workplace Advanced.
Box integration lets people easily share files from Box directly in Workplace on web and mobile. It also enables authenticated previews so people can see more information about a Box file without leaving Workplace. You can link a Box folder to a Workplace group so teams can easily access their files and see who's working on what.
Note: You must be the primary administrator of your Box account to set up Box integration.
If you're a Workplace Advanced admin, from your computer:
  1. Go to the Workplace Integrations Directory.
  2. Select Box.
  3. Click Add to Workplace.
  4. A popup window will appear. Copy the API Key from that page. You'll need to input that into Box's Admin Console.
  5. In a new window, navigate to the Custom Applications page in Box's Admin Console.
  6. Under Custom Applications, select the Authorize New App button.
  7. Enter the API Key you copied from Workplace and select Next. Confirm the integration by selecting Authorize on the next screen.
  8. Navigate to the Account Info page in Box and copy the Enterprise ID.
  9. Navigate back to Workplace and enter the Enterprise ID in the Install Box popup.
  10. Click Install - the dialog will close and the Box integration will be enabled for everyone in your community.
Was this information helpful?
This article is only applicable to admins of Workplace Essential and Workplace Advanced.
OneDrive integration lets people easily share files from OneDrive directly in Workplace on web and mobile. It also enables authenticated previews so people can see more information about a OneDrive file without leaving Workplace. You can link a OneDrive folder to a Workplace group so teams can easily access their files and see who's working on what.
If you're an admin:
  1. Go to the Workplace Integrations Directory.
  2. Select OneDrive.
  3. Click Add to Workplace.
  4. On the popup dialog, click Install.
  5. Sign into your Microsoft account — you'll need to have an admin account to complete this process.
  6. When asked if you want Workplace by Facebook to have access to your account, click Allow.
  7. The dialog will close and the OneDrive integration will be enabled for everyone in your organization.
Was this information helpful?
Quip integration makes it easy to share content from Quip within Workplace on web and mobile. It also enables authenticated previews so people can see more information about a Quip document without leaving Workplace. You can link a Quip folder to a Workplace group so teams can easily access their documents and see who's working on what.
Note: You must be the primary administrator for your organization in Quip to complete this process.
  1. Go to the Workplace Integrations Directory.
  2. Select Quip.
  3. Click Add to Workplace. A dialog window will appear.
  4. In a new window, navigate to the Quip Admin Dashboard.
  5. Select Create API Key.
  6. Name your service and save to generate the Client ID and Secret.
  7. Enter the Client ID and Secret into the dialog that appeared in step 3.
  8. Click Install.
  9. The dialog will close and the Quip integration will be enabled for everyone in your organization.
Was this information helpful?
Dropbox integration lets people easily share files from Dropbox directly in Workplace on web and mobile. It also enables authenticated previews so people can see more information about a Dropbox file without leaving Workplace. You can link a Dropbox folder to a Workplace group so teams can easily access their files and see who's working on what.
  1. Go to the Workplace Integrations Directory.
  2. Select Dropbox.
  3. Click Add to Workplace.
  4. A dialog window will appear. Click Install.
  5. Sign into your Dropbox account.
  6. When asked if you want to give Workplace from Facebook access to your Dropbox account, click Allow.
  7. The dialog will close and the Dropbox integration will be enabled for everyone in your organization.
Was this information helpful?
This article is only applicable to admins of Workplace Essential and Workplace Advanced.
The SharePoint integration lets people share content from SharePoint Online directly in Workplace on web and mobile. It also enables authenticated previews so people can see more information about SharePoint Online content like docs, pages, and files without leaving Workplace. Finally, you can link a SharePoint Online folder to a Workplace group so teams can easily access their files and see who's working on what.
If you're an admin:
  1. Go to the Workplace Integrations Directory.
  2. Select SharePoint.
  3. Click Add to Workplace.
  4. On the popup dialog that follows, click Install.
  5. Sign into your Microsoft account — you'll need to have an admin account to complete this process.
  6. When asked if you want Workplace from Facebook to have access to your account, click Allow.
  7. The dialog will close and the SharePoint integration will be enabled for everyone in your organization.
Note: Your colleagues will only be able to see a preview of the file you share if they already have the appropriate permissions in SharePoint. If they wouldn't be able to view the content in SharePoint, no preview will be shown on Workplace.
Was this information helpful?