# Sophi Documentation

> Sophi is an agentic-commerce platform, integrated via two packages:
> `@usesophi/sophi-web-sdk` (chat widget) and `@usesophi/sophi-web-object` (tracking).
> Full text: /llms-full.txt · any page as Markdown: append `.md` · agent skill: /skill.md
> Use only APIs documented on the linked pages — there is no `@sophi/sdk` package or `.track()` method.

- [Get Started](/docs/get-started): What Sophi is, how to pick your integration path, and a 5-minute quick start to send your first event.
- [Sophi Documentation](/docs): Build with Sophi — agentic commerce for your store.
- [Cookie Consent Management](/docs/frontend-integration/cookie-consent): How to keep Sophi usable from the first page view while respecting GDPR/KVKK cookie rules.
- [Frontend Integration](/docs/frontend-integration): Embed the Sophi assistant widget, track storefront events, and manage cookie consent with framework guides for React and Angular.
- [Sophi Ürün Feed Rehberi / Product Feed Guide](/docs/product-integration/feed-guide): Complete specification for the Sophi product XML feed — required fields, variant grouping rules, product attributes, and common mistakes.
- [Product Integration](/docs/product-integration): Connect your product catalog to Sophi via a structured XML feed. Covers feed format, field reference, variant rules, and a sample feed.
- [Sample Feed XML](/docs/product-integration/sample-feed): A working XML feed example with 2 products and 4 variants, covering all required fields, variant grouping, product attributes, and care instructions.
- [AI Coding Agents](/docs/use-with-ai): Install the Sophi skill so your AI coding agent — Codex, Claude Code, Cursor, Windsurf — integrates Sophi into your storefront for you, reading the live docs as it works.
- [Angular Integration](/docs/frontend-integration/frameworks/angular): Angular integration guide with basic (full-page and modal) and advanced widget methods for Sophi.
- [Framework Integrations](/docs/frontend-integration/frameworks): Drop-in integration guides for embedding the Sophi assistant widget in React and Angular apps.
- [React Integration](/docs/frontend-integration/frameworks/react): React integration guide with basic (full-page and modal) and advanced widget methods for Sophi.
- [Events](/docs/frontend-integration/sdk/events): The widget exposes an event-driven API. Attach listeners in your application and keep business logic there.
- [GTM Integration](/docs/frontend-integration/sdk/gtm-integration): Load the Sophi Web SDK via Google Tag Manager with consent-aware script injection and app-side initialization.
- [SDK Overview](/docs/frontend-integration/sdk): Use @usesophi/sophi-web-sdk to embed the Sophi assistant in your storefront and handle widget events in your application code.
- [Initialization](/docs/frontend-integration/sdk/initialization): Initialize the widget in your application after the SDK is loaded and the target container is available in the DOM.
- [Installation](/docs/frontend-integration/sdk/installation): Install @usesophi/sophi-web-sdk from npm and initialize the SophiWidget in your storefront.
- [Methods](/docs/frontend-integration/sdk/methods): Reference for the SophiWidget instance methods — lifecycle (init, destroy, isReady), visibility, cart updates, sending messages and product replies, and event subscription.
- [Security Best Practices](/docs/frontend-integration/sdk/security-best-practices): Use these practices when integrating the widget in production environments.
- [Configuration](/docs/frontend-integration/web-object/configuration): All runtime settings for the Sophi Web Object, provided via window.sophi_object.config including apiKey, userId, maxRetries, debounceMs, debug, and storageConsent.
- [Event types](/docs/frontend-integration/web-object/event-types): Events sent to the backend use ExternalEventType on the envelope. Values are lowercase snake-case strings.
- [Data and auth flows](/docs/frontend-integration/web-object/flows): Overview of the event pipeline, auth flow, and session lifecycle for the Sophi Web Object SDK.
- [GTM integration](/docs/frontend-integration/web-object/gtm-integration): How to load @usesophi/sophi-web-object (the storefront event-tracking SDK) through Google Tag Manager, including recommended split and all-in-GTM configurations.
- [Sophi Web Object (@usesophi/sophi-web-object)](/docs/frontend-integration/web-object): The Sophi Web Object package is a framework-agnostic browser SDK that tracks e-commerce behaviour via window.sophi_object and sends structured events to the Sophi event API.
- [Installation](/docs/frontend-integration/web-object/installation): The npm package is @usesophi/sophi-web-object. Artifacts live under dist/ in the package.
- [Integration guide](/docs/frontend-integration/web-object/integration-guide): How to deliver @usesophi/sophi-web-object to your storefront — choose between GTM, npm/bundler, or CDN script tag depending on your stack.
- [Integration patterns](/docs/frontend-integration/web-object/integration-patterns): Common integration patterns for page views, SPA navigation, cart events, purchases, and user login/logout using the Sophi Web Object SDK.
- [SophiTracker API](/docs/frontend-integration/web-object/sophi-tracker): After the bundle loads, window.SophiTracker exposes the public imperative API for SPAs, batched updates, login/logout events, and multi-object pushes such as add_to_cart.
- [Types reference](/docs/frontend-integration/web-object/types): TypeScript type definitions for all Sophi Web Object data structures including PageObject, UserObject, ProductObject, BasketObject, and EventEnvelope.
- [Validation](/docs/frontend-integration/web-object/validation): Before an event is sent, @usesophi/sophi-web-object runs client-side field validation; failures log a console.warn and the event is skipped without any network request.
- [The window.sophi_object layer](/docs/frontend-integration/web-object/window-object): The global window.sophi_object follows the SophiObjectShape — a config block, an optional event-type override, and optional context objects (page, user, product, basket, listing, transaction) that trigger event collection when assigned.