{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"d027cb57-b39f-4edd-ae9a-76eddab382eb"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"9d7dc4ed-9fe6-4efc-8d89-d64fab2ba7d3"}},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introduction","type":"text","marks":[{"type":"textColor","attrs":{"color":"#001f60"}}]}]},{"type":"paragraph","content":[{"text":"The purpose of Consult Direct is to provide a self-guided process to find an offer & cover a commercial risk. The flow can be easily added to a 3rd party website via a new (sub)domain.","type":"text"}]},{"type":"paragraph","content":[{"text":"Consult Direct is a ReactJS-based single-page application (SPA) that can be embedded in your website.","type":"text"}]},{"type":"paragraph","content":[{"text":"For any questions or feedback, please don't hesitate to reach out to your Thinksurance key contact person.","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Base Information","type":"text","marks":[{"type":"textColor","attrs":{"color":"#001f60"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Route Implementation - Where can consult direct be located?","type":"text","marks":[{"type":"textColor","attrs":{"color":"#001f60"}}]}]},{"type":"paragraph","content":[{"text":"Consult Direct can only run in the root path of your application. It will update the URL depending on the route that you go while using it.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define a Domain where you want to run Consult Direct in.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure the Route for Consult Direct is not equal to a route of your application.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"text":"https://example.com/inquiry/b3eb12af-8ab7-11ed-93a6-","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#0362c1"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#0362c1"}}]},{"text":"7a2497390288","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#0362c1"}},{"type":"link","attrs":{"href":"https://example.com/inquiry/b3eb12af-8ab7-11ed-93a6-7a2497390288"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Route /inquiry comes from the consult direct, and we must be sure that does not exist in your application.","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Best practice: ","type":"text","marks":[{"type":"strong"}]},{"text":"we recommend using a subdomain reserved for Consult Direct. In this case, only Consult Direct routes exist.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"text":"https://consultdirect.example.com/inquiry/b3eb12af-8ab7-11ed-","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#0362c1"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#0362c1"}}]},{"text":"93a6-7a2497390288","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#0362c1"}},{"type":"link","attrs":{"href":"https://consultdirect.example.com/inquiry/b3eb12af-8ab7-11ed-93a6-7a2497390288"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure you have Tag in the top of your HTML document.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This ensures that the browser follows the most up-to-date web standards, rather than using quirks mode, a different rendering mode that is incompatible with some of the technology used.","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"What will not work?","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Reserve the route for the consult direct /consult-direct will not work, because in this case ","type":"text"},{"text":"Consult Direct is not aware of the reserved route.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#313d4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"text":"https://example.com/consult-direct/inquiry/b3eb12af-8ab7-11ed-93a6-7a2497390288","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#0362c1"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Routing Rewrites - How to ensure a consitent user flow?","type":"text","marks":[{"type":"textColor","attrs":{"color":"#001f60"}}]}]},{"type":"paragraph","content":[{"text":"Consult Direct is built as a single-page app and doesn't require server routing. Therefore, the routes don't exist in your application. This can lead to issues when the user refreshes the page in their browser. Since your application will not know about the paths used in Consult Direct, it will return an HTTP 404 Not Found error.","type":"text"}]},{"type":"paragraph","content":[{"text":"To prevent this, implement a route rewrite functionality that will tell the app that the destination for all Consult Direct routes is the root path.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example NextJS (next.config.js):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"async rewrites() {\n return [\n {\n source: '/:path*',\n destination:'/',\n },\n ];\n},","type":"text"}]},{"type":"paragraph","content":[{"text":"Please look into the documentation for your specific server framework on how to do URL rewrites.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#313d4d"}}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Implementation","type":"text","marks":[{"type":"textColor","attrs":{"color":"#001f60"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Environments for Implementation","type":"text","marks":[{"type":"textColor","attrs":{"color":"#001f60"}}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"During implementation you can choose between 2 environments: Production and Pre production. We suggest starting on Pre-prod until you are certain everything works as expected.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"To get Consult Direct embedded in your site:","type":"text"}]},{"type":"paragraph"},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add a div HTML element on the HTML page where you want to render Consult Direct.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"\"root\" ","type":"text","marks":[{"type":"strong"}]},{"text":"is the ","type":"text"},{"text":"\"renderld\" ","type":"text","marks":[{"type":"strong"}]},{"text":"option available in the config.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Include the code bundle","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Load the code bundle containing Consult Direct.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pre-Prod: ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"\n \n \n","type":"text"}]}],"version":1}

Browser not supported