Skip to main content
You’ll meet these words all over the product. Learn them once and the rest of the docs click into place.

​
Workspace

A workspace is your company’s space in Keloa — one per business. It holds every conversation, every contact, every AI agent and every knowledge source. Everything is scoped to the workspace; teammates you invite see only this workspace’s data. You can belong to multiple workspaces (for example an agency with several clients) and switch between them from the workspace menu in the sidebar.

​
Contact

A contact is a person who has messaged you — identified by their email, phone number, or webchat session. Contacts are merged when we can confidently tell it’s the same person (same email across channels, for example). Contacts can optionally belong to a Company. See Contacts.

​
Conversation

A conversation is a thread with one contact on one channel. It has a status (open, pending, resolved), optional tags, an assignee, and a list of messages. Inbound messages from any channel land as a conversation in your Inbox.

​
Channel

A channel is an inbound conversation surface — a place where customers message you. The web widget, email, WhatsApp, Instagram, Messenger, Telegram and Slack are all live channels; Shopify storefront chat is on the roadmap. Each connected channel shows a status on its card and is answered by an AI agent. Your plan’s Channels cap counts web widget and email inboxes. WhatsApp numbers and Telegram bots have their own per-plan limits, Messenger and Instagram are included from Growth, and a Slack workspace uses one integration slot. See Channels.

​
Integration

An integration is a connected third-party app — Shopify, a custom HTTP endpoint or Google Drive — that feeds data into Keloa or lets your AI agent run actions (look up an order, sync a knowledge folder). Integrations are not channels: a channel carries customer conversations, an integration carries data and actions. They are two separate plan caps, so connecting Shopify as an integration never uses up a channel slot. Slack is the exception: it’s a channel, but each connected Slack workspace uses one slot of the integrations pool. Shopify can appear in both pools — as an integration (orders, products, knowledge sync) and, once live, as a storefront-chat channel. See Integrations and Shopify.

​
AI agent

An AI agent is the personality and brain behind automated replies. Each agent has:
  • a name and greeting
  • a system prompt that shapes voice, scope, and rules
  • a set of knowledge sources it can draw from
  • tools it’s allowed to use (e.g. look up a Shopify order, hand off to a human)
You can have several agents — e.g. one for pre-sales, one for order support — and attach different agents to different channels or flows. See AI agents.

​
Knowledge

Knowledge is the content your AI is allowed to answer from. Four kinds of sources:
  1. Website crawl — paste a URL, we crawl and index it
  2. File upload — PDFs, DOCX, TXT, Markdown
  3. Text snippet — paste any plain text
  4. Q&A pairs — write canonical question/answer rows
Every source belongs to a specific agent, so you can scope what each agent knows. No knowledge = generic answers; good knowledge = accurate, cited answers. See Knowledge.

​
Flow

A flow is a visual automation — a graph of nodes that runs when something happens. Triggers (message received, conversation opened, …), Conditions (if tag is “VIP”), Messages (auto-reply), Actions (tag, set priority), Handoff (route to a teammate), Resolve (mark solved, ask for CSAT). Use flows to route, tag, escalate, or auto-reply with deterministic logic on top of your AI agent. See Flows.

​
Macro

A macro is a saved reply. Type / in the inbox composer to insert one. Great for the 10 replies you send every day. See Macros.

​
Assignment rule

An assignment rule decides which teammate a new conversation goes to, based on channel, tag, language or intent. Rules run top-down — the first match wins. See Assignment rules.

​
Credits

An AI credit is roughly one round-trip with the AI (one message in, one reply out). Each plan includes a monthly allowance; overages roll over or can be topped up. See Usage & credits.

​
How they fit together

A visitor sends a message on a channel. It becomes a conversation in your inbox. An AI agent replies, pulling answers from its knowledge. A flow may tag it, escalate it, or hand it off. A teammate resolves it. That’s Keloa.