{"versionId":"3be5f23a-e298-4d31-8a19-08de86ffd947","articleId":"1e7b05ad-4bed-45e2-97c5-08dad11575da","title":"Creating and managing Q&A","tags":["Q&A","chatbot basics","All articles"],"content":"<html><head></head><body><div class=\"mce-toc\">\n<h2>Table of Contents</h2>\n<ul>\n<li><a href=\"#mcetoc_1gj0i5ondkk\">Adding questions and answers</a>\n<ul>\n<li><a href=\"#mcetoc_1gj0n0ci713l\">Follow-up questions</a></li>\n<li><a href=\"#mcetoc_1gj0i5ondkn\">Question variants and display questions</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1gj0iinvmlb\">Adding tags to organise your knowledge</a></li>\n<li><a href=\"#mcetoc_1gj0jivuns3\">Tips for writing Q&amp;A for chat</a></li>\n<li><a href=\"#mcetoc_1gj0n28sh13n\">Save, train and publish your Q&amp;A - step by step</a>\n<ul>\n<li><a href=\"#mcetoc_1gj0jln5vs7\">Step 1 - save</a></li>\n<li><a href=\"#mcetoc_1gj0jn1nlsi\">Step 2 - train</a></li>\n<li><a href=\"#mcetoc_1gj0jn1nlsj\">Step 3 - test</a></li>\n<li><a href=\"#mcetoc_1gj0jn1nlsk\">Step 4 - publish</a></li>\n<li><a href=\"#mcetoc_1gj0jn1nlsl\">Step 5 - improve</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1gj0jivuns5\">What else?</a></li>\n</ul>\n</div>\n<p>Your Helpfruit chatbot is built on a library of question and answer pairs. To start building a chatbot, you just need to start adding questions and answers in the Helpfruit portal. It’s fast and easy and in this article we'll show you how ✅</p>\n<h2 id=\"mcetoc_1gj0i5ondkk\">Adding questions and answers</h2>\n<ol>\n<li>Log in to the Helpfruit portal and navigate to <a title=\"QnA management\" href=\"https://portal.helpfruit.com/knowledge/qna\">Knowledge &gt; Q&amp;A</a>.</li>\n<li>Use the green button <strong>New Entry</strong>&nbsp;to enter new question and answer pairs</li>\n</ol>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_d6926a00-6bb7-4300-9493-f82366583f85.png\"></div>\n<p>&nbsp;</p>\n<p>Answers&nbsp;can be:</p>\n<ul role=\"list\">\n<li>Rich text (which can also contain images, animated gifs and emojis).</li>\n<li>Video - YouTube videos on web chatbots and Facebook video for Messenger bots. (Note videos are not supported in Teams due to Teams restrictions, and display differently in the chat on <a href=\"https://help.helpfruit.com/article/bot-features-whats-app#mcetoc_1hgcdtvgfaq0\">WhatsApp</a> and <a href=\"https://help.helpfruit.com/article/bot-features-instagram#mcetoc_1hgp8nmum5in\">Instagram</a>).</li>\n<li>A form. The form must be set up and published first (via <a title=\"Create form\" href=\"https://portal.helpfruit.com/actions/forms\">Actions &gt; Forms</a>)</li>\n</ul>\n<h3 id=\"mcetoc_1gj0n0ci713l\">Follow-up questions</h3>\n<p>Questions and answers can be linked using follow-up questions, to provide a next step or additional context. A question needs to be added before it can be linked as a follow up.&nbsp;</p>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_9cb47066-7d48-43ed-bf55-376bf5992938.png\"></div>\n<p>&nbsp;</p>\n<p>Note: we recommend a maximum of 3 follow up questions per Q&amp;A pair.</p>\n<p><strong>Follow up questions</strong>&nbsp;are shown as buttons below the answer in the bot:</p>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_c594643d-77f6-44e4-abef-c023123edfb0.png\"></div>\n<p>&nbsp;</p>\n<p>The user can then click one of those buttons (follow up question) to continue the conversation. &nbsp;</p>\n<p>Follow-ups help the conversation flow, and research shows people prefer to use buttons than type.</p>\n<h3 id=\"mcetoc_1gj0i5ondkn\">Question variants and display questions</h3>\n<p>To improve the likelihood of a match with a user’s question, you can add alternate versions of your question.</p>\n<p>You don’t need to think of every possible variant, but it can be good to start with a couple, especially when there are known synonyms or related terms (eg “get a job”, “work for you\").</p>\n<p>You can monitor user behaviour in <a title=\"Q&amp;A insights\" href=\"https://portal.faqbot.nz/insights/qna\">Helpfruit insights</a>, to see the the actual questions users are asking. This will provide ideas for new questions and new alternate questions.</p>\n<p>If you have multiple question variants, choose a&nbsp;<a href=\"https://www.faqbot.ai/post/new-feature-display-question\" target=\"_blank\" rel=\"noopener\">display question</a> – your preferred variant of that question. This is the variant that will be shown when your bot is not confident of the match.</p>\n<p><img src=\"https://portal.faqbot.nz/api/images/079d861d72cc4aca80c65588df217079/files/Variants%20and%20display%20questions.png\" width=\"456\" height=\"622\"></p>\n<h3>Use FAQ Wizard to fast-track Q&amp;A creation</h3>\n<p>You can also use FAQ Wizard to generate questions and answers from existing web pages or text-based files, ready to import into Helpfruit.<br><a href=\"https://help.helpfruit.com/article/how-to-import-faq-from-faq-wizard\" target=\"_blank\" rel=\"noopener\">Learn more about Wizard</a>.</p>\n<p>&nbsp;</p>\n<h2 id=\"mcetoc_1gj0iinvmlb\">Adding tags to organise your knowledge</h2>\n<p>Add <a href=\"https://help.helpfruit.com/article/using-tags\" target=\"_blank\" rel=\"noopener\">tags</a> to categorise and organise your Q&amp;A. Tags in Helpfruit provide a flexible system that can be used to:</p>\n<ul>\n<li>support your workflow (eg label questions for review)</li>\n<li>link questions and answers to articles</li>\n<li>group related questions and answers for findability and easy maintenance</li>\n<li>trigger engagements</li>\n<li>control display on <a href=\"https://help.helpfruit.com/article/help-pages\" target=\"_blank\" rel=\"noopener\">Help Pages</a></li>\n</ul>\n<p>Tags are not visible in the bot, but can be displayed on articles and pages.</p>\n<h2 id=\"mcetoc_1gj0jivuns3\">Tips for writing Q&amp;A for chat</h2>\n<p>Each question should be focused on a&nbsp;<strong>single specific topic</strong>.</p>\n<p>If your questions are general, or your answers are long/multi-part, break them down into specific question and answer pairs to clarify intent, simplify and direct the conversation.</p>\n<p>You can also use articles (like this one) to give a more detailed answer to a question.</p>\n<p>We recommend no more than three short paragraphs per answer (~300 characters). Longer answers are ok sometimes, but shorter answers are generally better because:</p>\n<ul role=\"list\">\n<li>They are easier to understand and translate</li>\n<li>The chat window is small</li>\n<li>It’s a conversation, not a monologue</li>\n</ul>\n<p>Consider your bot’s personality and principles of conversation design when writing and editing your questions and answers:</p>\n<ul role=\"list\">\n<li>Answer the question directly and concisely</li>\n<li>Be factual</li>\n<li>Don’t overload the user with information – one (conversational) step at a time</li>\n<li>Be careful to stick to the tone of voice you have decided on and don’t overdo the exclamation marks \uD83D\uDE09</li>\n</ul>\n<p>You don't know how a question will be asked, so</p>\n<ul>\n<li>Don't answer a question with yes (or no) - as it may not make sense</li>\n<li>Try to include a bit of context in the answer - as answers are also used for matching</li>\n</ul>\n<h2 id=\"mcetoc_1gj0n28sh13n\">Save, train and publish your Q&amp;A - step by step</h2>\n<h3 id=\"mcetoc_1gj0jln5vs7\">Step 1 - save</h3>\n<p>Remember to Save Changes when working with Q&amp;A</p>\n<p>You’ll get a prompt if you try to leave without saving:</p>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_d82b1f0c-88e6-4a84-bfa5-94d25e7735a5.png\"></div>\n<p>&nbsp;</p>\n<h3 id=\"mcetoc_1gj0jn1nlsi\">Step 2 - train</h3>\n<p>Training your Q&amp;A – may take a few seconds. You can do this directly via the Train button in Q&amp;A or in<a title=\"Version history\" href=\"https://portal.helpfruit.com/configuration/qna-version-history\"> Configuration &gt; Q&amp;A Version history</a></p>\n<p>You have a record here of previously published versions:</p>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_90810b78-5dc6-4e2f-bd4b-8c93fc238310.png\"></div>\n<p>&nbsp;</p>\n<p>You can label the version which can be helpful if you want to know what the changes were. You can also restore an old version using this screen if you need to.</p>\n<h3 id=\"mcetoc_1gj0jn1nlsj\">Step 3 - test</h3>\n<p>Once you have saved and trained, you can, if you wish, preview your knowledge base changes on the <a title=\"Test QnA\" href=\"https://portal.helpfruit.com/test-and-preview/qna\">Test Q&amp;A screen</a></p>\n<p><em>Note: This feature only tests knowledge base answers, and uses the most recently trained version of your knowledge base. Multi-language and web search results can’t be tested here.</em></p>\n<p>Before you go live with your new bot, you can also use and share your <a href=\"https://portal.helpfruit.com/test-and-preview/bot\">bot preview</a> to get feedback from your wider team, and test all features of the conversation.</p>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_94439283-4006-4a8e-b425-5b3499b21d26.png\"></div>\n<p>&nbsp;</p>\n<h3 id=\"mcetoc_1gj0jn1nlsk\">Step 4 - publish</h3>\n<p>Happy with how things look? You're ready to publish – either directly from QnA or via <a title=\"Version history\" href=\"https://portal.helpfruit.com/configuration/qna-version-history\">&nbsp;Configuration &gt; Q&amp;A Version history</a></p>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_fc08b02e-d470-44ef-913b-ee91a7636f98.png\"></div>\n<p>&nbsp;</p>\n<p><em>Note that the publish button will only be available when there is a trained version of your knowledge base that has not yet been published.</em></p>\n<p><em>When you select publish, you'll get the option to select everything for publishing, or just a selection of questions:</em></p>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_creating-and-managing-q-a_549a9a33-7d00-4969-9729-a1549d6039cd.png\"></div>\n<p>&nbsp;</p>\n<h3 id=\"mcetoc_1gj0jn1nlsl\">Step 5 - improve</h3>\n<p>To refine your bot based on user questions, use the <a href=\"https://portal.helpfruit.com/insights/qna\" target=\"_blank\" rel=\"noopener\">Q&amp;A Insights</a> tab.&nbsp;</p>\n<h2 id=\"mcetoc_1gj0jivuns5\">What else?</h2>\n<p>Have a look at setting up a <a href=\"https://help.helpfruit.com/article/engagements\" target=\"_blank\" rel=\"noopener\">welco</a><a href=\"https://help.faqbot.ai/article/engagements\" target=\"_blank\" rel=\"noopener\">me engagemen</a>t to help get the conversation started and using&nbsp;<a href=\"https://help.helpfruit.com/article/forms\" target=\"_blank\" rel=\"noopener\">forms</a> to capture data.</p>\n<p>&nbsp;</p></body></html>","description":"Your Helpfruit chatbot is built on a library of question and answer pairs. This is the first place the chatbot looks for answers.","isMarkdown":false,"publishedOnUtc":"2026-03-21T04:54:18.7765317","modifiedOnUtc":"2022-11-29T01:34:18.331604"}