[{"data":1,"prerenderedAt":716},["ShallowReactive",2],{"documentation-\u002Fdocumentation\u002Fscenarios":3},{"id":4,"title":5,"body":6,"description":706,"extension":707,"meta":708,"navigation":709,"ogImage":710,"path":711,"seo":712,"sitemap":713,"stem":714,"__hash__":715},"content\u002Fdocumentation\u002Fscenarios.md","Scenarios",{"type":7,"value":8,"toc":693},"minimark",[9,22,25,36,41,153,160,167,171,178,259,266,277,281,291,294,304,314,404,415,435,441,445,456,459,482,485,488,492,499,552,558,562,572,584,588,612,619,626,630,635,641,646,652,657,663,668,674,678,685],[10,11,12,13,17,18,21],"p",{},"A scenario is the flow a conversation follows, from the first message to the AI or a human. Edit it in ",[14,15,16],"strong",{},"Scenario → Web"," (or ",[14,19,20],{},"Email"," for the email channel).",[10,23,24],{},"If you just want an AI that answers questions with a \"talk to a human\" option, you don't need to build anything. New workspaces start with a ready-made scenario:",[26,27,33],"pre",{"className":28,"code":30,"language":31,"meta":32},[29],"language-text","Welcome message\n  ├─ [Learn more…]          → AI step (answers from your knowledge base)\n  └─ [Connect with support] → Handoff step\n","text","",[34,35,30],"code",{"__ignoreMap":32},[37,38,40],"h2",{"id":39},"step-types","Step types",[42,43,44,57],"table",{},[45,46,47],"thead",{},[48,49,50,54],"tr",{},[51,52,53],"th",{},"Step",[51,55,56],{},"What it does",[58,59,60,71,87,97,107,118,129,143],"tbody",{},[48,61,62,68],{},[63,64,65],"td",{},[14,66,67],{},"Send Message",[63,69,70],{},"The bot says something and moves on.",[48,72,73,78],{},[63,74,75],{},[14,76,77],{},"Ask Question",[63,79,80,81,86],{},"Waits for a typed answer in the format you choose: text, email, phone number, number or website address. Answers can be saved to any ",[82,83,85],"a",{"href":84},"\u002Fdocumentation\u002Flive-chat\u002Fcontacts","contact property",".",[48,88,89,94],{},[63,90,91],{},[14,92,93],{},"Ask Question with Buttons",[63,95,96],{},"Offers choices; each button leads to its own step or opens a link.",[48,98,99,104],{},[63,100,101],{},[14,102,103],{},"Send List of Cards",[63,105,106],{},"A carousel of cards, e.g. products, each with buttons.",[48,108,109,115],{},[63,110,111,114],{},[14,112,113],{},"Train Agent"," (AI step)",[63,116,117],{},"The AI answers from your knowledge base and keeps answering until the visitor clicks one of the step's buttons, the AI hands off, or the conversation moves on.",[48,119,120,126],{},[63,121,122,125],{},[14,123,124],{},"Call Operator"," (handoff)",[63,127,128],{},"Requests a human. Its first child step runs when nobody is available.",[48,130,131,136],{},[63,132,133],{},[14,134,135],{},"Condition",[63,137,138,139,86],{},"Sends nothing. Picks the next step by rules, e.g. whether anyone is online. See ",[82,140,142],{"href":141},"#conditions","Conditions",[48,144,145,150],{},[63,146,147],{},[14,148,149],{},"Webhook",[63,151,152],{},"Loads buttons or cards from your own URL, e.g. live stock or open booking slots.",[10,154,155,156,159],{},"Any step can have a ",[14,157,158],{},"delay"," before it's sent (in seconds), to feel more natural.",[10,161,162,163,166],{},"Message, question, button and handoff steps can also show an ",[14,164,165],{},"image"," (PNG, JPG, GIF or WebP, up to 5 MB) right before their text, for example a screenshot of your product or a short GIF. Upload it or paste a URL, and add alt text for screen readers, an optional caption and an optional link that opens when the image is clicked.",[37,168,170],{"id":169},"questions","Questions",[10,172,173,174,177],{},"Pick a ",[14,175,176],{},"question type"," to get a matching input in the widget and a validated answer:",[42,179,180,193],{},[45,181,182],{},[48,183,184,187,190],{},[51,185,186],{},"Type",[51,188,189],{},"Accepts",[51,191,192],{},"Saved to by default",[58,194,195,206,215,229,246],{},[48,196,197,200,203],{},[63,198,199],{},"Text",[63,201,202],{},"Anything",[63,204,205],{},"Nothing",[48,207,208,210,213],{},[63,209,20],{},[63,211,212],{},"A valid email address",[63,214,20],{},[48,216,217,220,226],{},[63,218,219],{},"Phone number",[63,221,222,223],{},"A phone number, e.g. ",[34,224,225],{},"+421 905 123 456",[63,227,228],{},"Phone",[48,230,231,234,244],{},[63,232,233],{},"Number",[63,235,236,237,240,241],{},"A number, e.g. ",[34,238,239],{},"12"," or ",[34,242,243],{},"3,5",[63,245,205],{},[48,247,248,251,257],{},[63,249,250],{},"Website address",[63,252,253,254],{},"A web address, e.g. ",[34,255,256],{},"example.com",[63,258,205],{},[10,260,261,262,265],{},"If the answer doesn't match, the bot asks again. Set ",[14,263,264],{},"Message when the answer is invalid"," to choose what it says, for example in your visitors' language.",[10,267,268,269,272,273,276],{},"To keep an answer, enter a property key in ",[14,270,271],{},"Save answer to contact property",", such as ",[34,274,275],{},"business_type",". It appears on the contact in the inbox and is synced to your CRM. If the property doesn't exist yet, Chatisto creates it.",[37,278,280],{"id":279},"buttons","Buttons",[10,282,283,284,240,287,290],{},"Each button either ",[14,285,286],{},"goes to a step",[14,288,289],{},"opens a link"," in a new tab, for example your signup page, pricing or a booking calendar. A link button doesn't move the conversation, so the visitor can open it and still pick another option.",[37,292,142],{"id":293},"conditions",[10,295,296,297,299,300,303],{},"A ",[14,298,135],{}," step routes the conversation without sending anything. It checks its branches from the top and continues to the first one that matches. If none does, it goes to ",[14,301,302],{},"Otherwise",", or continues normally when that's empty.",[10,305,306,307,240,310,313],{},"Each branch has one or more rules, and either ",[14,308,309],{},"all",[14,311,312],{},"any"," of them must match. A rule checks one of these:",[42,315,316,326],{},[45,317,318],{},[48,319,320,323],{},[51,321,322],{},"Field",[51,324,325],{},"Example",[58,327,328,336,344,358,369,380,388],{},[48,329,330,333],{},[63,331,332],{},"An operator is online",[63,334,335],{},"is false → collect an email and promise a reply",[48,337,338,341],{},[63,339,340],{},"Within business hours",[63,342,343],{},"is true → offer a handoff",[48,345,346,349],{},[63,347,348],{},"Contact property",[63,350,351,354,355],{},[34,352,353],{},"plan"," equals ",[34,356,357],{},"pro",[48,359,360,363],{},[63,361,362],{},"Answer to a step",[63,364,365,366],{},"answer to \"What do you need?\" contains ",[34,367,368],{},"refund",[48,370,371,374],{},[63,372,373],{},"Page URL",[63,375,376,377],{},"contains ",[34,378,379],{},"\u002Fpricing",[48,381,382,385],{},[63,383,384],{},"Channel",[63,386,387],{},"equals Website chat or Email",[48,389,390,393],{},[63,391,392],{},"Visitor's language",[63,394,395,396,399,400,403],{},"equals ",[34,397,398],{},"de"," (also matches ",[34,401,402],{},"de-AT",")",[10,405,406,407,410,411,414],{},"Text comparisons ignore letter case. ",[14,408,409],{},"Is greater than"," and ",[14,412,413],{},"is less than"," compare numbers.",[10,416,417,419,420,423,424,428,429,431,432,434],{},[14,418,332],{}," is true when at least one team member has their status set to ",[14,421,422],{},"Online"," and has had the app open in the last 3 minutes (see ",[82,425,427],{"href":426},"\u002Fdocumentation\u002Flive-chat\u002Fhandoff#operator-availability","Operator availability","). It doesn't look at business hours, but ",[14,430,124],{}," does: outside business hours the visitor gets the offline form even when someone is online. To send visitors to a handoff only when someone can actually take it, use one branch with both rules and ",[14,433,309],{}," must match:",[26,436,439],{"className":437,"code":438,"language":31,"meta":32},[29],"Condition\n  ├─ Team available (all): An operator is online is true + Within business hours is true → Call Operator\n  └─ Otherwise → Ask Question (Email): \"We'll get back to you. What's your email?\"\n",[34,440,438],{"__ignoreMap":32},[37,442,444],{"id":443},"how-the-flow-moves","How the flow moves",[10,446,447,448,451,452,455],{},"The conversation starts at the ",[14,449,450],{},"starting step",", marked on the canvas. To change it, use ",[14,453,454],{},"Set as starting item"," on another step.",[10,457,458],{},"After a step, the conversation continues to:",[460,461,462,470,477],"ol",{},[463,464,465,466,469],"li",{},"its ",[14,467,468],{},"Next step",", if you set one;",[463,471,472,473,476],{},"otherwise its ",[14,474,475],{},"first child",";",[463,478,472,479,86],{},[14,480,481],{},"next sibling",[10,483,484],{},"Buttons always go to their own target step. A button without a target follows the same order as above, so make sure every button in a menu has one.",[10,486,487],{},"An AI step keeps the conversation until the visitor clicks one of its buttons, the AI hands off, or you set a next step (the next step takes over after the AI's first answer).",[37,489,491],{"id":490},"show-a-different-scenario-on-some-pages","Show a different scenario on some pages",[10,493,494,495,498],{},"By default every chat starts with the live scenario. To start another scenario on specific pages, open it and click ",[14,496,497],{},"Pages",", then enter one pattern per line:",[42,500,501,511],{},[45,502,503],{},[48,504,505,508],{},[51,506,507],{},"Pattern",[51,509,510],{},"Matches",[58,512,513,522,532,542],{},[48,514,515,519],{},[63,516,517],{},[34,518,379],{},[63,520,521],{},"only the pricing page",[48,523,524,529],{},[63,525,526],{},[34,527,528],{},"\u002Fpricing*",[63,530,531],{},"the pricing page and everything below it",[48,533,534,539],{},[63,535,536],{},[34,537,538],{},"*\u002Fblog\u002F*",[63,540,541],{},"every blog post, in any language folder",[48,543,544,549],{},[63,545,546],{},[34,547,548],{},"https:\u002F\u002Fshop.example.com\u002F*",[63,550,551],{},"every page on that domain",[10,553,554,557],{},[34,555,556],{},"*"," is the wildcard. Matching ignores letter case, and paths match with or without query parameters. When several scenarios match, the most specific pattern wins. The live scenario is the fallback for all other pages; page rules on the live scenario itself have no effect. The page is checked when the chat starts, so the conversation keeps its scenario while the visitor browses.",[37,559,561],{"id":560},"languages","Languages",[10,563,564,565,567,568,571],{},"To show a scenario in your visitors' language, click ",[14,566,561],{}," in the scenario editor. Pick the ",[14,569,570],{},"primary language"," your steps are written in and the languages you translate into. Each step then gets a language switcher where you translate its message, button labels, invalid-answer message and image texts.",[10,573,574,575,577,578,580,581,583],{},"Visitors get the language that matches their browser (",[34,576,402],{}," matches ",[34,579,398],{},"), otherwise the primary language. Anything you haven't translated falls back to the primary text. Button targets and links are shared across languages, so you only build the flow once. AI steps answer in the visitor's language automatically, and a Condition can branch on ",[14,582,392],{}," if you'd rather build separate paths.",[37,585,587],{"id":586},"ai-step-settings","AI step settings",[10,589,590,591,595,596,410,600,603,604,607,608,86],{},"In each AI step you choose what the AI may do: search the knowledge base, save emails, use ",[82,592,594],{"href":593},"\u002Fdocumentation\u002Fai\u002Fskills","skills",", call ",[82,597,599],{"href":598},"\u002Fdocumentation\u002Fai\u002Fknowledge-base#what-the-ai-can-do-in-a-conversation","custom tools",[14,601,602],{},"hand off to a human"," when it's unsure or the visitor asks for a person. Handoff also needs ",[14,605,606],{},"AI can hand off to a human"," turned on in the ",[82,609,611],{"href":610},"\u002Fdocumentation\u002Flive-chat\u002Fhandoff","handoff settings",[10,613,614,615,618],{},"Add ",[14,616,617],{},"buttons under AI answers"," to give visitors a way out, such as \"Back to menu\" or \"Talk to a human\". They appear under every AI answer, and visitors can still type to keep chatting with the AI.",[10,620,621,622,625],{},"The step's message is extra instructions for this part of the conversation. You can insert a visitor's earlier answer with ",[34,623,624],{},"[[stepId]]",", using the ID of the question step.",[37,627,629],{"id":628},"recipes","Recipes",[10,631,632],{},[14,633,634],{},"Collect an email before the AI answers",[26,636,639],{"className":637,"code":638,"language":31,"meta":32},[29],"Welcome message → Ask Question (Email): \"What's your email, in case we get disconnected?\" → AI step\n",[34,640,638],{"__ignoreMap":32},[10,642,643],{},[14,644,645],{},"Route by topic",[26,647,650],{"className":648,"code":649,"language":31,"meta":32},[29],"Ask Question with Buttons: \"What can we help with?\"\n  ├─ [Order status] → AI step with the order-lookup custom tool\n  ├─ [Product questions] → AI step\n  └─ [Talk to sales] → Call Operator\n",[34,651,649],{"__ignoreMap":32},[10,653,654],{},[14,655,656],{},"Let visitors leave the AI",[26,658,661],{"className":659,"code":660,"language":31,"meta":32},[29],"Main menu (Ask Question with Buttons)\n  └─ [Ask anything] → AI step\n                        ├─ [Back to menu] → Main menu\n                        ├─ [Book a demo]  → opens your booking link\n                        └─ [Talk to a human] → Call Operator\n",[34,662,660],{"__ignoreMap":32},[10,664,665],{},[14,666,667],{},"Qualify a lead",[26,669,672],{"className":670,"code":671,"language":31,"meta":32},[29],"Ask Question (Text): \"What kind of business do you run?\" → saved to business_type\n  → Ask Question (Email): \"Where can we send the details?\"\n  → Call Operator\n",[34,673,671],{"__ignoreMap":32},[37,675,677],{"id":676},"going-live","Going live",[10,679,680,681,684],{},"Changes reach visitors immediately, so test with the widget preview in ",[14,682,683],{},"Settings → Client Settings"," after editing.",[10,686,687,688,692],{},"For bigger changes, use the ",[82,689,691],{"href":690},"\u002Fdocumentation\u002Fmcp","Chatisto MCP server",": describe the flow to Claude or ChatGPT, review it, and only then activate it as your live scenario.",{"title":32,"searchDepth":694,"depth":694,"links":695},2,[696,697,698,699,700,701,702,703,704,705],{"id":39,"depth":694,"text":40},{"id":169,"depth":694,"text":170},{"id":279,"depth":694,"text":280},{"id":293,"depth":694,"text":142},{"id":443,"depth":694,"text":444},{"id":490,"depth":694,"text":491},{"id":560,"depth":694,"text":561},{"id":586,"depth":694,"text":587},{"id":628,"depth":694,"text":629},{"id":676,"depth":694,"text":677},"Design the flow every Chatisto conversation follows: welcome messages, button menus, questions, AI steps and handoff to a human.","md",{},true,null,"\u002Fdocumentation\u002Fscenarios",{"title":5,"description":706},{"loc":711},"documentation\u002Fscenarios","cJsRy8SlkCqkejdQyBWFMR27YPNi71y3WTXcdJjo2W0",1794660396407]