Khoros

Integrate with Khoros so your users can chat to your inGenious AI chatbot using a Khoros-connected channel. Make sure you have:

  • Your inGenious AI chatbot.
  • Your Khoros username and password.
  • Your KhorosCare instance URL.
    Your instance URL is the URL displayed in your browser when you log into your KhorosCare dashboard.

Khoros account permissions

Make sure your Khoros account has permission to access the Khoros Bot API.

To integrate your chatbot with Khoros:

  1. Get your Khoros access token in inGenious AI.
  2. Configure your chatbot integration in inGenious AI.
  3. Connect your Khoros instance to channels in Khoros.
  4. Find your external channel ID.
  5. Register each channel with inGenious AI.
  6. Switch each channel to Live Mode in inGenious AI.

Let’s look at each of those steps in detail.

Get your Khoros access token in inGenious AI

In the inGenious AI platform:

  1. Open the chatbot you want to integrate and click Settings.
  2. Click Integrations.
  3. Toggle the Khoros integration on.
  4. In the KhotosCare Instance URL field, paste your Khoros instance URL.
    Do not include the https://.
    For example: acme.response.lithium.com
  5. Click Request Access Token.
  6. At the prompt, type in your KhorosCare username and password.
    Your username and password are only used to request the access token from Khoros, and are not stored by inGenious AI.
  7. Click Request and Save.

The access token appears in the Access Token field.

Configure your chatbot integration in inGenious AI

In the Khoros integration settings in your inGenious AI chatbot:

  1. In the Bot Identity field, give an identifiable name for your chatbot.
    This should include your company name, and something that helps you identify the chatbot. For example, Acme Customer Service Bot. 
  2. In the Bot Secret field, create a secret to ensure incoming requests are legitimate.
    This should be at least eight characters long, and difficult to guess. Do not use your company name or chatbot name.
  3. In the Company Key field, paste your Khoros Company Key. To find your company key:
    1. In your KhorosCare dashboard, click the Admin tab.
    2. Open the Developer menu.
    3. Open General Settings.
  4. In the Contact Email field, type the email address of the person responsible for maintaining the chatbot.
  5. If you want to use an avatar for your chatbot:
    1. Toggle Enable Avatar on.
    2. In the Avatar field, paste the URL of the image to use for your chatbot avatar.
      Make sure this URL is publically accessible.
  6. If you want to allow the chatbot to hand over to live agents, toggle Enable Handover on.
  7. Scroll up and press Save.

Connect your Khoros instance to a channel in Khoros

Your Khoros account must be connected to a channel (called a network in Khoros) in order to integrate your inGenious AI chatbot with that channel. You can connect Khoros to multiple channels. inGenious AI currently supports:

  • WhatsApp.
  • Facebook Messenger.
  • Khoros Brand Messenger.

Connecting WhatsApp?

The WhatsApp channel is not automatically available in your KhorosCare dashboard. Contact Khoros support to connect WhatsApp to your instance before you continue.

To connect Khoros to a channel:

  1. Log into your KhorosCare dashboard.
  2. Navigate to the Admin tab.
  3. In the Integrations menu, click Source Integrations.
  4. Click Add.
  5. Click the channel you want to add.
  6. Follow the prompts to add the channel to your Khoros instance.

You may be required to log into channel accounts to complete the integration.

Find your external channel ID

To complete the integration, you will need the ID that the channel uses to identify your chatbot. Find the ID and paste it into Notepad.

Channel External ID
Facebook Messenger The Page ID of the Facebook Page the chatbot is connected to.
Khoros Brand Messenger The ID provided under Brand Messenger in your KhorosCare dashboard.
WhatsApp Contact Khoros support.

Register each channel with inGenious AI

Each channel that you want to use with your Khoros integration must be registered in inGenious AI.

To register a channel:

  1. In the inGenious AI platform, open the chatbot you're integrating.
  2. Click Settings.
  3. Click Integrations.
  4. In the Khoros integration section, click Manage Bot Registrations.
  5. Click + Registration.
  6. Type the name of your registration.
    In some channels, this name is displayed to users as they chat with your chatbot.
  7. In the Network Key field, select the channel to register.
    If you are connecting to the Khoros Brand Messenger, select Smooch.
  8. Paste the External ID you retrieved earlier.
  9. Click Save.

Some settings cannot be changed

If you want to change the Network Key or External ID, you must delete the registration and create a new one with the new key or ID.

Switch a channel to Live Mode

When a channel is in Live Mode, the chatbot can interact with users on the channel. When Live Mode is off, the chatbot is not connected to that channel.

To turn Live Mode on or off for a channel:

  1. In the inGenious AI platform, open the chatbot you're integrating.
  2. Click Settings.
  3. Click Integrations.
  4. In the Khoros integration section, click Manage Bot Registrations.
  5. Click the registration for the channel you want to change.
  6. Toggle Live Mode on or off.
  7. Click Save.
Was this article helpful?
0 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.