# VIZOCHOK

## Docs

- [Check catalog upload progress](https://docs.vizochok.com/api-reference/catalog/check-catalog-upload-progress.md): Poll this endpoint to track the progress of a bulk catalog upload. Returns embedding status, counts, and any errors.
- [Delete Product](https://docs.vizochok.com/api-reference/catalog/delete-product.md): Soft-delete a product by setting is_active = false.
- [Get Product](https://docs.vizochok.com/api-reference/catalog/get-product.md): Get full product details by SKU (catalog data only, no prices).
- [List Products](https://docs.vizochok.com/api-reference/catalog/list-products.md): List products with pagination, optional filtering and text search (catalog only, no prices).
- [List recent catalog jobs](https://docs.vizochok.com/api-reference/catalog/list-recent-catalog-jobs.md): Returns up to 50 most recent catalog upload jobs, sorted by most recent first.
- [Patch Product](https://docs.vizochok.com/api-reference/catalog/patch-product.md): Partial update of a product. Re-embeds only if content fields change.
- [Upsert Products](https://docs.vizochok.com/api-reference/catalog/upsert-products.md): Bulk upsert products. Saves metadata immediately, embeds in background.
- [Delete Conversation](https://docs.vizochok.com/api-reference/conversations/delete-conversation.md): Delete a conversation from both PostgreSQL and Redis.
- [Get Conversation](https://docs.vizochok.com/api-reference/conversations/get-conversation.md): Get full conversation details by ID.
- [List Conversations](https://docs.vizochok.com/api-reference/conversations/list-conversations.md): List conversations for the tenant, optionally filtered by user_id.
- [Delete User Profile](https://docs.vizochok.com/api-reference/users/delete-user-profile.md): Delete user profile and all their conversations (GDPR compliance).
- [Get User Profile](https://docs.vizochok.com/api-reference/users/get-user-profile.md): Get user profile by tenant_id + user_id.
- [Update User Profile](https://docs.vizochok.com/api-reference/users/update-user-profile.md): Update user profile fields (upsert pattern).
- [Architecture](https://docs.vizochok.com/concepts/architecture.md): System architecture, data flow, and design decisions
- [Error Codes](https://docs.vizochok.com/concepts/error-codes.md): Complete reference for all error codes returned by the API and SDK
- [Rate Limiting](https://docs.vizochok.com/concepts/rate-limiting.md): Three-tier rate limiting system: per-connection, per-user, and per-tenant
- [WebSocket Protocol](https://docs.vizochok.com/concepts/websocket-protocol.md): Complete specification for the VIZOCHOK real-time chat protocol
- [Cart Synchronization](https://docs.vizochok.com/guides/cart-sync.md): How VIZOCHOK keeps the AI-managed cart in sync with your backend cart state via webhooks and SDK events.
- [Catalog Upload](https://docs.vizochok.com/guides/catalog-upload.md): Upload your product catalog to VIZOCHOK for AI-powered search. Learn the data format, bulk upload, job tracking, and partial updates.
- [AI Customization](https://docs.vizochok.com/guides/customization.md): Customize the AI assistant's personality, greeting, store rules, and available tools to match your brand.
- [Mobile Integration](https://docs.vizochok.com/guides/mobile-integration.md): Integrate VIZOCHOK into React Native, Flutter, and native mobile apps via direct WebSocket connection.
- [WebSocket Direct Integration](https://docs.vizochok.com/guides/websocket-direct.md): Connect to VIZOCHOK via WebSocket without the SDK, for backend clients, custom frontends, and mobile apps.
- [Widget Integration](https://docs.vizochok.com/guides/widget-integration.md): Step-by-step guide to embedding the VIZOCHOK AI shopping assistant into your storefront.
- [Introduction](https://docs.vizochok.com/introduction.md): VIZOCHOK is an AI-powered shopping assistant for grocery retail. Embed a smart chat widget into your store and let customers find products, get recommendations, and manage their cart, all through natural conversation.
- [Quickstart](https://docs.vizochok.com/quickstart.md): Get your AI shopping assistant running in 5 minutes. Install the widget, connect to the API, and start chatting.
- [Cart Webhook](https://docs.vizochok.com/webhooks/cart.md): Complete specification for the cart webhook. Handle add, remove, update, and clear operations from the AI assistant.
- [Webhook Architecture](https://docs.vizochok.com/webhooks/overview.md): How VIZOCHOK communicates with your backend via server-to-server webhooks for real-time prices, stock, and cart operations.
- [Products Webhook](https://docs.vizochok.com/webhooks/products.md): Complete specification for the products pricing webhook. Implement this endpoint to provide real-time prices and stock availability.
- [Signature Verification](https://docs.vizochok.com/webhooks/signature.md): Verify VIZOCHOK webhook authenticity using HMAC-SHA256 signatures. Code examples in Python, Node.js, and Go.
- [Configuration](https://docs.vizochok.com/widget/configuration.md): Complete reference for all VIZOCHOKWidget config options
- [Events & Callbacks](https://docs.vizochok.com/widget/events.md): Handle cart changes, product clicks, errors, and connection events
- [Examples](https://docs.vizochok.com/widget/examples.md): Integration examples for common frameworks and scenarios
- [Installation](https://docs.vizochok.com/widget/installation.md): Install the VIZOCHOK widget SDK in your project
- [Theming](https://docs.vizochok.com/widget/theming.md): Customize the widget appearance to match your brand

## OpenAPI Specs

- [openapi](https://docs.vizochok.com/openapi.json)