Spaces:
Running
Running
| # WordPress plugin — Synderesis Customer Agent | |
| **Plugin version:** 1.4.0 | |
| **Product package:** `customer-agent` (separate from marketing `website/`) | |
| ## For site owners (not developers) | |
| ### Install from zip (recommended) | |
| 1. Get the zip from your Synderesis contact, **or** build it (see below). | |
| 2. WordPress → **Plugins → Add New → Upload Plugin → Install → Activate**. | |
| 3. **Settings → Synderesis Agent** | |
| 4. Paste your **`pk_live_…`** public site key from | |
| [agent admin](https://www.synderesis.eu/customer-agent/admin/) | |
| 5. **Save settings** | |
| 6. Click **Test connection** | |
| 7. In Synderesis admin, set **Allowed websites** to your WordPress site URL | |
| (shown on the settings page), or `*` while testing | |
| 8. Visit the public site (purge cache if needed) — chat bubble bottom-right | |
| ### Important | |
| - **Never** paste a `syn_…` secret API key — the plugin rejects those. | |
| - Only `pk_live_…` belongs in WordPress. | |
| ### Sitewide vs one page | |
| | Mode | How | | |
| |------|-----| | |
| | Whole site (default) | Enable + Sitewide checked | | |
| | One page only | Uncheck Sitewide, add shortcode `[synderesis_agent]` | | |
| ### Optional overrides | |
| - Bubble position (left/right) | |
| - Brand colour hex | |
| - Open panel on load | |
| - Suggestion chips (`Q1|Q2|Q3`) | |
| --- | |
| ## Build the release zip (operators) | |
| From the monorepo: | |
| ```powershell | |
| powershell -File customer-agent/integrations/wordpress/scripts/build-zip.ps1 | |
| ``` | |
| Output: | |
| `customer-agent/integrations/wordpress/synderesis-customer-agent-1.4.0.zip` | |
| That zip is what you send customers or upload in WordPress. | |
| Also documented in [docs/SHIPPING.md](../../docs/SHIPPING.md). | |
| --- | |
| ## Uninstall | |
| 1. Deactivate and **Delete** the plugin. | |
| 2. `uninstall.php` removes plugin options from WordPress. | |
| 3. Agents and FAQs on Synderesis are **not** deleted (manage those in agent admin). | |
| --- | |
| ## Troubleshooting | |
| | Symptom | Fix | | |
| |---------|-----| | |
| | Test connection 403 | Add this site origin under Allowed websites in Synderesis | | |
| | Test connection 404 | Wrong/inactive site key | | |
| | No bubble after save | Purge page/CDN cache; confirm Enable is on | | |
| | Rejected key | You pasted `syn_…` — use `pk_live_…` | | |
| --- | |
| ## Support | |
| Point customers to the [customer setup guide](../../docs/customer-setup-guide.md). | |