Get started

Core concepts

A quick tour of the building blocks you'll work with. Everything in Hania hangs off a workspace and centers on bots — the agents that talk to your users.

Workspace

The workspace is your top-level container. It holds your bots, knowledge, tools, team members, and billing, and keeps everything isolated from other workspaces. You can rename it and manage members from Workspace settings.

Bot

A bot is a configured agent: a system prompt, a model, optional knowledge and tools, and channel settings. There are two kinds:

Chatbot — conversational, responding to messages in real time (web chat, voice, SMS, WhatsApp, or the API).
Agent — goal-driven; it can run on a schedule or on demand to do work and report back.

See Create a bot to build one, and the Bots API to manage them programmatically.

Conversation

A conversation is a session between an end user and a bot. It's a sequence of messages and can be text or voice. Each conversation carries an execution trace — the model turns and tool calls behind the replies — which you can inspect to understand and debug behavior.

Knowledge

Knowledge is source material your bot can search to ground its answers (retrieval-augmented generation). Add text, a URL, or upload files; Hania chunks, embeds, and indexes them automatically. See Knowledge.

Tool

A tool is a function the bot can call to take action — a built-in capability, a preset, or your own API. The agent decides when to call a tool based on the conversation. See Tools.

Memory

Memory is the set of long-term facts an agent forms about the people it talks to, carried across conversations. Memories are typed and scored, and you can review, correct, or delete them. See Memories.

The widget is the embeddable chat experience for a bot — a script you drop on your site, with its own customization and a public, domain-restricted key. See Widgets.

Channels

A conversation happens on a channel. Hania supports web (the widget/test chat), voice (phone and in-app), sms, whatsapp, and api (your backend via the Chat API), plus agent runs and post_call follow-ups. You can filter conversations by channel.