Knowledge Sources

Connecting Notion

Sync Notion pages and databases as a knowledge source so your customer-facing assistant always reflects what your team writes in Notion.

If your team already documents in Notion, the Notion source lets the assistant answer from those pages directly. There is no migration, no copy-paste, and no second source of truth — when you update a page in Notion and re-sync, the assistant reflects the change.

How it works

Gabbex uses Notion’s official OAuth integration. You authorise Gabbex to read a specific set of pages or databases, and only those pages are accessible. You can revoke access at any time from your Notion settings.

Once connected, Gabbex reads each selected page, splits it into chunks, and indexes it the same way it indexes a website or a PDF.

Connecting a Notion workspace

  1. Open your assistant and go to Sources → Notion.
  2. Click Connect Notion.
  3. You will be redirected to Notion. Log in if needed.
  4. Pick the pages or databases you want Gabbex to access. Only the pages you select can be read — Gabbex cannot see anything else in your workspace.
  5. Click Allow access. You will be returned to the assistant.

The selected pages start syncing immediately. The status updates as each page finishes.

Choosing what to share

The fastest path to a useful assistant is to share a small, focused part of your workspace — a single help center page tree, a product wiki, or a customer-facing FAQ database. Sharing your entire workspace works, but it usually pulls in internal-only notes that should not influence customer answers.

A good rule of thumb: only share content you would be comfortable a customer reading, because the assistant may quote from it.

Re-syncing after changes

Notion pages do not push updates to Gabbex automatically. When you change a page in Notion, click Re-sync in the Notion source list to pull the latest content. You can re-sync as often as your plan allows.

Many teams add re-syncing to their internal release checklist so the assistant never falls behind.

Adding or removing pages later

You can grant Gabbex access to additional pages at any time:

  1. Go to Sources → Notion in your assistant.
  2. Click Manage pages to open the Notion permission dialog again.
  3. Add or remove pages and confirm.

Removed pages are dropped from the index on the next sync.

What works well in a Notion source

  • Short, focused pages with clear headings.
  • Toggle blocks that group related information.
  • Tables — including simple in-line tables and database views.

What can be tricky

  • Embedded files and images are not read as content. If the answer lives only in a screenshot, it will not be searchable.
  • Linked databases and synced blocks may need to be granted access separately.
  • Very long pages chunk well but search even better if you split them by topic.

Disconnecting Notion

To remove the integration entirely:

  1. Go to Sources → Notion in your assistant.
  2. Click Disconnect.
  3. Optionally revoke the integration from your Notion workspace settings as well.

All previously indexed Notion content is removed from the assistant.

Next steps