Quickstart
Build your first agent and have it answering in a few minutes — no code required to start. You'll create a bot, optionally give it knowledge and tools, test it in the built-in chat, then deploy it on your site or over the phone.
Create your workspace
Sign up at the console and verify your email from the link we send. Your first workspace is created automatically on the Free plan — it's the container that holds your bots, knowledge, team, and billing. You can rename it later under Workspace settings.
Create your first agent
From the dashboard, click New bot. You can build it three ways:
- Guided wizard — name the bot, pick a type, and fill in the prompt and settings step by step.
- AI-assist — describe what the bot should do (and optionally point it at your website or notes) and Hania drafts the system prompt and suggests tools for you.
- Blueprint — start from a pre-built template and customize it.
Choose the channel that fits your use case:
- Chat agent — text conversations for your website, app, or Slack.
- Voice agent — real-time phone and in-app voice.
- Scheduled agent — runs on a schedule (or on demand) to do work and report back.
Give it knowledge (optional)
Open Knowledge and add a source so your agent can answer from your own content:
- Text — paste content directly.
- URL — point Hania at a page to fetch and index.
- File — upload a document.
Hania chunks, embeds, and indexes each source automatically. Once processing completes, assign the source to your bot and it will retrieve relevant passages during conversations.
Connect tools (optional)
Tools let your agent take action — look something up, create a record, or call your own API. Under Tools you can add a tool three ways: configure one manually, start from a preset, or use AI discovery to read your API docs and set it up for you. Then assign the tool to your bot, and it will call it when the conversation calls for it.
Test it
Open your bot and use the built-in test chat to talk to it exactly as a user would. You'll see its replies stream in, watch any tool calls execute, and can inspect the full trace of a conversation to understand how it reasoned. Iterate on the prompt, knowledge, and tools until it behaves the way you want.
Deploy
When you're happy with it, put it in front of users:
- Chat widget — open Widgets, customize the look and greeting, and copy the embed snippet onto your site. Edits in the dashboard sync to the live widget.
- Voice — map a phone number to the bot so callers reach it directly (voice number setup is managed by a workspace admin).
Go programmatic (optional)
Everything you do in the dashboard is also available over the HTTP API. Create a key under Settings → API keys, granting it only the abilities it needs (for example, read-only access to bots). The plaintext key is shown once at creation — store it in a server-side secret, never in a browser.