Skip to content

Set up the Operator node ​

This page is for admins. Open the agent in Build → Agents. If the AI Agent has no Operator node, add one, then click it. It has four tabs: Team, Routing, Supervision and Copilot.

The Operator node's Team tab: two web operators and a phone operator

A first setup, in four steps:

  1. Team: add the people who take this agent's hand-offs.
  2. Routing: turn When the AI hands off on and tick who to try.
  3. Supervision (optional): add the team leads who may listen in or take over.
  4. Publish, then have your operators click Go online in Engage → Conversations.

Use case 1 walks through exactly this.

1. Team: who works this agent's conversations ​

Web operators ​

People who answer in Perfox. Add each one as a Studio user of your workspace (they take calls with Conversations → Go online) or an External ID for an operator who connects through your own app with the operator SDK. Drag rows to reorder them; the order matters for the "in the order listed" ring style. Per person, all optional:

FieldWhat it does
SkillsSuch as billing, refunds. Blank takes any hand-off; set, only hand-offs asking for one of them.
LanguagesCodes such as en, ta. Blank takes any customer.
Chats at onceText conversations this person holds together. Blank uses the team default.
Wrap-up, secondsQuiet time after each interaction. Blank uses the team default.

Team defaults: Chats at once 0–10, default 3, counted across every agent the person is on; Wrap-up after a call 0–300 seconds, default 30 (0 means until they press Ready).

Phone operators ​

A name and a number: a fixed number, or one from workflow data (such as the customer's account manager). The AI never chooses who is dialled. Click + Add phone operator to add one. Perfox dials phone operators on a hand-off, one at a time in the order listed, and joins them into the call; the call stays recorded, transcribed, and can come back to the AI. Phone operators are dialled from the agent's own phone number: the number on its Phone Call trigger, which must be listed on a Plivo connection (Admin → Connections). That number is what the phone operator sees as the caller ID. There's no workspace default number: if the agent has no Phone Call trigger number, or no connected Plivo account lists it, nothing is dialled and your admins get a notification explaining the fix.

A phone operator's number must be in a country your workspace may dial (India by default), and premium-rate or special-rate numbers are never dialled. See Security & privacy.

AI operators ​

Let the AI pass a voice call to another of your published agents. Click + Add AI operator and give each one:

  • Name the AI uses: lowercase, no spaces, such as refunds;
  • Agent that takes the call: a published agent other than this one;
  • Transfer when: the AI picks the AI operator from this text.

The new agent takes the call with its own persona, tools and voice, and hears the conversation so far. Its caller rules (keypad input, the quiet-caller check-in, failed turns) apply the moment it takes the call, so a key the caller presses goes to the new agent's menu. The caller is never dropped. AI operators aren't offered in chats.

AI operators on the Team tab: the name the AI uses, the agent that takes the call, and Transfer when

Publish stops on a row with no person, a person listed twice, a phone operator with no usable number, or an AI operator with no agent or no "Transfer when".

2. Routing: who answers, and where hand-offs go ​

Who answers a new phone call? applies to inbound phone calls only; web chat and web voice always start with the AI.

  • The AI (default).
  • The team (the AI assists): your web operators are rung first, with a Ring style (default everyone at once), Ring for, seconds (5–120, default 30) and an optional skill. If nobody on the team is online when the call arrives, the AI answers it; if they're rung but nobody picks up in time, the call ends. Phone operators are dialled only on a hand-off. Needs at least one web operator.

Routing: who answers a new phone call, and the hand-off to web operators one at a time

When the AI hands off is a switch. Off means the AI can't hand off at all and handles everything itself. On:

FieldWhat it doesDefault
Hand off whenTells the AI when to get a person (up to 500 characters).—
Try in this orderDrag Web operators (tick, then choose a ring style) and Phone operators into the order to try. A ticked group with nobody on the Team tab is flagged.—
Ring each person for, seconds5–12030
Only web operators with this skillBlank rings anyone listed.blank
If everyone is busy, wait in queue up to (s)0–900. 0 means no queue.120
Tell the caller their place every (s)0 means never; otherwise 20–300. Voice calls.0
If nobody answersTake a voicemail, or The AI keeps helping; the team calls back.AI keeps helping
When the person leaves the callBack to the AI or End the call.Back to the AI
Flag the conversation and notify the team on every hand-offWith no group ticked and no AI operator, this is all the hand-off does: the AI tells the customer the team will follow up.—

AI operators on the Team tab are offered to the AI as their own targets on calls. On chats, WhatsApp, SMS and email, only web operators are offered the hand-off: phone operators and AI operators are for calls, so an agent whose only group is phone operators flags a chat and notifies the team instead.

Routing on an agent where the team answers phone calls first

A voice call with the AI is capped at 10 minutes, so on a long call a queue wait ends early enough for the AI to close the call properly.

Waiting sounds: what callers hear ​

Three sounds are on Routing → Waiting sounds:

SoundPlaysDefault
Connecting to a personAfter the AI hands off, until a person joins: ringing, a phone operator's brief, the queue. Phone and web voice. Off means the AI keeps the caller company instead.Music — Calm
On hold by an operatorWhile an operator has the caller on hold, including while a warm transfer is still ringing. Phone calls.Periodic tone
While the team is being rungAn inbound phone call when the team answers first: after a short spoken hold line, until someone picks up.Music — Calm

The three waiting sounds on the Routing tab

One more sound stays on the agent's AI Model node, section While the caller waits: AI looking up, while the agent runs a tool (default Off). See AI Model.

Each sound offers Off (silence), Periodic tone, Music — Calm, Music — Bright and Music — Soft chimes. Spoken ("One moment, let me check") is available only on AI looking up with the Pipeline voice.

3. Supervision: who can watch and step in ​

Turn Supervision on, add your supervisors, and tick what they can do:

  • Listen in: hear the call or read the chat live.
  • Whisper: speak to the person on the call; the customer doesn't hear it.
  • Take over: join the customer and drive the conversation.

Supervision: two supervisors who can listen in, whisper and take over, with all three alerts on

Alert them when a customer waits longer than a number of seconds (10–3600), when nobody answered a hand-off, and on every hand-off.

Only the supervisors listed here can supervise this agent's live conversations, and only with the actions ticked; a workspace role adds nothing on top. A supervisor must be signed in to your workspace, including two-step verification if their account uses it. See Live board & supervising.

4. Copilot: what operators start with ​

The Copilot tab sets what each operator starts with on this agent's calls. Each operator can change these during a call.

SettingDefault
Suggest replies while the operator talks ("Help me" on)on
Suggestion length (Sharp, Short, Medium, Detailed)Sharp
Show rich cards (tables, lists) in suggestionson
Copilot language (a language, or Mirror the customer)English
Operators may start outbound calls with this agenton

The Copilot tab: what each operator starts with on this agent's calls

With suggestions on, each customer question produces an answer card ("Customer asked", then key points and Copy) from the agent's own knowledge and tools, and the operator has an Ask the AI pane for their own questions. The AI never speaks to the caller. See Copilot.

Where to go next ​