[{"data":1,"prerenderedAt":414},["ShallowReactive",2],{"documentation-\u002Fdocumentation\u002Flive-chat\u002Fhandoff":3},{"id":4,"title":5,"body":6,"description":404,"extension":405,"meta":406,"navigation":407,"ogImage":408,"path":409,"seo":410,"sitemap":411,"stem":412,"__hash__":413},"content\u002Fdocumentation\u002Flive-chat\u002Fhandoff.md","Handoff & availability",{"type":7,"value":8,"toc":393},"minimark",[9,18,23,59,63,74,85,89,104,107,111,161,175,179,182,196,199,202,206,209,275,286,290,371,375],[10,11,12,13,17],"p",{},"Handoff is the moment a conversation moves from the chatbot to a person. All settings are in ",[14,15,16],"strong",{},"Settings → Handoff & availability",".",[19,20,22],"h2",{"id":21},"what-triggers-a-handoff","What triggers a handoff",[24,25,26,37,47],"ul",{},[27,28,29,32,33,36],"li",{},[14,30,31],{},"The visitor"," clicks ",[14,34,35],{},"Talk to a human"," in the widget (if the button is on).",[27,38,39,42,43,46],{},[14,40,41],{},"The AI"," decides it can't help, or the visitor is frustrated (if ",[14,44,45],{},"AI can hand off to a human"," is on).",[27,48,49,52,53,58],{},[14,50,51],{},"A scenario"," reaches a handoff step, for example a \"Connect with support\" button. Each AI step can also turn AI handoff off for its part of the conversation (see ",[54,55,57],"a",{"href":56},"\u002Fdocumentation\u002Fscenarios#ai-step-settings","Scenarios",").",[19,60,62],{"id":61},"what-happens-next","What happens next",[64,65,71],"pre",{"className":66,"code":68,"language":69,"meta":70},[67],"language-text","Handoff requested\n  ├─ Outside business hours, or no operator online → offline form\n  └─ Otherwise → visitor waits in queue (sees their position)\n        ├─ An operator accepts \u002F gets assigned → live chat\n        └─ Nobody within the wait timeout → offline form\n","text","",[72,73,68],"code",{"__ignoreMap":70},[10,75,76,77,80,81,84],{},"The ",[14,78,79],{},"offline form"," asks for the visitor's email and message. Every workspace member gets an email and a push notification, and the conversation appears under ",[14,82,83],{},"Needs follow-up"," in the inbox.",[19,86,88],{"id":87},"business-hours","Business hours",[10,90,91,92,95,96,99,100,103],{},"Turn on ",[14,93,94],{},"Use business hours",", pick a ",[14,97,98],{},"timezone"," and set opening times for each day. The default is Monday to Friday, 9:00 to 17:00. Use ",[14,101,102],{},"Copy Monday to weekdays"," to save time.",[10,105,106],{},"With business hours off, visitors can reach a human whenever at least one operator is online.",[19,108,110],{"id":109},"routing","Routing",[112,113,114,130],"table",{},[115,116,117],"thead",{},[118,119,120,124,127],"tr",{},[121,122,123],"th",{},"Option",[121,125,126],{},"How it works",[121,128,129],{},"Best for",[131,132,133,148],"tbody",{},[118,134,135,142,145],{},[136,137,138,141],"td",{},[14,139,140],{},"Notify everyone"," (default)",[136,143,144],{},"Every online operator is notified. The first to accept gets the chat.",[136,146,147],{},"Small teams",[118,149,150,155,158],{},[136,151,152],{},[14,153,154],{},"Assign automatically",[136,156,157],{},"The chat goes straight to the online operator with the fewest open chats. If everyone is full, the visitor waits in the queue.",[136,159,160],{},"Teams of 3+",[24,162,163,169],{},[27,164,165,168],{},[14,166,167],{},"Max chats per operator"," (default 5, range 1 to 50): with automatic assignment, an operator at this limit gets no new chats until they close one. The queue moves automatically when a chat closes or an operator comes online.",[27,170,171,174],{},[14,172,173],{},"Wait before offering to leave a message"," (default 2 minutes, range 30 seconds to 30 minutes): how long a visitor waits before they get the offline form.",[19,176,178],{"id":177},"operator-availability","Operator availability",[10,180,181],{},"Each operator sets their own status from the toggle in the app:",[24,183,184,190],{},[27,185,186,189],{},[14,187,188],{},"Online",": gets notified and can be assigned chats.",[27,191,192,195],{},[14,193,194],{},"Away",": still sees requests, but no sounds and no new assignments.",[10,197,198],{},"An operator who closes the app (no activity for 3 minutes) is treated as offline. If nobody is online, visitors go straight to the offline form, so they never wait for no one.",[10,200,201],{},"The app keeps you online only while it's open and you're signed in. A background tab is usually fine; a closed tab, a sleeping laptop or a tab the browser put to sleep to save memory isn't.",[19,203,205],{"id":204},"why-did-a-visitor-get-the-offline-form","Why did a visitor get the offline form?",[10,207,208],{},"Open the conversation in the inbox. The system message above the form says why:",[112,210,211,224],{},[115,212,213],{},[118,214,215,218,221],{},[121,216,217],{},"Message",[121,219,220],{},"Cause",[121,222,223],{},"What to do",[131,225,226,241,257],{},[118,227,228,233,236],{},[136,229,230],{},[14,231,232],{},"Outside business hours",[136,234,235],{},"Business hours are on and the chat came outside them. This is checked first, so it applies even when you're online.",[136,237,238,239,17],{},"Adjust the opening times, or turn off ",[14,240,94],{},[118,242,243,248,254],{},[136,244,245],{},[14,246,247],{},"No operators available",[136,249,250,251,253],{},"Nobody had status ",[14,252,188],{}," and the app open in the last 3 minutes.",[136,255,256],{},"Check your status toggle and keep the app open.",[118,258,259,264,267],{},[136,260,261],{},[14,262,263],{},"Nobody accepted in time",[136,265,266],{},"Operators were notified, but nobody joined within the wait timeout.",[136,268,269,270,272,273,17],{},"Raise ",[14,271,173],{},", or switch to ",[14,274,154],{},[10,276,277,278,281,282,17],{},"If there's no such message, the form came from your scenario, for example the ",[14,279,280],{},"Otherwise"," branch of a ",[54,283,285],{"href":284},"\u002Fdocumentation\u002Fscenarios#conditions","Condition",[19,287,289],{"id":288},"visitor-experience","Visitor experience",[112,291,292,305],{},[115,293,294],{},[118,295,296,299,302],{},[121,297,298],{},"Setting",[121,300,301],{},"Default",[121,303,304],{},"What it does",[131,306,307,320,331,343,359],{},[118,308,309,314,317],{},[136,310,311],{},[14,312,313],{},"\"Talk to a human\" button",[136,315,316],{},"On",[136,318,319],{},"Lets visitors ask for an operator at any time.",[118,321,322,326,328],{},[136,323,324],{},[14,325,45],{},[136,327,316],{},[136,329,330],{},"The AI escalates when it can't help.",[118,332,333,338,340],{},[136,334,335],{},[14,336,337],{},"AI handoff summary",[136,339,316],{},[136,341,342],{},"Operators get a short summary, intent and sentiment before they join.",[118,344,345,350,352],{},[136,346,347],{},[14,348,349],{},"Ask for email when nobody is available",[136,351,316],{},[136,353,354,355,358],{},"Shows the offline form. Customize the ",[14,356,357],{},"Offline message"," (up to 500 characters).",[118,360,361,366,368],{},[136,362,363],{},[14,364,365],{},"Ask for a rating after the chat",[136,367,316],{},[136,369,370],{},"After a conversation with an operator is closed, the visitor can rate it 1 to 5 and leave a comment. Customize the question (up to 200 characters).",[19,372,374],{"id":373},"get-notified","Get notified",[24,376,377,383],{},[27,378,379,382],{},[14,380,381],{},"In the app and browser",": allow notifications when the app asks. You'll get a push for new chat requests, chats assigned to you and offline messages.",[27,384,385,388,389,17],{},[14,386,387],{},"Slack or Discord",": get new chat requests in a channel. See ",[54,390,392],{"href":391},"\u002Fdocumentation\u002Fintegrations","Integrations",{"title":70,"searchDepth":394,"depth":394,"links":395},2,[396,397,398,399,400,401,402,403],{"id":21,"depth":394,"text":22},{"id":61,"depth":394,"text":62},{"id":87,"depth":394,"text":88},{"id":109,"depth":394,"text":110},{"id":177,"depth":394,"text":178},{"id":204,"depth":394,"text":205},{"id":288,"depth":394,"text":289},{"id":373,"depth":394,"text":374},"Control when visitors reach a human: business hours, routing, max chats per operator, wait timeout, offline messages, AI handoff summaries and ratings.","md",{},true,null,"\u002Fdocumentation\u002Flive-chat\u002Fhandoff",{"title":5,"description":404},{"loc":409},"documentation\u002Flive-chat\u002Fhandoff","Up87gHahxTbbQGivUY1RkNFZ8K-ADz4Z1U5HffXwkS8",1794660402087]