Human handoff
A handoff is the moment an AI agent stops answering and a person takes over. You set the conditions up front on each agent, and you can take over any conversation yourself with one switch.
How it works
Section titled “How it works”When a handoff condition matches, the agent does not reply to that message. The run is recorded as Handed off on the agent’s Activity tab, and the chat waits for your team.
What happens next depends on Stay quiet after a handoff:
- On (the default): the AI is paused for that contact on every channel until you turn it back on. The notification bell tells you someone is waiting.
- Off: only that one message is left for a person. The agent answers the contact’s next message as usual.
Set when the agent hands off
Section titled “Set when the agent hands off”-
Open AI agents, open the agent and go to Handoff & rules.
-
Under Hand a chat to your team when, turn on the conditions you want:
- It is not sure of the answer
- The customer asks for a person
- The customer sounds angry or unhappy
-
Leave Stay quiet after a handoff on unless you want the agent to keep answering after each handoff.
-
Add Handoff keywords. Any of these words hands the chat to a person, without asking the AI. Press Enter after each word.
-
Add Stop keywords. A message that contains one of these words gets no AI reply. Nothing is handed off.
-
Click Save changes.
New agents start with The customer asks for a person and Stay quiet after a handoff on, and with refund, billing and cancel as handoff keywords.
| Condition | How it is detected |
|---|---|
| Handoff keyword | The message contains one of your words. No AI call is made |
| The customer asks for a person | The message contains a built-in phrase such as “real person”, “talk to someone” or “representative”, in English or Turkish. No AI call is made |
| It is not sure of the answer | The AI decides it cannot answer reliably |
| The customer sounds angry or unhappy | The AI judges the tone of the message |
| Rule with Hand off to human | A rule on the same tab matches first |
On the Test tab you can check a message before going live: when the agent would hand off, the playground says so instead of replying.
Take over a conversation
Section titled “Take over a conversation”You can pause the AI for one contact at any time, from their conversation.
-
Open the contact’s conversation.
-
Above the message box, find AI auto-reply is active.
-
Turn the switch off. The bar changes to Human mode: AI is paused for this contact with the badge Paused manually.
-
Reply as usual. The agent stays silent for this contact on every channel.
Replying by hand also pauses the AI. When you send a message to a contact on Telegram, X or the social inbox, from Pinlyx or from the channel’s own app on your phone, Pinlyx pauses the AI for that contact. The bar then shows You replied or You replied from your phone.
Paused contacts show an AI paused badge on their contact card, so you can see who is waiting for a person.
Hand the chat back to the AI
Section titled “Hand the chat back to the AI”-
Open the contact’s conversation.
-
Turn the switch above the message box back on. The bar reads AI auto-reply is active again.
The agent answers the contact’s next message. It does not go back and answer messages that arrived while it was paused.
Notifications
Section titled “Notifications”- Notification bell. When an agent pauses the AI for a contact, the bell shows the contact’s name with AI paused and the reason, for example Customer asked for a human or Handoff keyword matched.
- Alerts. On the agent’s Alerts tab, an alert with the trigger AI asks for a human fires on every handoff, whether or not the AI stays quiet afterwards. Alerts can notify Slack, Discord, email, Telegram or your own webhook, and can also assign the contact to a teammate or create a task.
- Live chat visitors. In a chat widget’s AI replies settings, the Handoff message is shown when the AI escalates to a person or the visitor asks for one. See Live chat.
Good to know
Section titled “Good to know”- A pause covers every channel. Pausing a contact stops every agent for that person, not just the one that handed off.
- Quiet hours are not a handoff. During quiet hours the agent skips messages without pausing the contact.
- Pausing an agent is different. Pause on the agent page stops that agent for everyone. The switch in a conversation stops the AI for one contact.
- Every handoff is logged. Handoffs decided by the AI appear in Settings › AI transparency.