Social Advocacy Configuration

Facebook

To setup the Facebook integration you first need to create a Facebook app on the developer portal

Access the Facebook developer portal here https://developers.facebook.com/apps/

This page will allow you to create a new app or edit the settings of any apps you already have. To continue click on Create App.

Choose _Other _for the app template as shown in the screenshot

Choose _None _for the app type as shown in the screenshot

Add a name for your App and set the contact email appropriately. When ready, click Create App

Go into your app settings and open the Basic Settings Page

Set the remaining information such as the Privacy Policy Url and App icon as required. Add your intranet domain name in the app domains field.

Make a note of the App Id, it will be needed later for configuration

The next step is performed on your Interact Intranet

Go to Application Settings -> Control Panel -> Marketplace

Select the Facebook Icon Enter the App Id noted earlier and save the page

LinkedIn

LinkedIn uses integrated authentication to allow users to share automatically through interact. This requires some setup within the LinkedIn Developer platform and corresponding setup in Marketplace within the intranet

Log in to your linked in account and Visit https://www.linkedin.com/developers/apps. This page allows you to create new apps (1), or view and edit existing apps (2). Select "Create App" to begin.

To create an app you will need to enter the following details

  1. An App name - This is shown to users when logging into the LinkedIn integration on Interact.
  2. Your LinkedIn company page. This is the URL of the page on LinkedIn. For example, this is the page for Interact Software - https://www.linkedin.com/company/interactsoftware/ . The admin of this page may need to verify your account and the app you are creating here.
  3. A link to your app privacy policy
  4. A logo for the app

(1), (3) & (4) are shown to users when logging in to LinkedIn on the intranet. Press the "Create App" button (5) when ready.

You should then proceed to the App settings page.

Under the "Auth" tab, complete the following

  1. Note down the Client Id and Client Secret. These are used for later configuration.
  2. Add an Authorised redirect URL for the app. This should be in the form https://exampleintranet.interactgo.com/marketplace/linkedin/account/sign-in/oauth2 , replace the domain name exampleintranet.interactgo.com with the your own intranet domain
  3. Add the following Auth scopes to the app
    1. r_emailaddress
    2. r_liteprofile
    3. w_member_social

The next step is performed on your Interact Intranet

Go to Application Settings -> Control Panel -> Marketplace

Select the LinkedIn icon, enter the values noted earlier in the appropriate textboxes (1) and save your settings

Twitter / X

To setup the Twitter integration you first need to create an app on the developer portal https://developer.twitter.com/en/portal/dashboard

When first creating an account in the developer portal you will likely have a default app created. This can be edited to have the correct settings or you can create an additional app if you have a suitable account level.

During app creation you may be prompted to generate an authentication secret, keep a note of this as it is needed later. It can be regenerated later if required.

Select your app within the project (1) and edit this to set the required app name and and icon (2). Then proceed to edit the User Authentication Settings (3)

Set the app permissions to "Read" and the Type to "web app, Automated App or Bot".

Add a redirect URL for the app. This should be in the form https://exampleintranet.interactgo.com/marketplace/twitter/account/sign-in/oauth2 , replace the domain name exampleintranet.interactgo.com with the your own intranet domain

Add any of the optional settings as appropriate for your app. These will be shown to users when they connect with twitter on the intranet so can help confirm the legitimacy of the intregration

Save the settings then proceed to "Keys and Tokens" options, shown below as (1)

If you have not already noted the client id and client secret (2), regenerate these and keep a note of them. they are used in the next step. The secret is never shown again after generation, so if lost then you will need to repeat this step and the following marketplace configuration

The next step is performed on your Interact Intranet

Go to Application Settings -> Control Panel -> Marketplace

Teams

Teams does not require specific setup. People will be able to login with their existing Microsoft account on the share dialog opened when sharing to teams