Gitbook

GitBook Import Setup Guide

Overview

The GitBook Import feature in AiTalk.ch allows you to import documentation from GitBook into your AI agent's knowledge base.


1. How to Get Your Access Token

You need to generate an Access Token from GitBook Developer Settings.

Steps:

  1. Click the Settings icon (⚙️) at the bottom left

  2. Navigate to SettingsDeveloper Settings

  3. In the Personal Access Tokens section, click Create new token

  4. Enter a name for your token and create it

  5. Copy the generated token and paste it into the Access Token field in AiTalk.ch

⚠️ Note: The token is only displayed once when created. Store it in a safe place.


2. How to Find Your Space ID

The Space ID is a unique code that identifies a specific documentation space in GitBook.

Method 1: From the URL

  • Check the URL in the GitBook editor view

  • Format: https://app.gitbook.com/s/[Space ID]/...

  • Example: https://app.gitbook.com/s/XF5Q8drxdQOBisGrmGGu/ → Space ID is XF5Q8drxdQOBisGrmGGu

Method 2: From Space Settings

  1. Open the Space in GitBook

  2. Click Space Settings (⚙️) at the bottom left

  3. You can find the Space ID in the General tab


3. Published Base URL Setting

Enter the URL if you have published your GitBook to a custom domain.

  • Example: https://docs.example.com/

  • If using GitBook's default domain: https://[organization].gitbook.io/[space-name]/


4. Test Connection

After entering all information:

  1. Click Save Settings to save your configuration

  2. Click Test Connection to verify the connection is working

  3. Setup is complete when the "Connected" status is displayed


Troubleshooting

Issue
Solution

Connection failed

Verify that your Access Token is correct

Space not found

Verify that your Space ID is correct

Cannot load documents

Verify that your GitBook Space is published

Last updated