For manuals, policies and help centres

A knowledge base chatbot that answers from your documents.

An open-source agent that answers from your manuals and policies on web and chat apps, and hands unsure questions to staff.

AnHome AppliancesUsually replies instantly
  1. Website chat · replies by the Ecbot agent
  2. Today 9:41 PM
  3. Hi, my induction cooker shows E3 and turns off after a minute. Model AH-IC2221:41
  4. Ecbotset_customer_field result: model: AH-IC22
  5. E3 means overheating. Unplug it for 10 minutes and keep the bottom vent clear. If it comes back, the 24-month warranty covers it.21:41
  6. it's 26 months old, but I bought the store's 3-year extended plan. does that count?21:43
  7. The store's plan isn't in our warranty documents, so I won't guess. Our warranty team will reply right here.21:43
  8. Handed to staff: the agent isn't confident
  9. StaffHi, Minh from AnHome. We honour that plan. Send a photo of the receipt and I'll book a technician.21:52

Example conversationMade-up brand and terms; the answer comes from the manual, and the blue chip is a logged call the customer doesn't see.

Why your documents don't reach customers

Three things every business with a manual runs into.

Same questions, every day

Error codes, warranty, opening hours. The answer is on page 14 of a PDF, and staff type it again.

General AI invents a policy

A general bot confidently promises a warranty term you never offered. Then you honour it or apologise.

Four systems to build

Vector database, ingest pipeline, chat channels and a handoff inbox, all before the first answer.

How it works

Answers only from the documents you link.

Every message is kept. The agent searches its own documents, answers from what it finds, and passes unsure chats to staff.

Customers ask on

  • Messenger
  • Zalo
  • WhatsApp
  • Telegram
  • Website

Every message kept

Answered in turn

Your knowledge agent

One setup, every channel

KnowledgeToolsPlaybooks

The agent answers

  • Searches only its linked documents
  • Answers from the passages it finds
  • Checks records through your API
  • Hands unsure answers to staffSame inbox, full history
Knowledge in your own Postgres

Documents live in the Postgres you already run.

Upload PDFs, Word files, Markdown or web pages. Ecbot stores them in Postgres with pgvector, searches by vector and full text, then reranks.

  • No separate vector database to pay for
  • Each agent answers only from its linked documents
  • Document text is reference, never instructions

Customer question

“E3 error on the AH-IC22, what does it mean?”

Searched by the AnHome support agent

  • manual-AH-IC22.pdf
  • warranty-policy.docx
  • error-codes.md
  • service-centres.html

Not linked to this agent

  • dealer-prices.pdf
  • staff-handbook.pdf
  1. pgvector search
  2. Full-text search
  3. Reranked
  4. Top 5 passages

Passages the model answers from

  1. manual-AH-IC22.pdf · p.14E3: overheating. Unplug for 10 minutes. Keep the bottom vent clear with 5 cm of space.
  2. warranty-policy.docxInduction cookers: 24 months from the date on the receipt.

Postgres + pgvector, on your server if you self-host

Your staff stay in charge

When documents don't cover it, a person answers.

The agent hands over when it isn't sure, the customer asks for a person, or a keyword or guardrail fires. Staff reply in one inbox.

  • Choose how many failed replies trigger a handoff
  • Add your own keywords, like “warranty claim”
  • Add new staff answers to the knowledge base

The agent hands over when

  • The customer asks for a person
  • The agent isn't confident
  • A guardrail blocks a message
  • A label you mark as urgent
  • Your handoff keywords
Conversations
Pham Thu TrangNeeds you

It's 26 months old, but I bought the store's 3-year extended plan. Does that count?

That plan isn't in our warranty documents, so I'm passing you to our warranty team.

Handed to staff: The agent isn't confident

StaffHi Trang, Minh from AnHome. We honour that plan. Send the receipt photo and I'll book a technician.
An agent that does the work

Your API answers what the manual can't.

The manual says what's covered; your system knows if this serial is. Connect REST, MCP or Composio tools, and every call is logged.

  • Each agent uses only the tools you add
  • Failed calls show in the log with the error
  • Connect any internal system through REST or MCP
Activity log · AnHome support agent
TimeToolResult
21:41set_customer_fieldEcbot · model · AH-IC22OK
10:02check_warrantyREST API · serial AH22-0457OK
10:03book_technicianMCP · District 3 · Sat 9:00OK
10:03schedule_followupEcbot · in 3 days · repair checkOK
16:05check_warrantyREST API · serial AH19-1102 · timed outError
One customer across every app

Website question, Zalo receipt: one customer.

Ecbot keeps one profile per person across website, Zalo, Messenger, WhatsApp and Telegram. A shared phone or email suggests a merge your staff confirm.

  • Saved details, like a model number, stay on the profile
  • Staff notes follow the customer across apps
  • Nothing merges until a person confirms

Merge suggested

The Telegram profile “@trangpham” uses the same phone number as Pham Thu Trang.

Pham Thu Trang

09xx xxx 457 · trang.pham@example.com

  • Warranty
  • AH-IC22 owner

Contact points

  • Website chat · Visitor #4471Asked about error E3 · today
  • Zalo · Thu TrangSent the receipt photo · today
  • Messenger · Trang PhamAsked about pan sizes · March

Staff notes

Bought the store's 3-year plan. Prefers a Saturday morning visit.

What keeps answers on track

Playbooks, no dropped messages, and follow-ups after a repair.

Playbooks loaded on demand

Write your warranty process in markdown. The agent loads it only when a chat needs it.

skills/warranty-claim.mdLoaded for this chat
# Warranty claim
1. Ask for the model and serial number
2. Check coverage with check_warranty
3. Ask for a photo of the receipt
4. Outside the policy: hand to staff

No dropped messages

Every message is kept and answered in turn, even when 50 arrive at once.

  1. what does E3 mean?Answered
  2. where is your service centre?Answered
  3. +50 messages at once

    is the glass covered?Answered
  4. do you sell spare pans?Replying

Follow-ups after the repair

Set a follow-up from 1 minute to 30 days out. The agent rereads the chat and writes a fresh message.

- Technician booked: check the repair 3 days later

  1. Sat 9:00

    Technician visit for AH22-0457

  2. Tue 9:00

    Agent: “Is the cooker working well since the repair?”

  3. Customer: “all good”

    The agent thanks her and stops

Set up a knowledge agent in three steps

Start with one manual and test it privately before customers see it.

  1. 01

    Describe your business in one sentence

    The agent builder suggests a persona, tone, goals and rules. Edit what's off.

    Describe your business

    Home appliance brand answering warranty and error-code questions on our website and Zalo

    Suggested by the agent builder. Edit anything.

    Persona
    An, the AnHome support assistant
    Tone
    Clear and patient, short steps
    Goals
    • Answer error code and how-to questions
    • Explain the warranty terms
    Rules
    • Answer only from the linked documents
    • Ask for the model before troubleshooting
    • Hand warranty exceptions to staff
  2. 02

    Add documents and link them

    PDF, DOCX, TXT, HTML or Markdown up to 5 MB, web pages or notes.

    • manual-AH-IC22.pdf1.8 MBIndexed
    • warranty-policy.docx42 KBIndexed
    • error-codes.md9 KBIndexed
    • service-centres.html64 KBIndexed

    In Postgres with pgvector, on your server if you self-host

      Tools the agent can use

      • REST APIyour own
      • MCPany MCP tool
      • Composiomarketplace
      • Google Sheetsvia Composio
    • 03

      Go live on your site or chat apps

      Embed the widget, connect Telegram or call the REST API. No platform approval needed.

      • MessengerAvailable
      • ZaloAvailable
      • WhatsAppAvailable
      • TelegramAvailable
      • Website chatAvailable

      On the roadmap: Instagram, TikTok Shop, Shopee, LINE

    Security

    Your business data stays yours.

    How Ecbot guards credentials, screens messages and keeps businesses apart.

    Encrypted credentials

    Platform tokens use AES-256-GCM with versioned keys, so keys rotate without taking channels offline.

    Secrets never reach the AI

    Credentials never enter the model's context, so no prompt can pull them out.

    Guardrails in both directions

    Incoming messages are screened for scams and prompt attacks, replies for leaked data. You set the strictness.

    Workspaces and roles

    Each business gets its own workspace. Staff join by invitation with a role, checked on every request.

    Open source. Self-host it if you want.

    On GitHub under AGPL-3.0, with every Cloud feature. Your knowledge stays in your own Postgres.

    View on GitHub

    Questions about the knowledge agent

    It's an AI agent that answers customers from documents you add: manuals, policies, price lists and web pages. It runs on your website, Zalo, Messenger, WhatsApp, Telegram or REST API, and hands unsure chats to staff.

    Last updated: 2026-09-22

    Let your documents answer your customers.

    Join the waitlist for Ecbot Cloud, or self-host the open-source version today.

    Or self-host the open-source version from GitHub