# Bffworks AI Chatbot & Live Chat

***

### Overview

* **AI Chatbot** answers questions about products, orders, and policies using your store’s real data.
* **Live Chat**: your team can jump into any conversation at any time.
* **Multilingual**: auto‑detects and replies in the shopper’s language.
* **Conversion‑friendly**: suggests related items and gentle add‑to‑cart CTAs (never pushy).
* **Lower support load**: automates repetitive FAQs (shipping/returns/sizing, etc.).

***

### Why merchants choose Bffworks

* **Higher conversion**: help at the exact moment of purchase intent.
* **Lower support costs**: the bot handles common questions; escalates only when needed.
* **Seamless experience**: Q\&A → suggestions → add‑to‑cart → human takeover.
* **Always available**: 24/7 coverage across time zones.
* **Multilingual by default**: friendly for international shoppers.
* **Fast setup, easy to scale**: launch in minutes, expand content anytime.

***

### Key features

**Intelligent Chatbot**&#x20;

* Answers from **products, variants, inventory, descriptions**, FAQs, and store knowledge.
* Understands natural language (semantic search)

**Live Chat for your team**

* **Takeover**: staff can join and lead any ongoing conversation.
* **Smart handoff**: prompts a human when confidence is low or the shopper asks.

**Brandable UI**

* Customize widget logo, colors, greeting.

**Multilingual**

* Detects language automatically and responds accordingly, you can set language for labels on chatbot.

**Security & anti‑spam**

* Built‑in **Cloudflare Turnstile** to deter spam and abusive automation.
* Conversation logs for quality control.

***

### How Bffworks works

1. **Connect & sync**\
   The app syncs products (and optionally FAQs/policies/knowledge) from Shopify.
2. **Semantic indexing**\
   Content is processed so the bot can find, understand, and answer with citations where appropriate.
3. **On‑site conversations**\
   Shoppers chat on your storefront; the bot answers, suggests, and invites Live Chat when needed.

> Everything runs within your Shopify stack. Install and remove cleanly.

***

### Quick start (≈5 minutes)

1. **Install** the app from Shopify.
2. Open **Bffworks** and follow the **Setup Guide** in the Dashboard.
3. **Enable Theme App Embed** to show the chat widget on your storefront.
4. **Sync products** and add **FAQs/Knowledge** (optional).
5. Customize **greeting, colors, logo** → **Save Settings**.

> Tip: Seed 10–20 FAQs (shipping/returns/sizing). It boosts accuracy immediately.

***

### Best practices

* Use clear **product titles** and consistent **tags/vendor/product type** for better retrieval.
* Enrich descriptions (materials, dimensions, care, examples).
* Keep **inventory & variants** accurate so suggestions stay trustworthy.
* Normalize **FAQs & policies**: concise, specific, with examples.
* Define **handoff rules** so the team knows when to jump in.

***

### Security, privacy & compliance

* **Bffworks** uses the data you supply solely to answer and support your shoppers.
* **Cloudflare Turnstile** limits spam/abuse.
* Supports **GDPR requests** (access/erasure) initiated by the merchant.
* Data is isolated per shop; no cross‑store sharing.

> See *Privacy Policy* and *Terms of Service* on <https://docs.bffworks.com/privacy-policies>.

***

### Quick troubleshooting

* **Widget not visible**: is *Theme App Embed* enabled? Clear browser/theme cache.
* **Bot not responding**: check network, captcha (Turnstile) configuration, or data sync status.
* **Products not found**: ensure products are **Active**, and re‑sync.
* **Slow handoff**: confirm staff are logged into the admin.
* **Wrong language**: review language preferences in Settings.

> When contacting support, include **shop domain**, **screenshots**, and **time of occurrence**.

***

### FAQ

**Which languages are supported?**\
Multiple major languages out of the box; extendable based on your content.

**Does the bot add to cart automatically?**\
No. It uses friendly CTAs and only adds to cart when shoppers clearly opt in.

**Can I train it on private docs?**\
Yes. Upload FAQs/knowledge, Store Profile (policies, guides, brand story) for the bot to reference.

**Is my data safe?**\
We apply industry‑standard security; data is scoped to your store and used only to serve your shoppers.

**Do I need to code?**\
No. Most configuration is point‑and‑click in the admin.

**Will uninstall leave theme clutter?**\
No. Disabling the Theme App Embed removes the widget.

***

### Support & contact

* **Email**: <support@bffworks.com>
* For faster help, include your **shop name or Shopify domain**, a short description, screenshots, and (if available) the **Conversation ID**.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bffworks.com/bffworks-ai-chatbot-and-live-chat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
