All docs Kalfa AI
Knowledge sources
What Kalfa AI may use for store questions — pages, FAQs, web pages and documents — plus re-syncing, limits and the unanswered questions report.
Kalfa AI answers store questions (returns, delivery, payment, opening hours…) only from the sources on Store → Knowledge, plus live order data. Every team member can see the sources; only Owners and Admins can change them.
Source types
| Type | How to add it |
|---|---|
| CMS page (Magento) / pages and policies (Shopify) | Click Use page, or tick Suggested pages and click Add selected pages (up to 50). Re-checked every 6 hours. |
| FAQ / text | Add a FAQ entry (question 2–200 characters, answer up to 20,000) or Add a FAQ set (1–200 question/answer pairs in one source). |
| Web page | Add a web page: a public URL. Optionally Follow links 1–3 levels on the same site (robots.txt respected), Max pages (up to 200; 50 by default when following links) and Only paths starting with (e.g. /help, /policies). Pages that need JavaScript to show text are not supported. |
| Document | Upload a document: PDF or Word (.docx), up to 20 MB. Scanned PDFs without a text layer cannot be used. Only on plans that include documents. |
| Standard platform knowledge | Built-in articles about a standard Magento or Shopify storefront (signing in, resetting a password, finding orders, the cart), with links to your store. Turn off if your storefront works differently and add your own articles. |
Suggested pages are store pages that look like policies, marked Returns, Shipping, FAQ or Other.
Managing sources
The table shows each source's Status (Syncing… / Synced / Error / Could not extract text), last sync and schedule, number of chunks and how often it was Retrieved and cited in answers.
- Sync now — fetch the source again.
- Enabled: Yes/No — stop or start using a source without deleting it.
- Remove — Kalfa AI stops using it at once; its text is deleted.
Open a source to change its Title, Language (e.g. en, en-GB, de-DE — customers writing in that language get this source), Re-sync schedule, crawl options, FAQ pairs or answer text, to upload a new version of a document, and to see the Extracted text Kalfa AI can use.
Re-sync choices: default for the type, every 6 hours, daily, weekly, every 30 days, or manual only.
Limits
Your plan sets how many knowledge sources and documents you can have. The Plans and billing page lists them.
Unanswered questions
Click Unanswered questions report → (also on the Overview page). It lists store questions Kalfa AI could not answer from your knowledge, most asked first, for the last 7, 30 or 90 days. Personal data is removed before questions are stored.
- Add an answer — write the reply as you would to a customer and click Add to knowledge. It becomes a Q&A entry Kalfa AI uses from then on, and the question leaves the list.
- Not a gap — dismiss — hides a question that needs no knowledge.
- History — weekly topics and the latest questions with the reason they were not answered.
Tips
- Add your returns and shipping policies first — they are the most asked questions and part of the Go-live checklist.
- Prefer short, specific FAQ entries over long pages.
- After changing a policy on your store, click Sync now so Kalfa AI uses the new text immediately.