Documentation

How Teboa Works

Everything you need to understand the Teboa platform. From the product vision and AI agents to the technical architecture and how to get started with your Shopify store.

Version 1.0. MVP Last Updated: May 2026 TeboaTech (Pty) Ltd

What is Teboa?

Teboa is an AI-powered eCommerce operating system built specifically for Shopify store owners. Most stores run on five or six separate tools that do not talk to each other. Teboa replaces all of them. One platform. Four AI agents. Everything connected.

At its core, Teboa gives you four specialist AI agents, a unified dashboard, and a set of automation tools that handle the operational work while you focus on the business decisions that actually move the needle.

Teboa is built by TeboaTech (Pty) Ltd, a South African technology company. Registration No: 2025/516299/07. The platform is currently in active MVP development with early users onboarding now.

The name Teboa comes from the Sesotho word meaning "to grow." That is the entire mission in one word. Every decision we make, every feature we build, and every agent we train is in service of one outcome: your store grows.

Value Proposition

Most Shopify store owners are spending hours every day on work that does not grow their business. Checking dashboards. Switching between tools. Responding to support tickets one by one. Trying to remember which automation is live and which broke last week. That time has a cost.

The Problem Teboa Solves

  • Store owners use 5 to 8 separate tools that do not connect or share data cleanly
  • Automation setup requires technical knowledge most store owners do not have
  • Customer support is handled reactively and inconsistently
  • Performance data exists but is hard to turn into clear decisions
  • Growth goals are set but rarely tracked with meaningful structure

What Teboa Delivers

  • One dashboard that shows everything happening in your store
  • Four AI agents that each own a specific operational area
  • Automated workflows that run without manual input once set up
  • A support inbox where AI drafts replies before you even read the ticket
  • OKR and KPI tracking so goals stay visible and progress is measurable

The Core Promise

Every serious Shopify store owner deserves the same operational leverage that big retailers have. A team that watches your numbers. Automations that run while you sleep. Support that never falls behind. Teboa gives you all of that without the headcount.

Who Teboa Is For

Teboa was built for a specific type of operator. If any of these sound like you, you are in the right place:

  • Independent Shopify store owners running their store solo or with a small team
  • Small eCommerce businesses that have outgrown spreadsheets but cannot afford enterprise tools
  • Growing brands that need automation and structure without hiring additional operations staff
  • Entrepreneurs launching a Shopify store who want to start with the right infrastructure from day one

Teboa is a Shopify-native product. If your store runs on a different platform, it is not the right fit today. If you have a full operations team of 20 people, you probably do not need it either. But if you are building something real and want to run it smarter, Teboa was built for you.

The Four AI Agents

Each AI agent in Teboa owns a specific domain of your store operations. They run continuously, surface insights, and take or draft actions on your behalf. All agents are powered by Claude AI from Anthropic.

Amy

Store Manager

Amy monitors your store's day-to-day operations. She tracks revenue, order volume, fulfilment status, and conversion rates. She surfaces revenue leaks, flags underperforming products, and gives you a daily summary of what needs your attention. Think of Amy as your operations manager. always watching, always ready to brief you.

Sino

Automations

Sino builds and manages your automation workflows. He sets up abandoned cart recovery sequences, order confirmation emails, win-back campaigns, and custom trigger-based flows. Once configured, Sino's automations run without intervention. He also monitors automation performance and recommends improvements based on your store's data.

Sessy

Support Agent

Sessy manages your customer support inbox. She reads incoming tickets, categorises them, drafts a reply for each one, and presents them to you for approval before sending. She handles refund queries, order status questions, product questions, and escalation routing. dramatically reducing the time you spend on support while improving response quality.

JJ

Growth Agent

JJ tracks your business goals, OKRs, and KPIs. He monitors progress against targets, identifies which metrics are off track, and tells you what to prioritise each week. JJ turns your growth strategy from a document you wrote once into a live, active system that guides daily decisions. He is the agent that keeps your ambition accountable.

How AI Agents Work

Each agent operates within your isolated workspace. They process data from your connected Shopify store, your automation rules, your support inbox, and your defined OKRs. Agent responses are generated via the Claude AI API and are contextualised to your specific store data. not generic advice.

You interact with agents through the platform's chat interface. Each agent maintains context about your store across conversations, so you do not need to re-explain your situation each time. You can also ask Amy, Sino, Sessy, or JJ questions at any time through the "Ask AI" button in your dashboard.

Dashboard

The Teboa dashboard is your central command centre. It is the first screen you see when you log in, and it is designed to give you a complete picture of your store's health in under 60 seconds.

What the Dashboard Shows

  • Revenue (MTD). Month-to-date revenue with comparison to the previous period
  • Total Orders. Order count with fulfilment status breakdown
  • Conversion Rate. Store conversion rate versus your target
  • Average Order Value. AOV tracking with trend direction
  • Revenue Overview Chart. 6-month bar chart showing revenue trends
  • OKR Progress. Live progress bars for your active quarterly goals
  • Recent Orders. Latest order feed with status and amount
  • Automation Status. Live status of your active automation workflows

The dashboard updates in real time as your store data syncs from Shopify. No manual refreshing or data imports needed.

Automations

Teboa's automation engine lets you build trigger-based workflows that run automatically when specific events happen in your store. No coding required.

Automation Types

  • Abandoned Cart Recovery. Automatically sends a recovery email sequence when a customer adds to cart but does not complete purchase
  • Order Confirmation. Sends a branded order confirmation with relevant upsell or cross-sell content
  • Win-Back Campaigns. Re-engages customers who have not purchased in a defined number of days
  • Custom Triggers. Build your own workflow based on order events, customer tags, product purchases, and more

How Automations Are Built

Sino, your Automations agent, walks you through setting up each workflow inside the platform. You define the trigger condition, the action to take, and any delay or condition rules. Sino handles the configuration and monitors performance once the automation is live.

All automations are visible from the Automation Status widget on your dashboard, showing which are live, how many times they have triggered, and whether any have errors.

Support Inbox

The support inbox consolidates all incoming customer messages into one interface. Every ticket is read by Sessy, your Support agent, who drafts a reply and presents it to you for review before anything is sent.

Inbox Features

  • Unified inbox for all customer support messages
  • AI-drafted replies for every ticket. you review, edit if needed, and approve
  • Ticket categorisation. orders, refunds, products, general enquiries
  • Escalation routing for complex or high-value cases
  • Response time tracking

The inbox is designed so that you can process your entire support queue in minutes rather than hours. Sessy does the reading, categorising, and drafting. You stay in control of what goes out.

OKR and Growth Tracking

Teboa includes a built-in OKR (Objectives and Key Results) framework managed by JJ, your Growth agent. You define your quarterly objectives and the measurable key results that indicate progress.

How It Works

  • Set quarterly objectives (e.g. "Grow Monthly Revenue to R100,000")
  • Define up to 3 key results per objective with numerical targets
  • JJ monitors your store metrics and maps them against your key results automatically
  • Progress bars update in real time on your dashboard
  • JJ surfaces a weekly priority. the one thing most likely to move your most lagging metric

How It Works. Getting Started

Getting started with Teboa takes less than 10 minutes. Here is the full process from signup to a running store.

01

Create Your Account

Sign up at app.teboatech.com. Your secure workspace is created instantly. No setup calls or IT required.

02

Connect Your Store

Connect your Shopify store via OAuth in one click. Orders, products, customers, and metrics sync automatically.

03

Meet Your AI Team

Amy, Sino, Sessy, and JJ introduce themselves and walk you through setting up your first automations and OKRs.

04

Run Your Store

Your dashboard is live. Automations are running. Support inbox is active. You focus on growth.

Shopify Integration

Teboa connects to your Shopify store via Shopify's official OAuth 2.0 integration. This is a read-and-write API integration that gives Teboa access to your store data within the permissions you grant during the connection flow.

What Data Syncs

  • Orders. IDs, amounts, statuses, customer details, fulfilment information
  • Products. names, SKUs, inventory levels, pricing, collections
  • Customers. names, email addresses, order history, tags
  • Analytics. revenue, conversion rate, sessions, AOV
  • Abandoned checkouts. for automation trigger purposes

Permissions Required

During the Shopify OAuth flow, Teboa requests the following permission scopes:

  • read_orders. to display and analyse your orders
  • read_products. to display and analyse your products
  • read_customers. to display customer data in the inbox
  • read_analytics. to power the dashboard metrics
  • write_script_tags. to enable automation triggers on your storefront

You can revoke Teboa's access to your store at any time from your Shopify admin under Apps. Revoking access will immediately stop all syncing and automations.

Tech Stack

Teboa is built on a modern cloud-native stack designed to scale with your business. Every component is chosen for reliability, performance, and developer velocity.

Frontend

Next.js

React framework for the web application. Server-side rendering for performance and SEO. Hosted on Vercel's edge network.

Hosting

Vercel

Global edge deployment. Automatic scaling. Zero-downtime deploys. Marketing site and app both hosted on Vercel.

Database

Firebase

Firestore for real-time database. Firebase Auth for user authentication. Firebase Storage for file assets. Google Cloud infrastructure.

AI

Claude AI by Anthropic

Powers all four AI agents. Claude processes store data, generates insights, drafts support replies, and runs the conversational interfaces.

Integration

Shopify API

Official Shopify Partner integration via OAuth 2.0. REST and GraphQL APIs used for store data sync and automation triggers.

Payments

Billing Provider

Subscription billing handled through a PCI-compliant provider. Card details are never stored on Teboa infrastructure.

Architecture Overview

Teboa follows a multi-tenant SaaS architecture where each business account operates in complete isolation. No business can access or see the data of any other business on the platform.

Workspace Isolation

When you create a Teboa account, a dedicated workspace document is created in Firestore under a unique workspace ID. All your data. store metrics, orders, automations, conversations with AI agents, OKRs. lives under this workspace and is accessible only to users you have granted access to.

Data Flow

  • Shopify to Teboa. Store data is synced via webhook listeners and scheduled API pulls. Data is normalised and written to your Firestore workspace.
  • User to AI Agent. When you send a message to an agent, the query plus relevant store context is sent to the Claude API. The response is streamed back to your interface.
  • Automation Triggers. Trigger conditions are evaluated against incoming Shopify webhook events. When a condition is met, the automation action is executed.
  • Dashboard. Dashboard metrics are computed from your workspace data and served in real time to the Next.js frontend via Firestore listeners.

AI Context Management

Each AI agent keeps a live context window built from your store data. Recent metrics, active automations, open support tickets, and your defined OKRs are all passed with every query. The result is answers that are specific to your store, not generic advice you could get from Google.

Your context is scoped entirely to your workspace. It is never shared with other users and is never used to train AI models.

Security and Data

Data Encryption

  • All data in transit is encrypted via TLS 1.2 or higher
  • All data at rest is encrypted by Firebase's default AES-256 encryption
  • Authentication tokens are short-lived and refreshed automatically

Access Controls

  • Firestore security rules enforce workspace-level access controls
  • No cross-workspace data access is possible at the database layer
  • TeboaTech staff access to production data is role-gated and audited

Compliance

  • POPIA compliant (Protection of Personal Information Act, South Africa)
  • GDPR-ready (General Data Protection Regulation, EU)
  • CIPC registered. TeboaTech (Pty) Ltd, Reg No: 2025/516299/07

For full details, see our Privacy Policy and POPIA Compliance GDPR Compliance pages.

Pricing

Teboa offers four subscription plans. All plans include a 14-day free trial on the Founders Plan. No credit card required to start.

Starter

$19 /month

Up to 500 orders/month. Amy and Sino. Basic automations. Email support.

Growth

$49 /month

Up to 2,000 orders/month. All 4 agents. Full automation suite. Priority support.

Scale

$99 /month

Unlimited orders. All 4 agents. Custom automations. Shopify OAuth. Dedicated support.

Founders Plan

$5 /month

Lifetime price. All Growth features. First 10 customers only. Never increases.

View full plan details at teboatech.com/pricing.

Roadmap

Teboa is in active MVP development. The following features are currently live, in development, or planned:

Currently Live (MVP)

  • Dashboard with real-time store metrics
  • Four AI agents with chat interface
  • OKR and KPI tracking
  • Automation workflow builder
  • Support inbox with AI-drafted replies
  • User authentication and workspace management

In Development

  • Full Shopify OAuth store connection
  • Live data sync from Shopify stores
  • Automation email sending engine
  • Mobile-optimised dashboard view

Planned

  • Multi-store support
  • Advanced analytics and custom reporting
  • Team collaboration features
  • API access for custom integrations
  • WhatsApp support channel integration

Founders Plan members get every new feature before anyone else and have a direct line to the founding team on what we build next. Ten spots. Five dollars a month. That price never changes.