Handoffs
A handoff passes a conversation to a person on the team when a visitor asks for one, when Cactus decides the team must answer, or when a teammate escalates it. Team replies reach the visitor by email, a teammate can claim, resolve or reopen the conversation, and a visitor can cancel a request that still waits.
On this page
Ways a conversation reaches the team
A conversation reaches the team when a visitor asks for a person, when Cactus hands it over, or when a teammate escalates it.
A visitor asks for a person
In the Messenger or on the help site, a visitor presses Talk to a human. The conversation goes to the team at once, and the card under the press says where the reply reaches them.
If the visitor left an address, it is kept on the conversation before the handoff, and the card says the reply reaches them by email.
A handoff tested in the Messenger preview tells nobody on the team and draws no card.
Cactus hands it over
The assistant hands a conversation to the team itself when the visitor wants to reach someone on the team, in any words, or needs something only the team can do.
Once a handoff waits, the assistant does not hand the conversation over again.
The team's notice gives Cactus's reason for the handoff.
A teammate escalates it
In the Inbox, a teammate selects Escalate on a conversation no one on the team holds. The conversation is then handed over as the team's own.
Only a member of the product's team can act on a conversation.
What the team sees
A handed-off conversation waits until someone claims it. Select Claim on the thread to take it.
Claiming marks the conversation as claimed and names you as its holder. Claim works only on an escalated conversation. If someone else holds it, the screen says "Name already claimed this conversation."
On a Slack or Discord handoff card, the buttons depend on the state the card shows.
Card state | Buttons |
|---|---|
Waiting, answered or joined, and nobody has claimed it | Buttons Claim, Reply…, Resolve |
Waiting, answered or joined, and claimed | Buttons Reply…, Resolve |
Canceled by the visitor | Buttons Reply… |
Resolved | Buttons Reopen, Reply… |
Every member of the product's team gets an email when a conversation is handed over, whoever started it. It shows the conversation so far and a View the entire conversation button, and its subject is "New escalation from" the visitor's name and the product. A handoff that is already open sends no second notice.
Addresses added on the Escalations page under Deploy get the same email.
If a handoff is still unclaimed and unanswered two hours after the notice, the team gets one reminder.
When the visitor writes again while the team holds the conversation, the team gets one email five minutes after their last message. It goes to the teammate who claimed it, or to the whole team if none has. A teammate's reply withdraws a follow-up that is still waiting.
If the visitor leaves an address after the handoff, the team gets a mail on the notice's own thread.
Replying to the visitor
In the conversation, what you send to the visitor goes as a reply, and what you send to the team goes as a note.
If conversations are translated, the reply reaches the visitor in their language. Set the languages on the Translation page.
A reply also appears in the handoff's Slack or Discord thread.
The visitor gets the team's replies by email five minutes after the last one, and only when they left an address. That email carries the team's replies, not the visitor's words. A reply to it goes to the team's first address.
Resolving and reopening
Select Mark resolved on the thread. The conversation becomes resolved, and the visitor gets a mail saying "{product} resolved this" if they left an address.
The closing mail also carries any reply still waiting in the five-minute window.
On a resolved conversation, select Reopen. It returns to escalated if a handoff had been made, and to open if not, and its claim is cleared.
When the visitor cancels
While a handoff waits, the visitor can cancel it from the card on the Messenger or the help site. Cancelling gives the conversation back to Cactus, which carries on.
Only a handoff the visitor or Cactus started, on the Messenger or the help site, shows a Cancel. A handoff a teammate started from the Inbox does not.
Once a teammate has replied, the visitor can no longer cancel the handoff.
If a teammate replies to a cancelled conversation, it becomes a handoff again.
Handoff states
A handoff is in one of these states at a time, and it moves when someone presses a control.
[figure: handoff states]
What the visitor's card says | What it means |
|---|---|
Waiting for a reply | What it means The team has the conversation and no one has replied, so Cactus keeps helping and the visitor can cancel. |
Claimed by a teammate's name | What it means A teammate has claimed the conversation and not yet replied. |
Answered | What it means A teammate has replied. It also shows when a teammate joined a conversation that was never handed over. |
Canceled by the visitor | What it means The visitor gave the conversation back, and Cactus carries on. |
Resolved | What it means The team marked the conversation done. |
If something goes wrong
What you see | What it means | What to do |
|---|---|---|
"Couldn’t reach the team. Try again in a moment." | What it means The team's service did not take the handoff. | What to do Try again in a moment. |
"Couldn’t reach the team. Try again in a moment." on a cancel | What it means The team's service did not take the cancel. | What to do Try again in a moment. |
"Too many requests to reach the team right now. Try again later." | What it means Too many handoffs reached the team at once from this visitor or product. | What to do Try again later. |
"Cactus couldn’t escalate this conversation. Try again." | What it means Escalate in the Inbox did not go through. | What to do Select Escalate again. |
"Name already claimed this conversation." | What it means Another teammate holds it. | What to do The conversation stays with that teammate. |
"Only an escalated conversation can be claimed." | What it means The conversation is not waiting for the team. | What to do Reply to it, or reopen it if it was resolved. |
"Couldn’t send that. Try again." | What it means A reply or note did not send. | What to do Send it again. |
No team email arrives | What it means A mail the email service cannot take yet waits and is tried again, and is dropped after 48 hours. | What to do Check the conversation in the Inbox. |