Skip to main content
Who can use this?
  • Gallabox users with AI Agent creation permissions.
  • Roles: Owners and Admins (and roles with AI agent permissions)
  • Plans: Available on all plans. Basic plan supports Chat AI Agents on Web Chat only. WhatsApp and Instagram AI agents require Essential or Advanced.

​
Plan Availability

​
What is a Chat AI Agent?

A Chat AI Agent is an AI persona you create for your business. You give it a name, a set of instructions, and access to your knowledge base. It then talks to customers on its own — answering questions, qualifying leads, and escalating when it can’t help. Unlike bot flows (which follow a fixed decision tree) or AI Reply (which suggests drafts a human then sends), a Chat AI Agent:
  • Holds full conversational context across multiple turns
  • Decides when to escalate based on its own judgment
  • Works across WhatsApp, Instagram, and Web Chat simultaneously
  • Can route to specific team members or inboxes
A Chat AI Agent is not a chatbot with pre-scripted responses. It uses a Knowledge Base to answer questions accurately without you programming every possible question.

​
How a Chat AI Agent Works

​
Creating an agent

You create an agent with a 4-step wizard:
1
Go to AI Agents and Bots → Create New → Chat AI Agent.
2
Step 1 — Industry: Select your industry or type a custom one.
3
Step 2 — Use Case: Choose a use case (Lead Qualification, Sales, FAQ, etc.).
4
Step 3 — Channel: Select WhatsApp, Instagram, and/or Web Chat.
5
Step 4 — Business Details: Provide a website URL or short description for the agent to learn from.
The wizard then generates the agent’s role, goal, and instructions automatically.

​
Editing and refining your agent

After creation, open the agent to review and refine its setup manually:
1
Give the agent a name and a persona description.
2
Write its instructions — what it should do, how it should behave, when to escalate.
3
Connect a Knowledge Base — the source of truth it answers from.
4
Set the channel — WhatsApp, Instagram, Web Chat, or all three.
5
Save and activate.

​
Writing effective instructions

Instructions define the agent’s behavior. Be specific:
You can also include:
  • Tone and style guidelines (e.g., “Be friendly but professional”)
  • Topics to avoid or refuse
  • What to say during escalation
  • How to handle off-topic questions
Pro tip: Start with a narrow scope — a single agent doing one job well (e.g., answering pricing questions) is more effective than one agent handling everything. You can create multiple agents for different use cases.

​
Per-channel settings

For each channel the agent is connected to, you can set:
  • Greeting message — what it says when a customer starts a conversation
  • Channel-specific instructions — extra behavior rules for that channel
  • Availability hours — when the agent is active vs. offline

​
Choosing the AI model

In the agent’s Settings tab, the AI Model Settings section controls which model powers the agent:
  • Model — the language model the agent uses. The dropdown shows the models enabled for your account’s AI wallet — the catalog includes the GPT-4o/4.1/5 family, grok-4.3, Gemini 2.5 Pro/Flash, DeepSeek, Kimi, and Qwen models.
  • LLM Temperature — how creative the responses are, from 0 to 2 (default 0.1). Lower values give more consistent answers; higher values give more creative ones.
  • Thinking Level — None, Low, Medium, or High. Shown only for reasoning-capable models.
There are two provider versions:
  • v2 (recommended) — default model grok-4.3
  • v1 (legacy) — default model gpt-4o-mini
AI credit consumption varies by model — each model has its own per-token credit rates. Check your AI Wallet to see how the model you choose affects credit usage.

​
Example

Scenario: You run a clinic and want an agent that books appointments over WhatsApp. Create the agent, describe its persona as a friendly front-desk assistant, and write instructions to collect the patient’s name, preferred date, and reason for visit, then escalate to the reception team with @assignTo. Enable the WhatsApp channel, set a greeting, and activate. For a full Knowledge Base–driven walkthrough, see the Knowledge Base example.

​
Chat AI Agent vs. Bot Flow vs. AI Reply

​
Human Handoff

When the agent can’t answer or the customer asks for human help, it escalates. The handoff includes:
  • Full conversation history — all messages in the session
  • Customer details — name, email, phone (if captured)
  • Reason for escalation — the agent’s assessment of what the customer needs
  • Agent’s notes — any context gathered during the conversation
The conversation lands in the team inbox. An available agent picks it up and continues from where the AI left off.

​
FAQs

A bot flow follows a pre-scripted decision tree — you build every path the conversation can take. A Chat AI Agent uses a Knowledge Base to answer questions naturally, without you scripting every response. Bot flows are best for structured processes (e.g., appointment booking). Chat AI Agents are best for open-ended conversations (e.g., answering product questions).
Yes. When creating or editing an agent, you can enable multiple channels — WhatsApp, Instagram, Web Chat, or all three. You can also set channel-specific greeting messages and instructions for each channel.
Use the Agent Actions feature to restrict what the agent can do. You can also set explicit instructions to refuse sensitive topics. If the agent consistently gives wrong answers, review and update the Knowledge Base — the agent only knows what’s in the Knowledge Base. Test answers in the Test Widget before going live.
Yes — bot flows include a Knowledge Base node; see Bots for details.

​
In this section