Skip to content

Point Overdesk at your docs

Overdesk grounds its drafts in your own documentation, so it answers from what you have published instead of guessing. That is why drafting stays paused until Overdesk knows where your docs live. Giving it the address takes a minute, and Overdesk reads and indexes the site in the background.

Add your docs site

  1. Open Settings → Knowledge base. During setup, the same field is Docs site URL (required for drafting) in the Configure AI step.
  2. Under Documentation sync, enter your documentation site's address in Docs site URL(s), for example https://docs.yourcompany.com. For more than one site, separate the addresses with commas.
  3. Choose Save.

Use the address of your docs home page. Overdesk follows links from there, 2 clicks deep unless you change Max crawl depth. The optional Link selector, Content selector and Title selector fields are for sites where whole sections are missed or navigation text creeps in; leave them blank otherwise. Documentation sites explains each one.

What happens next

Drafting does not wait for the crawl to finish. Once the address, your API key and your allowed inboxes are set, drafts start arriving, and their grounding gets sharper as indexing completes.

Sync documentation crawls the site shortly after the address is first saved, then reads it again every day at 04:00 in your workspace timezone, so drafts keep up with changes to your docs.

Using Zendesk

Your knowledge base lives in Zendesk Guide. Activate Guide, make your Help Center public, and paste its address into Docs site URL(s).

Help-center articles and other sources

Help Scout Docs (once you add a Docs API key), Zendesk Help Center and Intercom Help Center articles also sync through your help desk connection, and Notion, Google Docs, GitHub, Linear, Jira and WordPress.org forums can join the knowledge base too. See Help-center articles and the knowledge base overview.

Those sources add to what drafts can cite, but the docs site address is the one drafting checks for. Set it even if your articles already arrive through your help desk.

Without an address

  • Nothing is drafted. The Agent drafts page says so in a banner, and its Run auto-draft button stays unavailable.
  • Follow-up nudges still run, because they draw only on the conversation itself.
  • Your knowledge base still builds from your past conversations.

Next: Your first drafts.