Conviro for Magento 2 — documentation

Module conviro/module-aichat (Magento module Conviro_AiChat), release 1.4.0. 1.4.1 and 1.5.0 are unreleased (branches fix/magento-1.4.1 and feat/magento-1.5.0-customer-hub); pages and sections about them say so. (Updated 2026-09-27: this line named only 1.4.0 while the 1.4.1 pages were already here.)

Documentation status. Written 2026-09-24 against the code on feat/magento-10-10 at d3472ce2; updated 2026-09-25 for revenue attribution and the release-gate R3 fixes. Before the 1.4.0 version bump and before anything was deployed. Unless a page says otherwise, measurements come from the local Magento 2.4.7-p4 test stack (integrations/magento2/dev/; the version matrix of 2026-09-26 re-ran the suite on 2.4.4-p13 and 2.4.9), not from a merchant store or production. No TODO (release pass) line is left.

Where these pages are served. At https://repo.conviro.io/docs/magento2/ — Conviro's API serves them (security review R3, 2026-09-25): public, read-only, cached, rendered from these Markdown files without any raw HTML, under a strict Content Security Policy. English only: they are technical pages for the people who install and operate the module, and the marketing site's 11-locale rule is for marketing pages. The module links its Integration Health rows and setup-wizard steps to <Documentation URL>/<page>#<anchor> (Documentation URL, conviro_aichat/general/docs_url, default https://repo.conviro.io/docs/magento2); the page is the file name without .md (this page is the index). The anchors the module uses are stable <a id>s on these pages (integration-health#row-*, setup-wizard#step-*, reconnect-disconnect#disconnect-from-magento). After editing a page run node apps/api/scripts/build-magento-docs.mjs and commit the copy under apps/api/src/assets/magento-docs/ with it — a test fails while the copy is stale.

What the integration does

Conviro's AI assistant answers your shoppers in chat — product questions, prices, stock, order status and tracking, returns — from your live Magento data, and can prepare order actions that you control.

 Magento store                                  Conviro
 ─────────────                                  ───────
 Conviro_AiChat module
   events (products, stock, orders, …) ──────▶  knowledge base, order history,
     queued locally, sent by cron                leads, cart recovery
   setup wizard, health card, sync jobs ─────▶  store registration, sync progress
 Magento REST API ◀──── OAuth 1.0a signed ────  live reads when a shopper asks,
                                                  approved order actions
 /conviro/webhook/receive ◀── signed ─────────  lead / contact / session events
 storefront widget (browser) ─────────────────▶ chat (cdn.conviro.io, api.conviro.io)

• Live, not copied: price, stock and order facts the assistant states are read from your store during the conversation, in the shopper's store view.
• Never in the way: checkout, registration and product saves only write a local queue row; delivery happens in the background.
• Minimal data: orders and customers are kept without names, addresses or phone numbers, e-mails only as a keyed one-way hash.

For merchants

For developers

Other references in the repository: undefined (../dev/README.md) (test stack), undefined (../Conviro/AiChat/README.md) (module README), apps/api/src/modules/magento/SLO.md, apps/api/src/modules/magento/COMPOSER-REGISTRY.md.

Plan §20 coverage

Plan §20 also asks that every troubleshooting error shown to a merchant links to its docs anchor. The module's messages do not link to any documentation yet; troubleshooting.md provides stable #symptom-… anchors for that change.

Support: [email protected] · Dashboard: https://app.conviro.io