Overview

The Influitive-Khoros Integration allows you to embed Challenges and other Influitive components directly into your Khoros Community, enabling you to surface advocacy requests, customer engagement campaigns, and other customer marketing programs to your Khoros Community Members. 

Information

• Feature Overview
• General Setup Instructions
• Community Components

Feature Overview

Challenge Carousel

Use the Challenge carousel to display calls to action directly in your Khoros Community. Here is an overview of the Key Features supported in our Challenge Carousel:

• Khoros users will see the available challenges respecting all targeting rules in Influitive. 
• Khoros users, not members of Influitive, will not see the Carousel or any Challenges.
• The Carousel can be placed anywhere on the page and on any page you'd like.
• You can configure only certain Challenge Types, Channels, or specific Challenges you'd like to appear
• Khoros users who have not had their email verified will not see the Carousel

Recruitment Component

Use this component to recruit members of your Khoros community into your Influitive Program

• The Component only appears to those who are not members of the Influitive Program
• Easily click the Signup button, which uses a Join Code that the user can use to join the program
• Configure the text and media included in the component to entice new members to join

Bounties

You can now leverage Influitive points to drive engagement within your Khoros Community to users who answer questions in the community! Here is an overview of the key features of Bounties:

• Award points to users whose Reply is chosen as the Solution on posts within Khoros
• Bounties can be made available to Everyone in your community or a subset of only Influitive members based on your Influitive Groups
• If a user who is not a member of Influitive completes a bounty, they will be added to your Invitation list and continue to accrue points. You can choose to invite them into Influitive at any time formally!
• When a user earns a bounty, we will send them an email notification letting them know they have earned the bounty.
• Use the Bounties Board component to showcase bounties that are available to users and place them anywhere in your Khoros Community

General Setup Instructions

Enable the Khoros Integration in the Influitive Integrations Page

1. Login to your hub as an administrator.
2. Go to the integrations catalog page
3. Click Manage on the Khoros Integration card
4. Click on Enable Integration

Generate a new Khoros App & Credentials

1. Login to your Khoros instance as an administrator.
2. Go to Community Admin > System >  API Apps
3. Click Create Web App
   
4. Choose a Display Name (example: Influitive Integration)
5. Add the Redirect Authorization URL in the format below in the format below (no custom domain)
   • https://<your-influitive-domain>.influitive.com/users/auth/khoros/callback
6. Click Save

Complete the OAuth Setup within Influitive

1. Login to the hub as an administrator.
2. Navigate to the Khoros integration page
3. Enter your base Khoros URL
4. Enter your Client ID that you generated above.
5. Enter your Client Secret that you generated above.
6. Click Save.
   
7. After hitting save, click on the “Authenticate with Khoros” button
   

Enable “Event Subscriptions” in Khoros

1. Login to your Khoros instance as an administrator.
2. Go to Community Admin > System >  Subscriptions
3. Check “Turn on event subscription” and click Save.
4. Login to the hub as an administrator.
5. Navigate to the Khoros integration page
6. Under the Setup tab, click Re-authenticate with Khoros

Adding the Carousel Component

1. Navigate to the Studio > Components page of your Khoros Instance and Click New.
   
2. Enter the name of the component you want to create, and then click on the “create” button—for example, Influitive_carousel.
3. After this, you will see the component screen you have created. In the Content area, we will paste the script from Influitive we are about to get.
   
4. Navigate to the Influitive Khoros Integrations Page.
5. Copy the script tag in the grey box and paste it into the Component Content in Khoros, and click save.
6. After creating the Component, click on the Page tab and select the page where you would like to add the component
7. Find the custom Carousel component you created and drag it onto the page in the desired section
   
8. After confirming the position of the component click on the “save” button below to save your changes in the layout.
9. If you are adding your carousel to the sidebar, it may help to add another bounding <div> tag in the carousel component's code with your sidebar width specified
   1. For example: <div style="width: 300px">(your script here)</div>

After completing these steps, you should see the carousel component appear in the preview and start to see challenges. If you are not seeing the carousel, the first step is to ensure the user you are logged in as in Salesforce exists in Influitive as either an Administrator or Member and that you have challenges available to you. 

Adding the Recruitment Component

Add the Component to your desired Page

1. Click on the Studio > Page tab, then click on the Change link:
   
2. Search for the page that you want to add the Recruitment Component you created.
3. In the search input in the sidebar, find the Recruitment Component you created and add it to the page in the location you'd like
   
4. After confirming the position of the component,, click the Save button below to save your changes in layout.

Note: Because the Recruitment Component only appears to users who do not exist in Influitive, you must ensure the user you are logged in as in Salesforce does not exist in Influitive to see and test it.

Adding the Bounties Components

There are additional setup steps needed before you can begin adding Bounties.

Create a new Bounties API App

Similar to the General Step above, we need to create a new API App specifically for Bounties

1. Login to your Khoros instance as an administrator.
2. Go to Community Admin > System >  API Apps
3. Click Create Web App
   
4. Choose a Display Name (example: Influitive Bounties)
5. Add the Redirect Authorization URL in the format below
   1. https://i--khoros.influitive.com/lithiumOauth
6. Click Save
7. You will need the Client ID and Client Secret in the next steps.

Create the Bounties Connection Page

1. In your Khoros Instance, go to Studio > Components > Create new Component
2. For Component name, use: Influitive_settings
3. In the Component Content area, we will paste a script from the Influitive app
4. To get the script, go to your Khoros integration settings in Influitive
5. Under the Bounties dropdown, choose the Settings component and copy the script in the grey box
   
6. Paste the script into the Component content area and click save.
7. You should be able to see the component in the preview shown below:
   
8. Fill out the fields directly in the preview box as described below. This information must be filled in on the same environment you enter in the first field.
   1. Khoros Instance URL: Add the Khoros instance URL
      1. If your instance has htaccess Authentication enabled on a staging or development environment, include that in the format like so: https://username:password@[communityURL
   2. Khoros Client ID: Use the Client ID of the API app you created in the previous step
   3. Khoros Client Secret: Use the Client Secret from the API app you created in the previous step
   4. Influitive Subdomain: Use your Influitive subdomain (not your custom domain) for example, if your Influitive instance lives at customer.influitive.com, input customer here.
   5. Subdomain Instance Environment: Select the environment type as Production, even if you are using a Khoros Sandbox, this is the environment of your Influitive Hub.
9. Click Save; you should see a “Connection Established Successfully” alert.

Add the Bounty Post Component

The Bounty Post Component shows at the top of the post if a bounty is attached.

1. In your Khoros Instance, go to Studio > Components > Create new Component
2. Choose a Display Name (example: Infuitive-Bounty-Post)
3. In the Component Content area, we will paste a script from the Influitive app
4. To get the script, go to your Khoros integration settings in Influitive
5. Under the Bounties dropdown, choose the Bounty Post component and copy the script in the grey box
   
6. Paste the script into the Component content area and click save.
7. Navigate to the Studio > Page area of your Khoros Instance. Click Change page and search for the page called ForumTopicPost
8. Add the Custom Component we created to the top of the main content section as shown below:
   
9. Click Save.
10. Now, the Bounty banner will appear on any page with an active bounty targeted to the current user.

Add the Bounty List Component

The Bounty List Component can be placed anywhere in your community where you would like to promote bounties for people to complete. We recommend placing this somewhere like the homepage or even in a sidebar for users to see when they enter the community.

1. In your Khoros Instance, go to Studio > Components > Create new Component
2. Choose a Display Name (example: Influitive-Bounty-List)
3. In the Component Content area, we will paste a script from the Influitive app
4. To get the script, go to your Khoros integration settings in Influitive
5. Under the Bounties dropdown, choose the Bounty List component and copy the script in the grey box
   
6. Paste the script into the Component content area and click save.
7. Now add the Bounty List Component to any page you'd like!

To begin seeing Bounties, go to your Influitive Hub and create a bounty under the Program > Bounties tab. Ensure this bounty is targeted to your user so you can test that the bounty components are showing up correctly.

Integration with Multiple Communities

If you're looking to Integrate Influitive into Multiple Khoros instances, this is possible for the Challenge and Recruitment components. Follow the same steps above for those components in the new Khoros Instance. Bounties are currently only supported for one Khoros instance at a time.

If you're looking to show content from Multiple Influitive programs in a single Khoros instance, this is possible for the Challenge and Recruitment components. Follow the same steps above for these components but in the new Influitive Program. Bounties are currently supported for only one Influencer instance at a time.