Skip to content
NewSee how

How to Build a Knowledge Base for AI Drafts in FirstSales

Create a Knowledge Base, crawl your site, add sources and uploaded documents, and attach it to a campaign so AI drafts are grounded in real product facts.

  1. What a Knowledge Base is for

    A Knowledge Base (KB) is the grounding the AI drafter reads from when writing emails: your product facts, positioning, docs, and pages. Attach a KB to a campaign and drafts pull real details from it instead of guessing. It's how you get on-message, specific copy at scale.

  2. Create a KB

    Go to Knowledge Base → New KB. In the drawer, set a Name (4–250 chars), an optional Description (up to 2,000), and a Website URL: this is required and is what FirstSales crawls first. Tick Set as default if this should be the KB new campaigns use automatically.

    Create a KB
  3. Let it crawl and process

    On create, FirstSales crawls the website and runs it through a pipeline you can watch: crawling → parsing files → storing data → enriching. Enrichment builds a knowledge graph so related facts connect. Give it time on the first pass; larger sites take longer.

  4. Add more sources

    Open the KB and use the Sources tab to widen coverage. Bulk-paste additional URLs (up to 100 per batch) (docs, case studies, pricing, blog posts) and FirstSales crawls them into the same KB. You can resync a source to re-crawl when its page changes, and see the list of crawled pages.

  5. Upload documents

    For material that isn't on a public page, use the Documents tab to upload files. Each is parsed and split into chunks (the tab shows the chunk count), and those chunks join the same knowledge the drafter reads. Good for one-pagers, spec sheets, and internal notes you don't want to publish.

  6. Attach the KB to a campaign

    A KB only shapes drafts once it's attached. In a campaign's Email Drafter → Content tab, add the Knowledge Base tool and select this KB. From then on, the drafter grounds its emails in the KB's crawled pages and uploaded documents.

Pro tips

  • Point the Website URL at your best page

    The required Website URL is the crawl seed. Use the page that best describes what you sell (product or homepage), not a thin landing page, so the first crawl captures the real substance.

  • Bulk-paste your strongest proof

    Case studies, pricing, and docs make drafts specific. Paste those URLs (up to 100/batch) on the Sources tab rather than relying on the homepage crawl alone.

  • Upload what isn't public

    Spec sheets, internal one-pagers, and unpublished notes go on the Documents tab. The drafter reads them like any crawled page, without you having to host them.

  • Resync when pages change

    A KB is a snapshot from crawl time. After you update pricing or messaging on your site, resync that source so drafts don't quote stale facts.

Frequently asked questions

What does a Knowledge Base do?

It grounds the AI email drafter in your real product facts, pages, and documents. Attached to a campaign, drafts pull specifics from the KB instead of inventing them.

How do I create one?

Knowledge Base → New KB. Set a Name (4–250 chars), optional Description, and a required Website URL to crawl. Optionally mark it the default for new campaigns.

How do I add more than one website?

On the KB's Sources tab, bulk-paste up to 100 URLs per batch. FirstSales crawls them into the same KB, and you can resync any source later.

Can I add files that aren't on my website?

Yes: the Documents tab lets you upload files. They're parsed and chunked into the same knowledge the drafter reads.

How do drafts actually use the KB?

Attach it in the campaign's Email Drafter → Content tab via the Knowledge Base tool. The drafter then grounds emails in the KB's crawled pages and documents.

Why is my KB still processing?

New sources run through crawling → parsing → storing → enriching. The enrichment step builds a knowledge graph, so a large site or big document set takes a while on the first pass.

Campaigns

Outreach that keeps going after you log off.Leads, emails, follow-ups and replies, handled.

Connect unlimited mailboxes and let AI agents find leads, write each email and follow up. Or send your own templates in manual mode. From $29/mo.

$1 for 3 days · Cancel anytime · No contract

Install with AI

Your coding agent sets up the FirstSales CLI and skills for you.

Prompt for Claude Code

I'm setting up FirstSales (https://firstsales.io), an AI outbound sales platform: campaigns, contacts, a reply inbox, deliverability and lead signals. Help me get my workspace sending real, good emails end to end, from Claude Code.

Read these first so you know how FirstSales works:
- Developer docs and API: https://developer.firstsales.io
- CLI: https://www.npmjs.com/package/@firstsales.io/cli
- Skills for coding agents: https://github.com/firstsalesio/firstsales-skills (read README.md and GUIDE.md)

Setup
1. Install the CLI: npm install -g @firstsales.io/cli
2. Install the FirstSales skills:
   claude plugin marketplace add firstsalesio/firstsales-skills
   claude plugin install firstsales@firstsales
3. Ask me if I already have a FirstSales account. If not, send me to https://app.firstsales.io to sign up.
4. Ask me to create an API key under Settings → API → API Keys, with only the scopes we need.
   Never ask me to paste the key into this chat. Tell me to run this in my own terminal, so the key stays hidden:
   read -rs FS_KEY && firstsales auth login --api-key "$FS_KEY"; unset FS_KEY
5. Run `firstsales whoami` and tell me which workspace and organisation we are connected to.

Then ask me about my business: what I sell, who I sell to (roles, company size, countries), my best customers, and what I use today for outbound (tools, lists, mailboxes). Walk me through:
1. Teaching FirstSales my business: website, offer, proof points and case studies in the knowledge base, so the AI writes like someone who knows the product.
2. Connecting my sending mailboxes and checking my sending domain: SPF, DKIM, DMARC and warm-up. If anything is unhealthy, tell me the exact DNS record to add.
3. Bringing in contacts: import my CSV or CRM export into a clean list, remove duplicates and bad emails, and block domains I must never email (customers, competitors, my own).
4. Building my first campaign: the right list, senders, steps and timing. Write the sequence with me, show me the drafts, and do not launch until I say yes.
5. Setting up Signals if it fits: find people engaging with LinkedIn posts about topics my buyers care about, and turn them into leads.
6. Inviting my team and giving each person the right access.

Once campaigns run, show me how to work the reply inbox from here: which replies need an answer, draft responses in my voice, and move good conversations into deals. If I use Cal.com, connect it so follow-ups can offer my booking link (not the first email).

Throughout, as you learn about my business, proactively suggest and help create:
- Reply templates for the questions and objections my prospects are likely to raise, based on my product, site and codebase if you can see them.
- Campaign ideas and segments worth testing, with the reason for each.

Safety rules:
- Show every change as a dry run (--dry-run) first and wait for my yes. Never send emails, launch campaigns or delete anything without my yes.
- Tell me before anything that spends credits, and how many.

Be opinionated. If the docs give a sensible default, just use it. Don't make me choose between five options.