Introduction
Welcome to the Octocom documentation. Octocom is an AI-powered customer support platform for ecommerce — this guide explains what it does, how it's organized, and where to start.
Octocom is an AI customer support platform built for ecommerce. It deploys autonomous AI agents that handle real customer conversations end-to-end — answering product questions, tracking orders, processing returns, recommending products, and escalating to humans when needed — across web chat, email, social media, and contact forms.
This documentation covers everything from installing the chat widget to writing custom Python actions and integrating Octocom with your own systems via MCP.
What you can do with Octocom
- Deploy a 24/7 AI agent that handles the long tail of repetitive customer questions without involving your team.
- Sell more. The same agent acts as a shopping consultant — answering questions about your catalog, recommending products, and recovering checkout abandonment.
- Connect to your stack. Native integrations for Shopify, WooCommerce, BigCommerce, Magento, plus a flexible Python action layer for everything else.
- Run your help desk in Octocom, or keep your existing one (Zendesk, Gorgias, Front, and others) — the AI works either way.
- Automate review responses for Trustpilot, Okendo, and Google reviews.
- Manage Octocom programmatically through MCP — point Claude or any MCP-compatible agent at Octocom and have it configure, debug, and test the bot on your behalf.
How the docs are organized
| Section | What it covers |
|---|---|
| Octocom MCP | Connect your AI agent (Claude, Claude Code, any MCP client) to Octocom to configure, debug, and test your bot through natural-language instructions. |
| Help Desk | Day-to-day work in Octocom's built-in help desk — managing conversations, views, macros, notes, tags, and sidebar widgets. Also covers using Octocom alongside third-party help desks. |
| AI Knowledge & Logic | The core of how the bot thinks: workflows, custom actions, condition providers, event handlers, Python helpers, A/B testing, and analytics. |
| Shopping Consultant | Wiring up product data, attribution tracking via GA4, and recording browser-session purchases. |
| Contact Form | Embedding an Octocom-backed contact form on your site. |
| Web Chat | Installing, controlling, and customizing the chat widget on your site. |
| Shopify / WooCommerce / BigCommerce / Magento | Platform-specific installation and setup guides. |
| Social Media Integrations | Connecting Meta (Instagram, Facebook) and configuring comment workflows. |
| Security | AI reliability, jailbreak prevention, customer authentication, compliance, and the AI deployment checklist. |
Where to start
Pick the path that matches what you're trying to do:
- I'm setting up Octocom for the first time on a supported platform. Go straight to the relevant platform guide: Shopify, WooCommerce, BigCommerce, or Magento.
- I'm setting up Octocom on a custom or in-house platform. Start with Product Data and Order Tracking to wire up your catalog and order data, then install the chat widget.
- I want the bot to do something specific — answer a workflow-style question, take an action, decide when a rule applies. Read Workflows and Custom Actions.
- I want to manage Octocom through Claude or another AI agent. Set up Octocom MCP and let your agent do the work.
- I'm a human agent using Octocom's help desk day-to-day. Read Managing Conversations.
- I'm preparing for production launch. Work through the AI Deployment Checklist.
Need help?
If anything is unclear, missing, or out of date, reach out — we're happy to help and we use your questions to improve the docs.