Key Concepts
Understanding these core concepts will help you get the most out of Mesachat.
Tenants
A tenant is the top-level organizational unit in Mesachat. Everything — bots, integrations, API keys, configurations — is scoped to a tenant.
- Personal tenants map 1:1 to a user account
- Organization tenants are shared workspaces where all members benefit from configurations
- When an admin connects an integration (e.g., Snowflake) to an org tenant, all members can use it
All app functionality is tenant-scoped, not user-scoped. This is a fundamental architectural principle.
Bots
A bot is a configured AI assistant within a tenant. Each bot has:
- LLM settings — Provider, model, temperature, max tokens
- Integrations — Connected communication channels
- Capabilities — What the bot can do (search, analyze, generate images, etc.)
A tenant can have multiple bots configured for different purposes.
Agents
Agents are specialized AI modules that handle specific types of requests. When a message arrives, the agent router determines which agent is best suited to respond.
Examples of agents:
- Web Search Agent — Searches the web and summarizes results
- Image Agent — Generates images from descriptions
- Code Agent — Writes and explains code
- Orchestrated Agent — Handles complex multi-step tasks
Channels
A channel represents a connection between a bot and a communication platform. Supported channels include:
| Channel | Description |
|---|---|
| Telegram | Bot API integration with webhook support |
| Inbound/outbound email processing | |
| Web | Built-in web chat interface |
API Keys
API keys provide access to external AI providers (OpenAI, Anthropic, Google). Mesachat supports:
- Global keys — Platform-provided, shared across tenants
- BYOK (Bring Your Own Key) — User-provided keys for their own accounts
- Scoped resolution — Keys resolve in order: Bot → Bot Group → Tenant → Global