Architecture
Understanding the hierarchy of Users, Agencies, and Business Workspaces.
Iqra AI follows a hierarchical structure designed to support individual developers, agencies, and large enterprises simultaneously.
The platform is divided into two distinct layers:
- The Management Layer: Handles Billing, Tenancy, and Whitelabeling (Cloud Only).
- The Operational Layer: Handles the actual AI Agents, Logic, and Routing (Open Source Core).
Ecosystem Map
This diagram illustrates how the Agency Owner controls the platform and how Customers access their assigned workspaces.
1. The Master User
The Administrator Level
When you sign up for Iqra AI, you create a User account. This is the top-level entity responsible for the "financial" and "administrative" health of the account.
Business Management
Create, delete, and manage multiple Workspaces. Each business is an isolated container for your agents and data.
Billing & Usage
(Cloud Only) Manage your credit balance, payment methods, and view aggregated usage costs across all your businesses.
Whitelabeling
(Cloud Only) The Agency Engine. Configure custom domains, branding, subscription plans, and manage your own customers.
2. The Business (Workspace)
The Operational Level
A Business is where the work happens. It is a strictly isolated container for your AI logic. An Agent in Workspace A cannot access a Phone Number or Knowledge Base in Workspace B.
Agents
The Persona. Define the voice, personality, interruption handling, and language settings.
Scripts & Logic
The Brain. Use the Visual Builder to create conversation flows, Action Flows, and manage Script Variables.
Routing & Campaigns
The Connection. Connect Agents to the world via Telephony (Inbound/Outbound) or Web (Real-time Socket).
Tools & FlowApps
The Capabilities. Connect your agent to external systems (CRMs, Calendars) using our plugin system.
Data & Knowledge
The Memory. Manage RAG Knowledge Bases, Semantic Caching, and Business Context.
3. The Agency Model (Whitelabeling) (Cloud Only Feature)
For Agencies, the hierarchy extends one step further. You act as the Platform Owner.
- You (The Agency): Own the Iqra account, pay for usage, and set the pricing plans.
- Your Customer: Logs into your domain (e.g.,
app.agency.com). They only see the Business Workspace you have assigned to them. - Plan (Limits): You can define a subscription plan for your customer to limit their use of features.
- Permissions: You can restrict what the customer sees (e.g., allow them to view Conversations but not edit Scripts).
Learn More
Deep dive into the Agency features in the Whitelabeling Guide.