# Start here — put Synderesis support on your website

**Full guide:** [docs/customer-setup-guide.md](./docs/customer-setup-guide.md)
**Operators shipping this product:** [docs/SHIPPING.md](./docs/SHIPPING.md)

**You do not need an API key on your website.**
Visitors only use a **public site key** (`pk_live_…`). Your secret Synderesis credentials never go in WordPress, Shopify, or page HTML.

**Operators / Hasse:** full technical handoff is in [HANDOVER.md](./HANDOVER.md) (version in [VERSION](./VERSION)).

Time needed: about **10–15 minutes** the first time.

---

## What you get

A chat bubble on your site that:

1. Answers routine questions from **your** FAQ (hours, shipping, products, returns…)
2. Speaks in **your** tone
3. Offers **leave a message for a person** when it should not invent an answer

---

## Five steps

### 1. Sign in to Synderesis

Go to [synderesis.eu/account](https://www.synderesis.eu/account/) and sign in (or create an account).

You do **not** need a developer API key (`syn_…`) for this product.

### 2. Open the agent admin

Open: **[Customer agent admin](https://www.synderesis.eu/customer-agent/admin/)**

(Local testing: `http://127.0.0.1:8080/customer-agent/admin/`)

### 3. Create your agent

Fill in:

| Field | What to write |
|--------|----------------|
| **Business name** | Your shop or organisation name |
| **Greeting** | First message visitors see |
| **Voice** | e.g. “Warm, short, professional” |
| **Escalation email** | Where human handoffs go |
| **Allowed websites** | Your site URL, or `*` while testing |

Click **Create agent**.
**Copy the public site key immediately** — it is shown once (you can rotate later).

### 4. Add your FAQ

Paste plain text about:

- Opening hours
- Shipping / delivery
- Returns
- Products / services
- Contact rules

Use the sample in `templates/sample-faq.txt` if you want a starting point.

### 5. Put the chat on your website

**Easiest — WordPress**

1. Upload `synderesis-customer-agent-1.4.0.zip` (see `integrations/wordpress/`)
2. Activate → **Settings → Synderesis Agent**
3. Paste your `pk_live_…` key → Save → **Test connection**
4. Allow your site origin in agent admin

**Any other site (Squarespace, Wix, custom, Shopify theme)**

Paste this before `</body>` (replace the key):

```html
<script src="https://www.synderesis.eu/embed/agent.js"
        data-site-key="pk_live_YOUR_KEY_HERE"
        data-api-base="https://www.synderesis.eu"
        async></script>
```

Full copy-paste variants: [docs/install-snippets.md](docs/install-snippets.md)

### 6. Test (private page)

Open:
`https://www.synderesis.eu/customer-agent/test/?key=pk_live_YOUR_KEY_HERE`

This test page is **not** linked from the public marketing site.

---

## If something fails

| Symptom | Try this |
|---------|----------|
| Widget does not appear | Hard-refresh the page; check the script tag is present |
| “Origin not allowed” | In admin, set **Allowed origins** to your exact site URL or `*` for a test |
| Answers invent facts | Add clearer FAQ text; tell it only to use uploaded knowledge |
| Cannot open admin | Sign in at `/account/` first, then reopen admin |
| No model replies yet | Early access / service may still be waitlist-only — setup still works; live answers need service enabled |

More help: [docs/webmaster-guide.md](docs/webmaster-guide.md) · [docs/faq.md](docs/faq.md)

---

## What *not* to do

- Do **not** paste a `syn_…` API key into your website
- Do **not** put passwords in the embed snippet
- Do **not** allow `*` origins forever on a live shop — lock to your domain when ready