Designing a Knowledge Base and RAG for WhatsApp AI
Build a reliable knowledge pipeline for WhatsApp AI with document ownership, chunking, retrieval, citations, permissions, and evaluation.
By OrangeBee Editorial · Built for founders, operators, sales teams, and customer-support leaders.
In this guide
Key takeaways
- Treat knowledge publishing as a governed lifecycle.
- Preserve document structure and metadata during chunking.
- Enforce tenant and permission filters before similarity ranking.
- Evaluate retrieval and answer support separately.
Ingest with traceable structure
Extract clean text while preserving headings, tables, lists, page references, source identity, and version. Reject unreadable or unsupported files visibly. Store a checksum so repeated uploads do not create duplicate knowledge and changed content can trigger controlled re-indexing.
Chunk around semantic boundaries rather than arbitrary character counts. Include enough local context to explain a rule while avoiding unrelated sections. Carry tenant, document, language, status, and permission metadata into every chunk so later filtering remains enforceable.
Retrieve safely and precisely
Filter by verified tenant and access policy before ranking candidates. Combine semantic retrieval with keyword or metadata matching where product codes and exact terms matter. Use query rewriting carefully, because an expanded query must not change customer intent.
Return a focused evidence set with source metadata and relevance signals. When evidence conflicts, is stale, or lacks the requested fact, route to clarification or a human. Increasing the number of chunks often adds distraction rather than certainty.
Generate answers with evidence
Tell the model which statements must be supported and how to handle missing information. Separate retrieved passages from instructions so documents cannot override system policy. Ask for concise customer language and retain source references internally for review.
Validate structured claims when possible and block answers that require evidence but received none. For sensitive workflows, expose the supporting source to teammates or customers in an appropriate form. Traceability turns a mysterious answer into an improvable operational decision.
Evaluate the full retrieval loop
Build questions from real conversations and label the correct source, expected facts, and acceptable abstention. Measure retrieval recall, ranking quality, factual support, tenant isolation, and answer usefulness separately. A fluent answer can hide poor retrieval.
Re-run evaluation when documents, embedding models, chunking, prompts, or filters change. Review unanswered questions as a content backlog. A healthy knowledge system improves through publishing discipline, observable misses, and controlled revisions rather than uncontrolled prompt growth.
From guide to workflow
Build these conversations inside OrangeBee.
Connect WhatsApp, business knowledge, live data, payments, AI, and human handoff without stitching together a separate tool for every customer journey.