{"versionId":"b64d3f1f-9109-4d9a-e64f-08de86ffa464","articleId":"ff8c86ca-e006-4fd6-8f11-08dcb107469a","title":"Collect details before a live chat conversation","tags":["context","engagements","forms","live chat","All articles"],"content":"<html><head></head><body><p>Do you want to collect a person's name or other details before handing the conversation to an agent for live chat?</p>\n<p>This is possible in Helpfruit, using a combination of <a href=\"https://help.helpfruit.com/article/using-your-bot-to-collect-feedback\" target=\"_blank\" rel=\"noopener\">context</a>, <a href=\"https://help.helpfruit.com/article/engagements\" target=\"_blank\" rel=\"noopener\">engagements</a> and <a href=\"https://help.helpfruit.com/article/forms\" target=\"_blank\" rel=\"noopener\">forms</a>. Here's how to build the flow.</p>\n<div class=\"mce-toc\">\n<h2>&nbsp;</h2>\n<ul>\n<li><a href=\"#mcetoc_1i43bic532qf\">Step one: set up context keys</a></li>\n<li><a href=\"#mcetoc_1i43bic532qg\">Step two: set up context collection form</a></li>\n<li><a href=\"#mcetoc_1i43bic532qh\">Step three: set up first engagement&nbsp;</a></li>\n<li><a href=\"#mcetoc_1i43bic532qi\">Step four: add live chat button</a>\n<ul>\n<li><a href=\"#mcetoc_1i43bomc72te\">Engagement event </a></li>\n<li><a href=\"#mcetoc_1i43bomc72tf\">Context collection form&nbsp;</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1i43bic532qj\">Step five: set up a post-form engagement</a></li>\n</ul>\n</div>\n<h2 id=\"mcetoc_1i43bic532qf\">Step one: set up context keys</h2>\n<p>Decide the details you would like to collect from your users before initiating live chat. Set these up as <a href=\"https://help.helpfruit.com/article/using-context\" target=\"_blank\" rel=\"noopener\">context keys</a>.</p>\n<h2 id=\"mcetoc_1i43bic532qg\">Step two: set up context collection form</h2>\n<ol>\n<li>In Forms, click New Form and select Context collection form - Template</li>\n</ol>\n<p><div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_collect-details-before-a-live-chat-conversation_15acfa42-7914-4c38-9493-c61125a2364e.png\"></div></p>\n<p>2. Give your form a name.</p>\n<p>3. Set up your welcome and completed responses to suit.</p>\n<p><div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_collect-details-before-a-live-chat-conversation_8351ab12-f9be-4880-91ff-95fdbd2e32f4.png\"></div></p>\n<p>4. Add question/s to collect the information you need. Make sure that they match existing context keys</p>\n<p><div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_collect-details-before-a-live-chat-conversation_d8f8411f-c288-481b-8f61-8f2c8d751419.png\"></div></p>\n<p>Save your form and make sure it's set to Publish.</p>\n<h2 id=\"mcetoc_1i43bic532qh\">Step three: set up first engagement&nbsp;</h2>\n<p>How will live chat be prompted? Create an <a href=\"https://help.helpfruit.com/article/engagements\" target=\"_blank\" rel=\"noopener\">engagement</a> for this scenario.</p>\n<p>In this example, the user will see the Live chat button when the&nbsp;chatbot can't answer a question:</p>\n<p><div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_collect-details-before-a-live-chat-conversation_78fb3bab-bc4e-4b82-b5aa-4533ab981ded.png\"></div></p>\n<h2 id=\"mcetoc_1i43bic532qi\">Step four: add live chat button</h2>\n<p>Add a live chat button to the engagement you've just set up.</p>\n<p>You have a couple of options here for the button:</p>\n<ol>\n<li>\n<h3 id=\"mcetoc_1i43bomc72te\">Engagement event<strong><div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_collect-details-before-a-live-chat-conversation_af75bb4d-5eb9-41c8-946b-2c9e2afbeed3.png\"></div><br></strong></h3>\nThis engagement event can then trigger an intermediary pair of engagements - one which will fire during live chat hours (if you have a&nbsp;<a href=\"https://help.helpfruit.com/article/schedules\" target=\"_blank\" rel=\"noopener\">schedule</a> set up) and another outside of live chat hours. For example:<br><div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_collect-details-before-a-live-chat-conversation_6b3e780d-0779-45f7-b80b-56b4f97fa070.png\"></div></li>\n<li>\n<h3 id=\"mcetoc_1i43bomc72tf\">Context collection form&nbsp;</h3>\nIn this scenario the button will directly trigger the form you set up in Step two above<br><div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_collect-details-before-a-live-chat-conversation_63353f6b-8a89-4467-8d8f-9ba42c4fa79c.png\"></div></li>\n</ol>\n<h2 id=\"mcetoc_1i43bic532qj\">Step five: set up a post-form engagement</h2>\n<p>Create a new engagement:</p>\n<ol>\n<li>Name your engagement - e.g. Live chat after details form</li>\n<li>When will engagement appear? - select \"After Form Completed\"</li>\n<li>Specify your Context collection form</li>\n<li>Type - select \"Trigger live chat\"</li>\n</ol>\n<p>Now, when an agent gets a new live chat, any details collected ahead of the chat will be pre-populated in the Conversation information section of the live chat screen.<br><img src=\"https://portal.helpfruit.com/api/images/079d861d72cc4aca80c65588df217079/files/live%20chat%20context.png\"></p>\n<p>&nbsp;</p></body></html>","description":"How to collect a person's name and other details before handing the conversation to an agent","isMarkdown":false,"publishedOnUtc":"2026-03-21T05:01:46.7522374","modifiedOnUtc":"2024-07-31T02:19:58.702001"}