Add Chat Button to GitBook
Copy page
Integrate Inkeep's chat button into your GitBook documentation for real-time user assistance.
What is GitBook
GitBook is a static site generator for docs.
Get an API key
Follow these steps to create an API key for your web assistant.
Find your organizationId and integrationId
To find your organizationId
:
- Go to the Inkeep Dashboard
- Go to the Settings tab (under the Organization heading)
- Copy the
ID
field
To find your integrationId
:
- Go to the Inkeep Dashboard
- Select your project under Projects
- Go to the Assistants tab
- Select your assistant
- Copy the
ID
field
Installing widget for your website
- Navigate to GitBook
- Click Install
- After installation, navigate to Docs sites tab and enable the widget for your desired site
Initialize the widget
Navigate to the Configuration tab to customize your settings.
The Base Widget Setting is required for the widget to function. Your configuration should resemble the example below:
Once the configuration is applied, the widget will appear on the site you enabled the widget for. If the configuration is not applied, you may also need to edit the Chat Button Type field in order for Gitbook to recognize that configuration is complete (you can just remove the last letter and re-add it to trigger a refresh).
Gitbook caches this configuration so if you edit the configuration settings it may take some time for the new settings to take effect, you may try "re-saving" the configuration a couple of times to force a refresh.
For a full list of customizations, check out the Chat Button documentation.
Our Gitbook integration is currently using an older version of our widget, we are working on updating it to the latest version. Some of the configuration options found in these docs may not be available, but the relevant configuration options can be found here.