Skip to main content
Live chat is built into Tars. Human agents reply in the same thread as the agent, on Web and WhatsApp, and every reply needs a live-chat seat.

One conversation, two kinds of replies

Every conversation is one continuous thread. Replies from the agent, from its AI Agent gambits, and from human agents all appear in the same thread, in order. The end user stays on the same widget or WhatsApp chat when a human joins. Human agents reply to Web and WhatsApp conversations from the same inbox. See Channels overview for how the two channels differ.

The Live Chat gambit

A flow hands a conversation to your team through the Live Chat gambit. In the builder palette it sits under Handoff with the description Escalate the conversation to a human agent. When the gambit runs, the conversation is handed to a human agent and the agent pauses. The agent resumes when the human agent resolves the conversation, the wait window elapses, or nobody is available.

Assignment

The Assignment section decides who picks the conversation up. If you leave the strategy unset on the gambit, the inbox default applies. Inbox defaults are covered in Set up inboxes.

End user identity

At handoff, the latest name, email, and phone are saved so the human agent sees them. The Visitor name, Visitor email, and Visitor phone fields take a literal value or a flow variable. Type @ to insert a variable, for example the answer captured by an earlier gambit. An email or phone confirmed by an earlier OTP gambit is marked as verified.

End user messages

Three messages go to the end user around the handoff. Each field accepts variables with @.

The two exits

The gambit has two exits on the builder, Resolved and No Agents. Connect Resolved to the gambit that should run after the human agent closes the conversation, for example a CSAT question. Connect No Agents to a fallback, for example a gambit that collects an email address. Wiring exits is covered in Flow control and branching.

What happens after the handoff

The conversation is assigned to a human agent by the strategy above and appears in that person’s inbox. While the agent still controls a conversation, a seated member who opens it sees You’re observing this conversation. Take over to reply. with a Take over conversation button. When a conversation belongs to another human agent, the composer is replaced by Reassign to me. The dashboard has no control that hands a conversation back to the agent. Once a human agent takes over, the conversation stays with human agents until someone resolves it. The human agent closes the conversation with Resolve. Tars then sends the Conversation Resolved message and, when the Resolved exit is wired, continues the flow from there. Working the queue and the composer are covered in Work the inbox and Use the Agent Workspace.

The Conversations area

Conversations in the sidebar, under Engagement, opens the live chat area. The left rail carries a Live and Test toggle, the Mentions, Participating, and Unattended views, and your inboxes. Seated members also see their availability control at the bottom of the rail. The Settings entry in the rail opens the live chat settings pages. Each has its own guide.

Who needs a seat

A live-chat seat is the permission to reply to end users. Seats are separate from organization roles. A role controls what a member can see and manage across the organization, and only a seat grants replying in live chat. Roles themselves are covered in Roles and permissions. A Viewer with a seat can reply to end users without gaining any management permissions. A seat also lets the holder read and manage end user records. The Team members page under live chat settings lists everyone with live chat access, with an online status dot and the count of active conversations. Its Manage button opens the organization member list.

What a member sees without a seat

A Member or Viewer without a seat who opens Conversations sees a locked empty state. It reads Livechat isn’t available on your account and asks the member to request a live-chat seat from an organization admin. An Admin without a seat opens conversations in read-only mode. Under the thread, a notice reads Assign yourself a seat to reply with a Manage seats button. The Preferences settings page shows a similar notice, because composer and notification preferences belong to a seated human agent. An Auditor without a seat reads conversations with no composer at all.

Where seats are managed

Admins manage seats on the Livechat seats tab of Settings > Organization. The Manage seats buttons across live chat, and the link on the Billing page, open the same seats page. Buying seats and assigning them are covered in Manage live-chat seats.
The Livechat seats tab in organization settings with the Purchased, Assigned, and Available counts, the member filters, and the member table with a Seat switch per row

Seat counts

A card at the top shows three numbers. The Purchased number is the seats bought in addition to your plan, Assigned is the seats attached to members, and Available is what is left to assign. Seats included with your plan are added to the pool automatically, so Available can be higher than Purchased minus Assigned.

Plan changes and the seat pool

Your seat pool is the seats included with your plan plus the seats you purchased. Included seats depend on your plan and are shown on the Billing card. When the pool shrinks, for example after a downgrade, Tars revokes the most recently assigned seats first until the pool fits. Each affected member receives an email. The Cancel plan dialog warns that live-chat seats deactivate and human agents can no longer reply.