Create Chat Agent

Set up an AI chat agent for your website

Create Chat Agent

Chat agents handle text-based conversations on your website via the embeddable widget or the API.

Step 1: Create the agent

1. Go to Agents → Create Agent
2. Set Agent Mode to Chat or Both
3. Write your system prompt
4. Select an LLM model
5. Save

Step 2: Configure chat settings

Navigate to the Chat settings tab on your agent:

Chat Settings

Setting	Description	Default
Welcome Message	First message shown when chat opens	—
Input Placeholder	Placeholder text in the input field	”Type a message…”
Response Delay	Artificial delay before responding	500ms
Typing Indicator	Show animated dots while agent thinks	Enabled
Auto-Close Message	Message shown when chat closes from inactivity	—
Inactivity Timeout	Close chat after this period of silence	60 min

Widget Appearance

Setting	Description	Default
Position	Bottom-right or bottom-left	Bottom-right
Primary Color	Button and header color	#0066FF
Header Text	Title in the chat window header	”Chat with us”
Avatar URL	Image shown in the header	—
Button Size	Floating button diameter	60px
Window Size	Chat window width and height	380 x 600
Powered By	Show “Powered by Aimna” badge	Enabled

Step 3: Enable the widget

Toggle Chat Widget to enabled. This activates the public widget endpoints for your agent.

Step 4: Get the embed code

1. Expand the Embed Code section (appears after enabling the widget)
2. Choose Chat Widget or Callback Widget
3. Copy the script snippet
4. Paste on your website before </body>

See Website Widget for full embedding instructions.

Step 5: Add a knowledge base (optional)

Give your agent access to your documentation, FAQs, or product information:

1. Go to the Knowledge Base tab
2. Click Add Source
3. Upload files (PDF, DOCX, TXT) or enter a website URL
4. The content is automatically chunked, embedded, and stored for retrieval

Your agent will search the knowledge base for relevant context before responding to each message.