Documentation
Everything an integrator needs: what to paste, what to sign, what to expect. A working install is two script lines. Actions take your API documentation URL and one signing endpoint on your server.
Install the widget
A script tag or an npm package, the site key, the Content-Security-Policy entries, and the attributes you can set.
Getting startedidentify(): sign on your server
Actions exist only for identified users. Your server signs the identity with the site's secret; the widget passes it along; a wrong signature is a 401.
Getting startedtrack() and the conversion webhook
A conversion signal from the page or from your server, deduplicated on your own event id, attributed to recommendations with a holdout.
ActionsActions: from your OpenAPI spec to enabled tools
Import the spec, review classifications, choose an auth scheme, enable the tools you want. Everything starts disabled.
OperatingEscalation webhook
When a conversation goes to a person: the payload, the signature to verify, retries, the email fallback and business hours.
OperatingThe catalog: feed, endpoint, or your pricing page
Where recommendations come from. Structured attributes, offers with real prices, and the rule that the agent never states a price the catalog did not give it.
OperatingServer keys and the reindex webhook
ak_secret_ keys for your backend: scopes, storage, and the two endpoints they open.
OperatingThe security model, technical version
The exact checks behind the security page, for the engineer who will read it closely: the intent shape, validation, identity signing, confirmations, idempotency, encryption, refusal reasons.