Documentation

Everything Pelifi can do.

New here? Start with the step-by-step setup guide instead. This page is a reference for every feature once you're up and running.

Core concepts

An organization (created right after sign-up) is your account. It holds everything specific to you: your knowledge base, your widget and API keys, your plan and billing, and any teammates you invite. Each organization is fully separate from every other customer's.

Your knowledge base is whatever you've added, files, web pages, and/or live database connections. The widget (or the standalone /ask page) answers visitor questions using only that content, with inline citations back to the source.

Knowledge base

Securely upload your product catalogue, FAQs and business policy documents, and Pelifi generates a custom customer-facing chatbot from them. Add content three ways, and mix all three: the widget draws from everything at once.

  • Files: PDF, Word (.docx), CSV, plaintext, or Markdown. Upload one or several at once. Images too, JPG, PNG, WebP and GIF: the text in them is read out first, so a photographed menu or a scanned policy works as a source. Upload images at the highest resolution you have, since accuracy depends on how legible the text is: a scaled-down copy or a screenshot of a photo loses the small print first, which tends to be the prices and the conditions. A picture with no text in it has nothing to answer from and is refused rather than stored empty. Files go to private storage, never a public URL, and are readable only by your own account.
  • URLs: a single page, or a full-site scan (sitemap-first discovery, with a link-crawl fallback, respecting robots.txt). Add several URLs at once.
  • Live databases: Postgres, MySQL, SQL Server, or Oracle, via a read-only connection string. Nothing is copied out; a question triggers a live, sandboxed, read-only query against your actual data instead of a static snapshot.

Every source gets its own citation number, shown in brackets next to the claim it supports, including every individual page discovered by a site scan. Re-adding a URL, file, or database connection that already exists is rejected with a clear message rather than silently duplicating it.

Managing sources

Select any number of sources to bulk-delete, or bulk-enable/disable, disabling excludes a source from answers without deleting its embeddings, useful for content that's temporarily outdated. Deleting a file source also deletes its underlying stored file.

Keeping content fresh

URL sources can be set to re-scan automatically (off, daily, weekly, or monthly, depending on your plan). A content-hash check skips the embedding cost entirely when a re-scan finds nothing actually changed. You can also trigger "Rescan now" on demand, rate-limited per day per your plan.

The embeddable widget

One script tag, pasted before the closing </body> tag on any page:

<script
  src="https://pelifi.com/widget.js"
  data-tenant-key="ragpk_your_public_key"
  defer
></script>

It renders in an isolated Shadow DOM, so it can never conflict with your site's own CSS. A chat bubble appears in the corner you choose; clicking it opens a panel that streams answers token-by-token as they generate.

Customization

Set the widget's title, accent color, screen corner, and fallback message (shown when a question can't be answered from your content) from Widget & API key in your dashboard. Changes apply live to every page it's embedded on. Nothing to re-embed.

API keys & domain restriction

A public key (ragpk_...) is safe to publish in client-side HTML. It only grants scoped, rate-limited read access to your knowledge base and can't reach your dashboard. Optionally restrict a key to one or more specific domains so it only works from sites you authorize; an unrestricted key still counts usage against your plan and requires an explicit confirmation when you create it.

No website? Use the /ask page

Every API key also gets a standalone hosted page. The same answers, citations, and features as the embedded widget, full-page instead of a floating bubble. Share it as a plain link or a QR code (generated from Widget & API key), with a customer-editable title and description shown above the chat so a visitor arriving cold, say, from a scanned QR code on a printed flyer, knows who they're talking to before typing anything.

Questions &amp; feedback

Your widget can offer three modes, each enabled independently on your plan. Questions (ask, get a cited answer), Feedback (leave free-text feedback, no answer expected), and Call me back (leave a name, a phone number and what it is about, which lands on your Leads page). With more than one available visitors get a small chooser; with only one, the widget runs in that mode with no chooser shown.

Feedback submissions are automatically sentiment-classified and show up in your Analytics dashboard.

How an answer is found

Two searches run over your content for every question. One matches on meaning, so a visitor asking about “shipping times” finds a page written about “delivery”. The other matches the words literally, which is what makes “what are all the vegetarian options?” return every one rather than the first few. The results are merged, and anything you have written as a Q&A pair is placed first: when a visitor's question matches one you wrote, they get the answer you wrote.

Misspellings are handled. If a question finds nothing, it is corrected and searched again before the assistant gives up, so “wat time do you clsoe” is answered rather than shrugged at.

What it will not do

It answers only from what you have added. Ask it something your content does not cover and it says so rather than filling the gap from general knowledge, because an assistant that invents an answer makes your business look like it published something it never said.

It also will not count things for you. Each answer is written from a handful of retrieved passages rather than a whole document, so asking “how many transactions are in this spreadsheet?” gets an honest “I can't total that from what I can see” instead of a confident wrong number. If you need real totals, connect the data as a database rather than uploading it as a file: the assistant can then run an actual query and give you the true figure.

Optional enhancements (plan-dependent)

  • Quick replies: a set of suggested questions shown before the visitor types anything, for a faster first interaction.
  • Human handoff: a link to a contact email you set, for when a visitor wants to reach a real person.
  • Multi-language answers: the widget detects a visitor's browser language and responds in it automatically, regardless of what language your source content is written in.

Configure all three from the Widget settings page in your dashboard.

Analytics

If enabled on your plan, Analytics in your dashboard shows every question and feedback submission, each with automatic sentiment classification, in filterable Questions/Feedback tabs, with a volume-and-sentiment chart, a time-range filter, and a sortable, paginated table of recent activity (including which domain each question or feedback came from, if you embed on more than one site).

Unanswered questions

Questions your widget couldn't answer are auto-detected and grouped into topic categories, so you can see exactly what to add to your knowledge base next, available on select plans.

Digest email

A periodic summary of question/feedback/unanswered activity, sent to whoever you designate, frequency and recipients are configurable, where available on your plan.

Team &amp; billing

Invite teammates into your organization from Clerk's organization switcher in the dashboard header. The number you can add is capped by your plan. Billing changes, payment-method updates, and account deletion are restricted to the organization's owner; other members keep full working access to everything else.

Subscribe, switch plans, or cancel any time from Billing in your dashboard, self-serve, no need to contact anyone. Switching plans applies immediately with prorated charges/credit; a downgrade that would put you over the target plan's limits (documents, database connections, etc.) is blocked with a clear explanation of what to remove first. Use Manage billing on the same page to update your payment method, view/download past invoices, or reach Stripe's own billing tools directly.

Data &amp; security

Two different things, and it is worth being precise about which is which.

Your files are stored securely. Uploads go to private storage rather than a public URL, every row and every search is scoped to your account, and database connection strings are encrypted at rest with AES-256-GCM. Nobody browsing the internet can find your documents, and no other customer can reach them.

What is inside them is answerable to visitors, by design. That is the product: anything you add to your knowledge base can be surfaced in an answer to any visitor of a site where your widget or shared link is live, and there is no login on the visitor-facing side. Storing a file securely is not the same as keeping its contents private. Don't add confidential or sensitive information you would not want quoted back to a stranger.

Database connections are read-only and sandboxed. Every query is wrapped, capped, and restricted toSELECT/WITH statements only; nothing you connect can be modified through the widget.

Deleting your account is a soft delete: sign-in access is locked and your content is removed, but your question history is preserved. Reach it from Billing in your dashboard.

Status &amp; maintenance

Current system status, and a history of past incidents and scheduled maintenance, is always available at pelifi.com/status.

Questions this page doesn't answer?

Contact us