[{"data":1,"prerenderedAt":514},["ShallowReactive",2],{"pomoc:\u002Fhelp\u002Fknowledge-base\u002Fbest-practices":3,"pomoc-pages:help_en":189},{"id":4,"title":5,"alt":6,"body":7,"description":179,"extension":180,"key":181,"meta":182,"navigation":183,"order":184,"path":185,"seo":186,"stem":187,"__hash__":188},"help_en\u002Fhelp\u002Fknowledge-base\u002Fbest-practices.md","Best practices","\u002Fpomoc\u002Fbaza-wiedzy\u002Fnajlepsze-praktyki",{"type":8,"value":9,"toc":167},"minimark",[10,14,19,27,34,40,44,53,57,60,79,82,94,98,104,108,111,124,128,140,144,155,159],[11,12,13],"p",{},"Lessons gathered from the deployments that work best. Don't treat them as\nrigid rules; they're a starting point, not gospel.",[15,16,18],"h2",{"id":17},"be-specific","Be specific",[11,20,21,22,26],{},"The bot answers better when it finds ",[23,24,25],"strong",{},"facts"," in the base, not\ngeneralities.",[11,28,29,30],{},"❌ ",[31,32,33],"em",{},"\"We offer fast delivery and returns in line with company policy.\"",[11,35,36,37],{},"✅ ",[31,38,39],{},"\"Courier shipping within 24 hours of payment. Returns accepted within\n30 days of delivery, free of charge within Poland.\"",[15,41,43],{"id":42},"one-topic-one-article","One topic, one article",[11,45,46,47,52],{},"Mixing several topics into a single entry lowers search relevance. It's\nbetter to split them into separate articles and, if needed, link them\nwith ",[48,49,51],"a",{"href":50},"\u002Fhelp\u002Fknowledge-base\u002Fprerequisites","prerequisites",".",[15,54,56],{"id":55},"write-from-the-customers-perspective","Write from the customer's perspective",[11,58,59],{},"Phrasings that work well:",[61,62,63,69,74],"ul",{},[64,65,66],"li",{},[31,67,68],{},"\"To return a product, …\"",[64,70,71],{},[31,72,73],{},"\"We'll issue an invoice if …\"",[64,75,76],{},[31,77,78],{},"\"You'll find your order in …\"",[11,80,81],{},"Phrasings worth rewriting:",[61,83,84,89],{},[64,85,86],{},[31,87,88],{},"\"The system allows the initiation of the return process …\"",[64,90,91],{},[31,92,93],{},"\"The recipient-side customer is in possession of …\"",[15,95,97],{"id":96},"keep-articles-200800-words","Keep articles 200–800 words",[11,99,100,101,52],{},"Fibly will flag articles that are too short (under 50 words) as not\nuseful. Ones that are too long (over 1,000 words) tend to mix topics and\nlower relevance. The optimal length is ",[23,102,103],{},"200 to 800 words",[15,105,107],{"id":106},"update-after-product-changes","Update after product changes",[11,109,110],{},"After every change to pricing, terms, or a procedure, check whether your\nexisting articles are still up to date. Stale content in the knowledge\nbase misleads customers, which undermines trust in the bot and the brand.",[112,113,114],"blockquote",{},[11,115,116,119,120,123],{},[23,117,118],{},"Tip:"," once a month, review the conversations in the ",[23,121,122],{},"Conversations","\nsection, especially those that were escalated. They're material for new\narticles. Every unhandled question is a gap in the knowledge base.",[15,125,127],{"id":126},"use-headings","Use headings",[11,129,130,131,135,136,139],{},"Short ",[132,133,134],"code",{},"##"," headings in long articles help the bot get to the point. A\ncustomer asking about a complaint over a manufacturing defect will get a\nmore accurate answer if you highlight a ",[23,137,138],{},"\"Manufacturing defects\"","\nsection in the article.",[15,141,143],{"id":142},"dont-copy-the-lawyers","Don't copy the lawyers",[11,145,146,147,150,151,154],{},"Terms and conditions written in formal, legal language are hard for the\nbot and unreadable for customers. Keep the text of your terms in the base\nas a ",[23,148,149],{},"reference",", but next to it write a ",[23,152,153],{},"summary in your own words",",\nand let that be the basis for answers.",[15,156,158],{"id":157},"whats-next","What's next",[11,160,161,162,166],{},"Once your knowledge base is working, move on to\n",[48,163,165],{"href":164},"\u002Fhelp\u002Fbot-configuration","bot configuration",". That's what ultimately\ndecides the tone of the answers.",{"title":168,"searchDepth":169,"depth":169,"links":170},"",2,[171,172,173,174,175,176,177,178],{"id":17,"depth":169,"text":18},{"id":42,"depth":169,"text":43},{"id":55,"depth":169,"text":56},{"id":96,"depth":169,"text":97},{"id":106,"depth":169,"text":107},{"id":126,"depth":169,"text":127},{"id":142,"depth":169,"text":143},{"id":157,"depth":169,"text":158},"Tips for writing, organizing, and maintaining your Fibly bot's knowledge base.","md","knowledge-base\u002Fbest-practices",{},true,7,"\u002Fhelp\u002Fknowledge-base\u002Fbest-practices",{"title":5,"description":179},"help\u002Fknowledge-base\u002Fbest-practices","9yASbspTEcAowK8PtIoYI8_CZpHzJnsPeiSRUGZhc4w",[190,195,198,204,210,215,220,225,230,235,240,245,250,255,260,265,270,275,280,285,290,295,300,305,310,315,321,326,331,336,341,346,351,356,362,367,372,377,382,387,392,397,403,408,413,417,423,428,433,438,439,444,450,456,462,468,473,478,484,490,496,502,508],{"path":191,"title":192,"description":193,"order":194,"key":194},"\u002Fhelp\u002Fconversations\u002Fconversation-details","Conversation details","[object Object]",null,{"path":196,"title":197,"description":193,"order":194,"key":194},"\u002Fhelp\u002Fteam-and-account\u002Ftwo-factor-authentication","Two-factor authentication",{"path":199,"title":200,"description":201,"order":202,"key":203},"\u002Fhelp","Fibly Help Center","Guides, instructions, and answers to questions about setting up and working with Fibly day to day.",0,"index",{"path":205,"title":206,"description":207,"order":208,"key":209},"\u002Fhelp\u002Fbot-configuration\u002Fbrand","Brand","How to set your website address and a short brand description, the two fields the Fibly bot uses as its basic context.",1,"bot-configuration\u002Fbrand",{"path":211,"title":212,"description":213,"order":208,"key":214},"\u002Fhelp\u002Fcustomers\u002Fcustomer-list","Customer list","How to view, filter, and search customers in the Fibly dashboard.","customers\u002Fcustomer-list",{"path":216,"title":217,"description":218,"order":208,"key":219},"\u002Fhelp\u002Fgetting-started\u002Fhow-the-bot-works","How the Fibly bot works","An overview of the architecture, from the customer's question to handing the matter over to your team.","getting-started\u002Fhow-the-bot-works",{"path":221,"title":222,"description":223,"order":208,"key":224},"\u002Fhelp\u002Finstallation\u002Fwordpress","Installing on WordPress","Three ways to add the Fibly widget to a WordPress-based site.","installation\u002Fwordpress",{"path":226,"title":227,"description":228,"order":208,"key":229},"\u002Fhelp\u002Fconversations\u002Flist-and-filters","List and filters","How to filter, sort, and find conversations in the Fibly dashboard.","conversations\u002Flist-and-filters",{"path":231,"title":232,"description":233,"order":208,"key":234},"\u002Fhelp\u002Fanalytics\u002Foverview","Overview","What the metric tiles and charts on the Fibly panel's home screen show.","analytics\u002Foverview",{"path":236,"title":237,"description":238,"order":208,"key":239},"\u002Fhelp\u002Fbilling\u002Fplans","Plans","A comparison of the Starter, Professional, and Enterprise plans in Fibly, plus the available add-ons.","billing\u002Fplans",{"path":241,"title":242,"description":243,"order":208,"key":244},"\u002Fhelp\u002Flive-support\u002Ftaking-over-a-conversation","Taking over a conversation","How to take a conversation over from the bot and handle it personally as an agent.","live-support\u002Ftaking-over-a-conversation",{"path":246,"title":247,"description":248,"order":208,"key":249},"\u002Fhelp\u002Fteam-and-account\u002Fteam-members","Team members","How to invite, edit, and remove a user in the Fibly dashboard.","team-and-account\u002Fteam-members",{"path":251,"title":252,"description":253,"order":208,"key":254},"\u002Fhelp\u002Fwidget\u002Fappearance","Widget appearance","How to match the colors, button text, and chat window title to your brand.","widget\u002Fappearance",{"path":256,"title":257,"description":258,"order":208,"key":259},"\u002Fhelp\u002Ftroubleshooting\u002Fwidget-not-appearing","Widget not appearing","What to check when the chat button doesn't show up after embedding the script on your site.","troubleshooting\u002Fwidget-not-appearing",{"path":261,"title":262,"description":263,"order":169,"key":264},"\u002Fhelp\u002Ftroubleshooting\u002Fbot-gives-wrong-answers","Bot gives wrong answers","What to do when the bot answers inaccurately, mixes up facts, or makes things up.","troubleshooting\u002Fbot-gives-wrong-answers",{"path":266,"title":267,"description":268,"order":169,"key":269},"\u002Fhelp\u002Fanalytics\u002Fcontrol-center","Control Center","Advanced escalation analytics, bot confidence breakdown, and recommendations in the Fibly panel.","analytics\u002Fcontrol-center",{"path":271,"title":272,"description":273,"order":169,"key":274},"\u002Fhelp\u002Fbilling\u002Fcredits-and-usage","Credits and usage","What AI credits are, how many a single bot message consumes, and where to check your current usage.","billing\u002Fcredits-and-usage",{"path":276,"title":277,"description":278,"order":169,"key":279},"\u002Fhelp\u002Fcustomers\u002Fcustomer-profile","Customer profile","How to edit customer details, add notes, review conversation history, and anonymize data in line with GDPR.","customers\u002Fcustomer-profile",{"path":281,"title":282,"description":283,"order":169,"key":284},"\u002Fhelp\u002Flive-support\u002Fending-a-conversation","Ending a conversation","How to hand a conversation back to the bot or close it with a resolution outcome.","live-support\u002Fending-a-conversation",{"path":286,"title":287,"description":288,"order":169,"key":289},"\u002Fhelp\u002Fgetting-started\u002Ffirst-login","First login","How to accept your Fibly invitation and get access to the admin dashboard.","getting-started\u002Ffirst-login",{"path":291,"title":292,"description":293,"order":169,"key":294},"\u002Fhelp\u002Fknowledge-base\u002Fimport-markdown","Import Markdown files","How to import existing documentation in Markdown format into the Fibly knowledge base.","knowledge-base\u002Fimport-markdown",{"path":296,"title":297,"description":298,"order":169,"key":299},"\u002Fhelp\u002Finstallation\u002Fshopify","Installing on Shopify","How to add the Fibly widget to a Shopify store by editing the theme.liquid file.","installation\u002Fshopify",{"path":301,"title":302,"description":303,"order":169,"key":304},"\u002Fhelp\u002Fbot-configuration\u002Fmessages","Messages","How to set the bot's first message and choose one of three conversational personalities.","bot-configuration\u002Fmessages",{"path":306,"title":307,"description":308,"order":169,"key":309},"\u002Fhelp\u002Fteam-and-account\u002Froles-and-permissions","Roles and permissions","What the Admin, Manager, and Agent can do in the Fibly dashboard.","team-and-account\u002Froles-and-permissions",{"path":311,"title":312,"description":313,"order":169,"key":314},"\u002Fhelp\u002Fwidget\u002Fwelcome-notification","Welcome notification","How to set a short message that encourages the customer to open the chat.","widget\u002Fwelcome-notification",{"path":316,"title":317,"description":318,"order":319,"key":320},"\u002Fhelp\u002Fconversations\u002Fclosing-a-conversation","Closing a conversation","How to mark finished conversations as resolved or unresolved, and why it matters.",3,"conversations\u002Fclosing-a-conversation",{"path":322,"title":323,"description":324,"order":319,"key":325},"\u002Fhelp\u002Fbot-configuration\u002Fhuman-support","Human support","How to configure handing conversations over to your team when the bot can't handle a question.","bot-configuration\u002Fhuman-support",{"path":327,"title":328,"description":329,"order":319,"key":330},"\u002Fhelp\u002Finstallation\u002Fwix","Installing on Wix","How to add the Fibly widget to a Wix site through the site settings panel.","installation\u002Fwix",{"path":332,"title":333,"description":334,"order":319,"key":335},"\u002Fhelp\u002Fwidget\u002Fnotification-sound","Notification sound","How to choose the audio cue the widget plays for the customer when new messages arrive.","widget\u002Fnotification-sound",{"path":337,"title":338,"description":339,"order":319,"key":340},"\u002Fhelp\u002Fgetting-started\u002Fquick-start","Quick start","A checklist for first launching the bot, from logging in to the first conversation.","getting-started\u002Fquick-start",{"path":342,"title":343,"description":344,"order":319,"key":345},"\u002Fhelp\u002Fbilling\u002Fteam-seats","Team seats","What the seat limit means, how to buy additional seats, and what happens when you exceed the limit.","billing\u002Fteam-seats",{"path":347,"title":348,"description":349,"order":319,"key":350},"\u002Fhelp\u002Fteam-and-account\u002Fuser-profile","User profile","How to change your first name, last name, and review your account details in the Fibly dashboard.","team-and-account\u002Fuser-profile",{"path":352,"title":353,"description":354,"order":319,"key":355},"\u002Fhelp\u002Fknowledge-base\u002Fmanually-written-article","Writing articles manually","How to write knowledge base articles in the Fibly editor, in visual or source mode.","knowledge-base\u002Fmanually-written-article",{"path":357,"title":358,"description":359,"order":360,"key":361},"\u002Fhelp\u002Fconversations\u002Fai-assist","AI assist for agents","How to generate a draft reply based on your knowledge base while handling a conversation.",4,"conversations\u002Fai-assist",{"path":363,"title":364,"description":365,"order":360,"key":366},"\u002Fhelp\u002Fteam-and-account\u002Fchanging-password","Changing your password","How to update the password for your Fibly account.","team-and-account\u002Fchanging-password",{"path":368,"title":369,"description":370,"order":360,"key":371},"\u002Fhelp\u002Fwidget\u002Fenabling-and-disabling","Enabling and disabling the widget","How to temporarily hide the chat button without removing the code from your site.","widget\u002Fenabling-and-disabling",{"path":373,"title":374,"description":375,"order":360,"key":376},"\u002Fhelp\u002Finstallation\u002Fprestashop","Installing on PrestaShop","How to install the official Fibly module in a PrestaShop store.","installation\u002Fprestashop",{"path":378,"title":379,"description":380,"order":360,"key":381},"\u002Fhelp\u002Fbilling\u002Finvoices","Invoices","Where to find your invoices, what their payment statuses mean, and how to download a PDF.","billing\u002Finvoices",{"path":383,"title":384,"description":385,"order":360,"key":386},"\u002Fhelp\u002Fbot-configuration\u002Fknowledge-base-context","Knowledge base context","How to set the depth of prerequisites the bot takes into account when answering.","bot-configuration\u002Fknowledge-base-context",{"path":388,"title":389,"description":390,"order":360,"key":391},"\u002Fhelp\u002Ftroubleshooting\u002Fno-email-notifications","No email notifications","What to check when you're not receiving escalation emails or the weekly summary.","troubleshooting\u002Fno-email-notifications",{"path":393,"title":394,"description":395,"order":360,"key":396},"\u002Fhelp\u002Fknowledge-base\u002Fpinning-articles","Pinning articles","How to choose up to three key articles that your Fibly bot reads before every answer.","knowledge-base\u002Fpinning-articles",{"path":398,"title":399,"description":400,"order":401,"key":402},"\u002Fhelp\u002Fbilling\u002Fchanging-plan","Changing your plan","How to move to a higher or lower plan in Fibly.",5,"billing\u002Fchanging-plan",{"path":404,"title":405,"description":406,"order":401,"key":407},"\u002Fhelp\u002Ftroubleshooting\u002Fconversation-not-in-live-support","Conversation not appearing in Live support","Diagnosing the situation where a customer asks for a human but the conversation doesn't reach the agent queue.","troubleshooting\u002Fconversation-not-in-live-support",{"path":409,"title":410,"description":411,"order":401,"key":412},"\u002Fhelp\u002Finstallation\u002Fsquarespace","Installing on Squarespace","How to embed the Fibly widget on a Squarespace site through the \"Code Injection\" section.","installation\u002Fsquarespace",{"path":50,"title":414,"description":415,"order":401,"key":416},"Prerequisites","How to link knowledge base articles into groups that your Fibly bot reads together.","knowledge-base\u002Fprerequisites",{"path":418,"title":419,"description":420,"order":421,"key":422},"\u002Fhelp\u002Fknowledge-base\u002Fcontent-quality","Content quality","How Fibly automatically assesses knowledge base articles and what each status means.",6,"knowledge-base\u002Fcontent-quality",{"path":424,"title":425,"description":426,"order":421,"key":427},"\u002Fhelp\u002Finstallation\u002Fdomain-verification","Domain verification","How to confirm that you own the domain where you're embedding the Fibly widget.","installation\u002Fdomain-verification",{"path":429,"title":430,"description":431,"order":421,"key":432},"\u002Fhelp\u002Finstallation\u002Fcustom-website","Installing on a custom website","How to embed the Fibly widget in plain HTML, Next.js, Nuxt, Vue, and React.","installation\u002Fcustom-website",{"path":434,"title":435,"description":436,"order":421,"key":437},"\u002Fhelp\u002Fteam-and-account\u002Fweekly-summary","Weekly summary","A weekly email with metrics on your bot's performance and improvement suggestions.","team-and-account\u002Fweekly-summary",{"path":185,"title":5,"description":179,"order":184,"key":181},{"path":440,"title":441,"description":442,"order":184,"key":443},"\u002Fhelp\u002Finstallation\u002Finstallation-verification","Installation verification","How to check that the Fibly widget works correctly after embedding it on your site.","installation\u002Finstallation-verification",{"path":445,"title":446,"description":447,"order":448,"key":449},"\u002Fhelp\u002Fgetting-started","Getting started","What Fibly is, how the bot works, and what to prepare before your first login.",10,"getting-started\u002Findex",{"path":451,"title":452,"description":453,"order":454,"key":455},"\u002Fhelp\u002Finstallation","Widget installation","How to embed the Fibly widget on your website. Ready-made instructions for the most popular platforms.",20,"installation\u002Findex",{"path":457,"title":458,"description":459,"order":460,"key":461},"\u002Fhelp\u002Fwidget","Widget","How to customize the appearance, content, and behavior of the chat widget on your website.",25,"widget\u002Findex",{"path":463,"title":464,"description":465,"order":466,"key":467},"\u002Fhelp\u002Fknowledge-base","Knowledge base","How to build and maintain the knowledge base your Fibly bot draws its answers from.",30,"knowledge-base\u002Findex",{"path":469,"title":122,"description":470,"order":471,"key":472},"\u002Fhelp\u002Fconversations","How to browse, filter, and analyze customer conversations with the bot and your team.",35,"conversations\u002Findex",{"path":164,"title":474,"description":475,"order":476,"key":477},"Bot configuration","How to set the brand, tone of voice, escalation behavior, and answer context for the Fibly bot.",40,"bot-configuration\u002Findex",{"path":479,"title":480,"description":481,"order":482,"key":483},"\u002Fhelp\u002Flive-support","Live support","How to handle conversations waiting for an agent, take them over from the bot, and end them.",45,"live-support\u002Findex",{"path":485,"title":486,"description":487,"order":488,"key":489},"\u002Fhelp\u002Fanalytics","Analytics","How to read the metrics and charts about your bot's and your team's work in the Fibly panel.",50,"analytics\u002Findex",{"path":491,"title":492,"description":493,"order":494,"key":495},"\u002Fhelp\u002Fcustomers","Customers","How to view and manage the profiles of people who have talked to the bot on your website.",55,"customers\u002Findex",{"path":497,"title":498,"description":499,"order":500,"key":501},"\u002Fhelp\u002Fteam-and-account","Team and account","How to manage team members, roles, your own profile, and access security.",60,"team-and-account\u002Findex",{"path":503,"title":504,"description":505,"order":506,"key":507},"\u002Fhelp\u002Fbilling","Billing","How plans, AI credits, team seats, and invoices work in Fibly.",65,"billing\u002Findex",{"path":509,"title":510,"description":511,"order":512,"key":513},"\u002Fhelp\u002Ftroubleshooting","Troubleshooting","Diagnosing the most common issues with the widget and the Fibly dashboard.",999,"troubleshooting\u002Findex",1782382441818]