AI Assistants
Create and manage the AI assistants that answer customers on chat, SMS, email and voice. Set their personality, channels, playbook and who they hand chats to.
An assistant is an AI team member that talks to your customers. You can have as many as you need, for example a Support assistant, a Sales assistant and a Front-desk assistant, each with its own personality, knowledge and channels.
Find them under AI Assistant → Assistants in the left sidebar.
The Assistants page
Each assistant appears as a card showing:
- Its name (your Internal Name if you set one, with the Public name underneath).
- Badges for the channels it is the default for: Default, Email, SMS, Chat & DMs, Voice.
- Its Workspace, its linked Playbook, and, if warm transfer is on, a Transfers to: line.
- Buttons: Rules, Edit, Clone and Delete.
Use the Search assistants... box to find one. The star at the top-right of a card (Set as default) makes it your overall default assistant. The Routing Rules button at the top opens Routing & Handoffs.
Only assistants in your current workspace are shown. Switch workspace from the sidebar to see the others.
Create an assistant
Click Create Assistant
On the Assistants page, click Create Assistant. Tick the channels you plan to use (Email, Chat, Voice, and SMS if your plan has it).
Choose how to set it up
- AI-assisted setup: answer a few questions and the AI drafts the instructions for you.
- Quick setup: pick a goal (Sales / Lead qualification, Customer support, Scheduling or Other), add a short goal description and tone, and create it.
- Full manual setup: fill in every setting yourself, using the steps below.
You can also start from a ready-made template.
Work through the setup steps
When creating a full assistant you may see a step bar at the top. The steps are 1. Basics, 2. Channels & Routing, 3. Knowledge, 4. Behavior and 5. Review. You can click any step to jump to it.
Save
Click Create Assistant. If something needs fixing, the message appears inside the pop-up, so you won't lose your work.
Basics
| Field | What it's for |
|---|---|
| Name (required) | The name customers see. It is also used in email signatures. |
| Internal Name (recommended) | A name only your team sees, to tell assistants apart. If you leave it blank, the Name is used. |
| Workspace | Which workspace the assistant belongs to. Used for routing defaults and branding. |
| Description | A short note about what this assistant is for. |
| Playbook (recommended) | Optional on create. Pick the playbook this assistant should follow. You can change it later. Only admins can change it. |
Behavior
- Tone: Friendly, Professional, Concise, Empathetic, Upbeat, Casual, Salesy, or Other (describe it in up to 120 characters).
- Role: Not set, Sales, Support or Hybrid. This shapes the assistant's goals and when it offers a handoff.
- Playbook: the single playbook this assistant follows on every channel. See AI Playbooks.
- Primary KPIs, Required Fields to Capture and Escalation Triggers: one item per line, for example "name", "email", "User asks for a human".
- Next Step Guidance: what the assistant should offer at the end, for example "Offer to book a demo or send a quote."
- Offer Handoff After (attempts): how many tries before the assistant offers a person.
- System Prompt (required): the main instructions that define who the assistant is and how it behaves.
- Greeting Message: the first thing it says, for example "Hello! How can I help you today?"
- Email Signature (Optional): text added after the assistant's name in emails.
Keep the System Prompt about behavior ("You are a friendly, concise support agent for Acme..."). Put facts about your business in Training Context instead.
Channels & Routing
- Provider and Model: the AI engine behind the assistant. Most businesses leave the defaults. You only see Provider choices if your account uses its own AI keys.
- Voice: the voice used on phone calls.
- Routing default (fallback for all channels) plus Default for Email, Default for SMS, Default for Chat & DMs and Default for Voice. A channel-specific default wins over the overall default.
- Training mode (web chat): lets testers type /clear, /flag-good and /flag-bad in the chat widget. Use it only on a test assistant.
- Use Shortlinks: turns links in messages into tracked short links. Handy for email and SMS.
If you give several assistants the same channel, use routing rules to decide which one answers.
Knowledge
Under Context Assignments, Include all context (the default) lets the assistant use everything in your Training Context: documents, products, website content and instructions. Untick it to pick specific items.
Advanced Options
Click Advanced Options to expand:
- OpenAI Temperature (0 to 2, default 0.7): lower is more consistent, higher is more varied.
- Max Tokens (default 2000): caps how long replies can be. Keep it lower for chat and SMS.
- Topic Boundaries: topics to stay within, one per line.
- Do Not Instructions: things it must never do or say.
- Query Result Limits (Per-Agent Override): optional caps on how much material this assistant pulls in per question: Max Products Per Query, Max Documents Per Query, Max Website Pages Per Query, Max Product Description Length, Max Document Preview Length and Max Website Preview Length. Leave them empty to use your plan's defaults.
Link a playbook
An assistant follows one playbook at a time.
- Open the assistant with Edit.
- In Behavior, choose a playbook in the Playbook list (or No playbook).
- Save.
You can also assign a playbook from the AI Playbooks page, which shows which assistants use each one.
Playbook linking is admin-only. If you are not an admin you will see the playbook name with "Ask an admin to change this."
Hand chats to a colleague (warm transfer)
On website chat, an assistant can pass a visitor to a better-suited assistant. The visitor sees "Connecting you with name…" and the next assistant gets a short summary of the conversation.
Open the assistant
Click Edit on the card (warm transfer is shown when editing an existing assistant).
Turn it on
In Behavior, switch on Warm transfer (website chat).
Pick colleagues
Under Can transfer to, tick up to 10 other assistants in the same workspace. Paused assistants are not listed. Give each colleague a clear description so the AI picks the right one.
Check handoffs are on
Transfers only work if handoffs are on for your business. If they're off, the editor shows a warning with a link to Routing & Handoffs → Handoff Settings.
See Warm transfer between assistants for more.
Clone an assistant
Click Clone
On the assistant's card, click Clone.
Name it and pick a workspace
Enter a New name and choose a Target workspace.
Decide about the playbook
Tick Also clone linked playbook to make a separate copy (give it a New playbook name). If you leave it unticked, the copy keeps using the same playbook.
Confirm
Click Clone.
Default settings are not copied. Set the new assistant's channel defaults yourself.
Delete an assistant
Click Delete on the card, then Delete assistant to confirm. This cannot be undone.
- Its routing rules, instructions and email assignments are deleted with it.
- If it was a channel's default, choose another default afterwards.
- Past conversations are kept, but no longer show which assistant handled them.
Test before you go live
- Use the Widget Playground (sidebar → Conversations → Widget Playground) to chat with your assistant as a customer would. See Widget Playground.
- In the editor, Test prompt, Test Email and Test SMS let you try a message, and Run test scenarios checks the assistant against realistic requests.
- Quality Check (on the Review step) checks your instructions and lists issues with suggested fixes.