# ZevWorkspace Documentation

> ZevWorkspace is a customer workspace and CRM: sales pipelines, records, contacts, companies, products, projects, and a real-time live chat support inbox. Part of the Zev suite by ZevOP Technologies.

This file follows the [llms.txt convention](https://llmstxt.org/). It is a curated index intended for AI agents and developers feeding documentation context to language models. The full text of every page concatenated as one file is at `/llms-full.txt`. Each page is also available as raw markdown at `<page-url>.md` (for example, `https://docs.zevworkspace.com/live-chat/installation.md`).

## Key facts an agent should know

- The live chat widget is embedded with one script tag: `https://widget.zevworkspace.com/v1/loader.js` plus a public `data-zev-key` (the brand embed key, format `pk_live_...`).
- The embed key is public. The security boundary is the per-brand embed-domain allowlist, enforced at the WebSocket handshake, not the key.
- The widget exposes a `window.Zev` JavaScript API: `Zev.open()`, `Zev.close()`, `Zev.toggle()`, `Zev.set(attrs)`, and `Zev.identify(externalId, hmac, attrs)`.
- `Zev.set` attaches unverified display attributes. `Zev.identify` establishes verified identity using an HMAC your backend computes with the brand identify secret; the secret never reaches the browser.
- The bubble is full-screen on mobile. Its visibility is controlled per surface with `data-zev-launcher` (`default` / `none` / `desktop` / `mobile`); any element with `data-zev-chat` opens the panel on click.
- REST API base URL: `https://api.zevworkspace.com` (reference sections for contacts, companies, pipelines, records, and projects are published here as they ship).

## Live Chat

- [Live chat overview](https://docs.zevworkspace.com/live-chat): The ZevWorkspace live chat widget is an embeddable support chat for any website. Learn what it does, how it connects to your workspace, and how to add it.
- [Custom launchers](https://docs.zevworkspace.com/live-chat/custom-launchers): Control where the ZevWorkspace chat bubble appears, or replace it with your own button. Use data-zev-launcher, the data-zev-chat attribute, and Zev.open to open chat on your terms.
- [Customizing the widget](https://docs.zevworkspace.com/live-chat/customization): Configure the ZevWorkspace live chat widget from the dashboard. Set brand color, logo, welcome copy, launcher position, business hours, identity collection, and visibility.
- [Identifying visitors](https://docs.zevworkspace.com/live-chat/identity): Verify who a ZevWorkspace live chat visitor is with a signed identity claim. Compute the HMAC on your backend, call Zev.identify, and link conversations to a contact.
- [Install the live chat widget](https://docs.zevworkspace.com/live-chat/installation): Add the ZevWorkspace live chat widget to any website with one script tag. Get your brand embed key, set your embed domains, and verify the install.
- [JavaScript API](https://docs.zevworkspace.com/live-chat/javascript-api): Control the ZevWorkspace live chat widget at runtime with the window.Zev API. Open and close the panel, attach visitor attributes, and identify signed-in customers.