Overview

You can add AI chat as a Discourse widget to your Discourse community.

Get an API key

  1. Go to the Inkeep Dashboard
  2. Select your project under Projects
  3. Go to the Integrations tab
  4. Click on Create integration
  5. Select Web
  6. Provide a Name and URL (optional) for the integration
  7. Click on Create
  8. Click the Example < /> button to get your API key and view suggested settings

Create Theme-Component

To use the AI chat, first we need to create a theme-component on the Discourse platform.

  1. Click the Admin section in the sidebar menu
  2. Open the Customize tab
  3. Open the Themes subsection
  4. Now, select the Components tab
  5. Click on Install
  6. Open the Create new menu and specify a name for the component
  7. Click on Create

Example:

Customizing Theme-Component

Next, in the created theme component menu, click Edit CSS/HTML to customize the widget.

Initialize the widget

Click on the Head section and paste the following scripts:

Optional: click preview to test out the widget.

Click on the Save.

Apply to themes

In the Include component on these themes setting, specify the themes in which the widget will be used. Alternatively, you can create and specify your own theme.

Allow list from Content Security Policy (CSP)

If you are using a Discourse version earlier than 3.3.0.beta1 you may need to allow-list the Inkeep script by modifying the Content Security Policy (CSP). In version 3.3.0.beta1 or later external scripts should work without additional configuration, see here for more details:

  1. Click the Admin section in the sidebar menu
  2. Open the Settings tab
  3. Open the Security section
  4. Add https://unpkg.com/@inkeep/uikit-js@0.3.18/dist/embed.js to the content security policy script src setting
  5. Enable content security policy strict dynamic setting

Example:

Go back to the main community page and reload the page.