Manova Introduction
Everything you need to build on Manova, the AI sales and support assistant for online shops.
Manova answers your customers on your website, Telegram and Bale. It knows your products and prices, looks up orders, and hands the conversation to a person on your team when it should. These docs cover the parts you can build on.
Add the widget
One script tag puts the assistant on any website. Control it from your own buttons.
Connect a store
Send your catalog so the assistant shows real prices and stock, and answer "where is my order?".
Custom CMS guide
Not on WooCommerce? Implement the same contract from your own platform in an afternoon.
Chat API
Talk to Manova's AI models from your own code, with streamed replies.
Three kinds of keys
Manova has three credentials, each for one job. Never mix them up, and never put a secret one in a web page.
| Key | Looks like | Where it lives | Used for |
|---|---|---|---|
| Widget key | pk_ + 32 characters | Public, in your page's HTML | Loading the widget |
| Store connection key | mnv_<store>_<secret> | Secret, on your server | The store API and signing order lookups |
| API token | manova_ + 64 hex characters | Secret, on your server | The chat API |
See Authentication for where to create each one.
Base URL
All server APIs live under one base URL:
https://manova.ir/api/v1/externalRequests and responses are JSON (UTF-8), except the chat endpoint, which streams server-sent events. Errors always have the same shape.
For AI tools
These docs are available as plain text for LLMs and coding agents: /llms.txt lists every page and
/llms-full.txt has all of them in one file. Every page also has a Copy Markdown button.