LinkedIn Connector - Configuration Guide

The LinkedIn Developer Platform facilitates integration of Expertflow CX with LinkedIn. Expertflow CX interacts with content generated by a LinkedIn Page so third-party application must use an Access Token to authorise API requests on behalf of a LinkedIn member or organisation. The Access Token carries the scope of permissions granted to the application, such as reading page posts, comments or publishing content. To enable this integration, developers must create and configure a LinkedIn App through the LinkedIn Developer Portal, which allows Expertflow CX to communicate with the LinkedIn platform.

Pre-Requisite for LinkedIn Channel

• https://expertflow-docs.atlassian.net/wiki/x/r5Qm
• LinkedIn Account Onboarding
• Guide for Standard Tier Upgrade

Generating an Access Token for LinkedIn's API

Assuming you already have a verified app on the LinkedIn Developer Portal, also you have requested for the standard upgrade.

1. Go to the LinkedIn OAuth Token Generator.

2. Sign in with your LinkedIn account if you aren’t already logged in.

3. If you have multiple apps in your LinkedIn Developer account, select the app you want to generate a token for from the dropdown menu.

4. Under "Select OAuth 2.0 Scopes", choose all the permissions for your app.

5. Check the button 'I understand this tool will update my app’s redirect URL settings.'

6. Click the "Request access token" button.
   

   

7. If you are not already login on linkedIn then it will ask you to login,

8. LinkedIn will prompt you to authorize the app. Review the permissions and click "Allow".
   

   

9. Copy the generated Access Token from the tool.

Unified Admin Configuration

To set up the LinkedIn Channel, the LinkedIn connector needs to be configured in the Unified Admin of the Expertflow CX's application.

Channel Type

1. Create a new Channel Type (if it doesn't exist).

2. Select a Chat in the MRD.

Channel Provider

It's recommended that the component’s service name be used in the "Channel Provider -> Provider's Webhook" field. However, FQDN can also be used with some additional custom configurations.

1. Create a Channel Provider and give it the name "LinkedIn Provider"

2. Provide the service name of LinkedIn Connector in the Provider Webhook field as http://{SERVICE-NAME}:{SERVICE-PORT}/comments. Replace the {SERVICE-NAME} and {SERVICE-PORT} in the URL with the component's k3s-based service name and port (It can be fetched using k get svc -n expertflow)

3. Create the following additional attributes
   

4. Click Save  

Channel Connector

1. Create a Channel Connector and give it the name "LinkedIn Connector"

2. Select LinkedIn in the Channel Provider Interface.

3. Update Organizational-ID, Authentication-Token, Comments-Batch-Size, API-Version, Host-Url values.

4. Click Save

Channel

1. Add a Channel and give it a name like “LinkedIn”.

2. Add Service Identifier as your organisation ID.

3. Select the Bot ID with only the available Rasa Bot.

4. Select the recently created “LinkedIn Connector” in Channel Connector.

5. Set 300 sec as Customer Activity Timeout(sec).

6. Set Channel Mode as HYBRID.

7. Set the Routing Mode as per your need. PUSH or PULL.

8. Set the required Queue where you want to route the LinkedIn Chats.

9. Select LONGEST AVAILABLE as Agent Selection Policy.

10. Set 300 sec as Agent Response Time(sec).

11. Save.

You have to restart the LinkedIn connector after adding the LinkedIn channel configuration in the unified admin.