Setting Up Your Agent

An agent is the thing that talks to your customers. It has an identity, a set of instructions per channel, knowledge to answer from, and a switch that decides whether it drafts replies for you or sends them itself. Setup lives at Agent → Agents.

Creating an agent#

Two ways in, both from Agent → Agents:

  1. 1Start from a template - Payment reminder, Appointment confirmation, Lead qualification, or Support follow-up. Each arrives as a complete brief you edit rather than a blank page.
  2. 2Or click Create agent for a blank one.
  3. 3Either way a chat opens: describe the agent in your own words ('chases overdue invoices for a Mumbai logistics firm, polite but firm, never threatens legal action') and it drafts the identity and the instruction document for you.
  4. 4Keep talking to refine it, then open the agent to review everything in the three setup steps below.

Deleting an agent keeps its history

Conversations and campaigns already tied to an agent stay in place when the agent is deleted. What goes away is the agent itself - its instructions, channel bindings and future replies.

1 · Identity#

Who the agent is and how it sounds. These feed every reply on every channel.

FieldWhat it controls
Business nameHow the agent refers to your company, and its display name in the app.
Business descriptionThe one-paragraph explanation of what you do. Used whenever the knowledge base has nothing relevant to a question.
ToneFormal (precise and professional), Casual (relaxed and conversational), or Friendly (warm and approachable, the default).
Sign-offHow written replies close. Ignored on voice, where nobody signs off.
IconThe badge that identifies this agent in the sidebar, inbox and agent list.

2 · Instructions#

This is the agent's brain, and it is written per channel, not once for everything. Voice, WhatsApp, Instagram, Email and Widget each get their own document, because the same instruction that works in an email is wrong out loud. Switch channels with the control above the editor.

Each document starts from a channel-shaped skeleton - WhatsApp's looks like this:

## Persona
-

## Environment & Situation
- Channel: WhatsApp chat. {{conversationType}} is inbound or outbound for this thread.

## Objective
-

## Writing Style
- Short chat bubbles. One idea per message. No sign-off.

## Facts
-

## Conversation Guidelines

### Phase 1:
-

## Guardrails
- 
SectionWhat belongs in it
PersonaWho the agent is: role, seniority, attitude.
Environment & SituationWhere this conversation is happening and what's usually known.
ObjectiveThe one outcome this conversation is trying to reach.
Writing / Speaking StyleMessage shape. Voice defaults to one or two spoken sentences per turn, one question then wait. Chat channels default to short bubbles with no sign-off.
FactsHard facts the agent may state without looking anything up.
Conversation GuidelinesThe phases: what to do first, then next.
GuardrailsWhat it must never do - the discount floor, the promise it can't make.

Greetings: inbound and outbound differ

Each channel has two opening lines. The outbound greeting is used when you reached them (a campaign call, a first-touch email). The inbound greeting when they reached you. Leave inbound empty and it falls back to the outbound one.

ChannelOutbound defaultInbound default
VoiceHi, am I speaking to {{userName}}?Hi, this is {{agentName}} from {{merchantName}} - how can I help you?
WhatsApp / InstagramHi {{userName}}, this is {{agentName}} from {{merchantName}}Hi {{userName}} - how can I help?
EmailHi {{userName}},Hi {{userName}}, thanks for reaching out -

Variables#

Anything in {{double braces}} is filled in at send time. Built-ins cover the conversation itself - {{userName}}, {{agentName}}, {{merchantName}}, {{conversationType}} (inbound or outbound), plus {{current_date}} and {{current_time}} in your timezone.

You can define your own too, each with a label and an example value, and fill them from a campaign CSV - {{invoiceNumber}}, {{dueAmount}}. A variable with no value at send time renders as (not provided) rather than being silently dropped, so a missing field is visible instead of producing a confident wrong sentence.

Inbound conversations rarely have campaign fields

The skeletons say so explicitly for a reason: a customer who messages you first has no CSV row. Write instructions that cope with a missing value instead of assuming one, and never tell the agent to invent it.

3 · Knowledge & rules#

  • Rules - short, absolute lines the agent follows on every channel ('never quote below the list price', 'always offer a callback before ending'). Keep them few and unambiguous. They carry more weight than prose.
  • Sample conversations - real exchanges showing how you'd handle a situation. Tone copies faster from examples than from adjectives.
  • Knowledge tables - which of the workspace's knowledge sources this agent may read. Attach only what's relevant. A support agent doesn't need the sales deck.

Knowledge itself (uploads, URLs to crawl, FAQs) is covered in the Knowledge Base page - this step is about which of it this particular agent uses.

Autopilot & channels#

The right-hand sidebar is the live control panel. The switch at the top is the master: turning it off pauses the agent and clears every channel auto-reply at once, so incoming messages stop getting automatic responses until you turn it back on.

Below it, each channel is a row: pick which workspace connection this agent uses, and whether it may auto-reply there.

ChannelWhat you bindNotes
EmailOne send mailbox - Gmail, Microsoft, or SMTPMutually exclusive: binding a second mailbox unbinds the first.
WhatsAppA connected WhatsApp Cloud numberOne number per agent.
InstagramA connected Instagram accountFree-form replies only inside Meta's window.
VoiceOne phone number from a connected carrierA carrier with several numbers routes each one separately.

Connections live at workspace level

You connect a mailbox, number or account once under Agent → Integrations, then assign it to an agent here. A connection already bound to another agent won't appear in this list.

Voice has one extra setting: action mode. In draft mode the actions a call produces (an email with details, a callback invite) wait in the inbox for approval. In auto they go out during the call.

Auto-send confidence#

Every drafted reply gets a confidence score. Above the threshold it sends by itself. Below it, it waits in the inbox as a draft. The slider defaults to 90%.

  • Auto-send needs both: the score must clear the threshold AND that channel's auto-reply toggle must be on.
  • 70% is the floor. Dragging below it asks you to confirm, because that's where replies the agent isn't sure about start going out unreviewed.
  • The threshold is per agent, so a support agent can be looser than one that quotes prices.
  • The slider is disabled while the agent is paused.

Follow-ups#

Each agent decides when silence deserves a nudge. Defaults and units differ by channel because the platforms differ:

ChannelUnitDefault
EmailDays after last contact2, 5, 10
WhatsApp (free-form)Hours, inside Meta's 24-hour windowNone until you set them
WhatsApp (templates)Days, after the 24-hour window closesNone - you pick approved Meta templates synced from your WABA
InstagramHours, inside Meta's windowNone until you set them

Full detail, including what happens when a free-form message is rejected outside the window, is on the Follow-up Automation page.

Multiple agents#

Run as many agents as you need - one per product line, market, or job to be done. There is no per-plan agent cap. Agents consume credits only when they actually work.

  • Each agent has its own instructions, channel bindings, knowledge tables, custom tools, follow-up schedule and confidence threshold.
  • A channel connection belongs to one agent at a time - two agents can't answer the same WhatsApp number.
  • Members can be granted or denied access per agent, so a junior rep sees only the agent they work on.
  • Switch agents from the agent selector. The inbox, analytics and setup all follow the selection.