{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Welcome to the guide on integrating deeplinks to Unique Chat from your application. This document will help you understand how to construct URLs that allow users to seamlessly access specific spaces and execute prompts within the chat app, enhancing their overall experience.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Table of Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"default"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"95fdf7a8-b789-4153-9ac2-33b6130776ce"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"9a5eb8ef-8fec-4323-b717-1d340f74f85b"}},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"Integrating deeplinks to [Chat App] from your internal services allows users to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access Specific Spaces","type":"text","marks":[{"type":"strong"}]},{"text":": Automatically select a chat space upon opening the app.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute Specific Prompts","type":"text","marks":[{"type":"strong"}]},{"text":": Run predefined commands or messages in the chat window.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This integration streamlines the user experience by providing direct and contextually relevant access to conversations or functionalities within the chat app.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Deeplink URL Structure","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Multitenant Region URLs"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"205efdf0-a05e-4957-b744-f80f752d55e9"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"967c680c-d82e-48e9-94f1-378bf386a5c4"}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Customized App Name","type":"text"}]},{"type":"paragraph","content":[{"text":"Each customer has a unique, customized app name as part of the base URL:","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://.unique.app/","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":": The customized application name assigned to your organization (e.g., ","type":"text"},{"text":"next","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"URL Path and Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"To deeplink into a specific space and execute a prompt, use the following URL structure:","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://.unique.app/chat/space/?prompt=","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Components","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Base URL","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"https://.unique.app/","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"/chat/space/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":": The unique identifier of the chat space (e.g., ","type":"text"},{"text":"assistant_xt656gn52wp97rtk4opo5i3n","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Query Parameter","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"?prompt=","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":": The prompt or command to execute in the chat window, URL-encoded.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Notes","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"space_id","type":"text","marks":[{"type":"code"}]},{"text":" typically starts with ","type":"text"},{"text":"assistant_","type":"text","marks":[{"type":"code"}]},{"text":" followed by an alphanumeric string.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"prompt","type":"text","marks":[{"type":"code"}]},{"text":" parameter is optional. If omitted, the chat app will open the specified space without executing any prompt.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Handling Authentication","type":"text"}]},{"type":"paragraph","content":[{"text":"When users are not logged in to [Chat App], the deeplink will still work seamlessly after authentication:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User Clicks Deeplink","type":"text","marks":[{"type":"strong"}]},{"text":": The user clicks the deeplink URL from your application.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Authentication Check","type":"text","marks":[{"type":"strong"}]},{"text":": The chat app checks if the user is authenticated.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Authenticated","type":"text","marks":[{"type":"strong"}]},{"text":": Proceeds to the specified space and executes the prompt.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Not Authenticated","type":"text","marks":[{"type":"strong"}]},{"text":": Redirects the user to the login page.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Post-Login Redirect","type":"text","marks":[{"type":"strong"}]},{"text":": After successful login, the user is redirected back to the original deeplink URL with all parameters preserved.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": You do not need to manage tokens or session data; the chat app handles the authentication flow internally.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Implementation Steps","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Obtain Your App Name","type":"text","marks":[{"type":"strong"}]},{"text":": Confirm your customized app name provided by [Chat App] (e.g., ","type":"text"},{"text":"next","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Identify the Target Space","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Obtain the ","type":"text"},{"text":"space_id","type":"text","marks":[{"type":"code"}]},{"text":" for the desired chat space.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This can be retrieved from your chat app administrator or support team.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define the Prompt (Optional)","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the ","type":"text"},{"text":"prompt","type":"text","marks":[{"type":"code"}]},{"text":" parameter value for any prompt you wish to execute.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure the prompt is URL-encoded to handle special characters.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Construct the Deeplink URL","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Combine the base URL, path, and query parameters as per the structure outlined above.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Integrate into Your Application","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Embed the constructed URL in your application's interface where users can click or be redirected.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example 1: Open a Specific Space","type":"text"}]},{"type":"paragraph","content":[{"text":"Objective","type":"text","marks":[{"type":"strong"}]},{"text":": Direct users to a chat space with the ID ","type":"text"},{"text":"assistant_abc123xyz","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Customized App Name","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"next","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Deeplink URL","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://next.unique.app/chat/space/assistant_abc123xyz","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example 2: Open a Space and Execute a Prompt","type":"text"}]},{"type":"paragraph","content":[{"text":"Objective","type":"text","marks":[{"type":"strong"}]},{"text":": Open the space ","type":"text"},{"text":"assistant_def456uvw","type":"text","marks":[{"type":"code"}]},{"text":" and execute the prompt \"Check system status\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Customized App Name","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"next","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Prompt","type":"text","marks":[{"type":"strong"}]},{"text":": \"Check system status\"","type":"text"}]},{"type":"paragraph","content":[{"text":"URL-Encoded Prompt","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"Check%20system%20status","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Deeplink URL","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://next.unique.app/chat/space/assistant_def456uvw?prompt=Check%20system%20status","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example 3: User Not Logged In","type":"text"}]},{"type":"paragraph","content":[{"text":"When a non-authenticated user clicks the deeplink:","type":"text"}]},{"type":"paragraph","content":[{"text":"Deeplink URL","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://next.unique.app/chat/space/assistant_ghi789rst?prompt=View%20latest%20reports","type":"text"}]},{"type":"paragraph","content":[{"text":"Flow","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User is redirected to the login page.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upon successful login, the user is taken directly to ","type":"text"},{"text":"assistant_ghi789rst","type":"text","marks":[{"type":"code"}]},{"text":" space.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The prompt \"View latest reports\" is executed automatically.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Best Practices","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"URL Encoding","type":"text","marks":[{"type":"strong"}]},{"text":": Always URL-encode the ","type":"text"},{"text":"prompt","type":"text","marks":[{"type":"code"}]},{"text":" parameter to handle spaces and special characters.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the standard encoding for modern browsers as the prompt.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parameter Validation","type":"text","marks":[{"type":"strong"}]},{"text":": Verify that the ","type":"text"},{"text":"space_id","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"prompt","type":"text","marks":[{"type":"code"}]},{"text":" are correct and properly formatted.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Avoid Sensitive Data in URLs","type":"text","marks":[{"type":"strong"}]},{"text":": Do not include confidential information in the URL parameters.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User Communication","type":"text","marks":[{"type":"strong"}]},{"text":": Inform users that they might need to log in to access the chat app.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Frequently Asked Questions","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Q1: How do I find my ","type":"text"},{"text":"space_id","type":"text","marks":[{"type":"code"}]},{"text":"?","type":"text"}]},{"type":"paragraph","content":[{"text":"A","type":"text","marks":[{"type":"strong"}]},{"text":": Contact your [Chat App] administrator or support team to obtain the ","type":"text"},{"text":"space_id","type":"text","marks":[{"type":"code"}]},{"text":" for the desired chat space.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Q2: What happens if the ","type":"text"},{"text":"space_id","type":"text","marks":[{"type":"code"}]},{"text":" is invalid?","type":"text"}]},{"type":"paragraph","content":[{"text":"A","type":"text","marks":[{"type":"strong"}]},{"text":": The chat app will display an error message or redirect the user to a default space.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Q3: Can we use this deeplink mechanism for mobile applications?","type":"text"}]},{"type":"paragraph","content":[{"text":"A","type":"text","marks":[{"type":"strong"}]},{"text":": Yes, as long as the mobile application supports opening web URLs.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Q4: Is there a character limit for the ","type":"text"},{"text":"prompt","type":"text","marks":[{"type":"code"}]},{"text":" parameter?","type":"text"}]},{"type":"paragraph","content":[{"text":"A","type":"text","marks":[{"type":"strong"}]},{"text":": While there is no strict limit, it's advisable to keep URLs under 2000 characters for maximum browser compatibility.","type":"text"}]},{"type":"paragraph"},{"type":"rule"},{"type":"table","attrs":{"layout":"default","width":633.0,"localId":"6323a696-9107-4db3-837d-a4bb801dea5b"},"marks":[{"type":"fragment","attrs":{"name":"Table 5","localId":"24efb372-9919-45c4-a805-ed04f4ab88a9"}}],"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[110.0]},"content":[{"type":"paragraph","content":[{"text":"Author","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"type":"mention","attrs":{"id":"712020:1f4be163-056c-488c-b819-d7e19f94302c","localId":"27c7f52a-fbfa-40de-8771-8ab3389a7092","text":"@Chilo Nwokolo"}},{"text":" ","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported