<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the LapSafe Integration?</strong></p><p><strong>- Enabling the LapSafe Integration</strong></p><p><strong>- Configuring the Integration</strong></p><p><strong>- Creating Actions</strong></p><p><strong>- Using LapSafe in Halo</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the LapSafe Integration?</span></strong></p><p>The LapSafe integration can be used to organise locker bays and their corresponding codes for drop-off, collection and swaps. Codes and locations can be emailed out to the user to open the lockers.</p><p><br></p><p><strong><span style="font-size: 14pt;">Enabling the LapSafe Integration</span></strong></p><p>In Configuration > Integrations > Asset Management and Alerting, hover over "LapSafe" and press the "plus" icon to enable the module.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFjNGE0YjJlLWNlMWQtNGEwYS1iMTgwLTE1MjVkZDBlM2Q4ZCJ9.uNr6SCxwYBoOJTBKJt1ttrhkwFmuahqG8gU1VusWX0U" class="fr-fic fr-fil fr-dib" width="1005" style="width: 1007px; height: 578.533px;" height="579"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the LapSafe integration</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Configuring the Integration</span></strong></p><p><strong><span style="font-size: 12pt;">Configuration tab</span></strong></p><p>Click into the module and you will see this screen.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNmMjA4MjBjLTVmOWUtNGQwMy05MzIxLTRlMjkyOGU5NTk2ZCJ9.nPjyJbVXqWIsauyHqvm2s6NbSBfxolJR6LvmdXOw0zM" class="fr-fic fr-fil fr-dib" width="1006" style="width: 1008px; height: 309.844px;" height="310"></p><p><strong><span style="font-size: 10pt;">Fig 2. Entering LapSafe tenant details</span></strong></p><p><br></p><p>Here, enter your LapSafe/ONARKEN URL and an API token. The token can be found in LapSafe within "My Profile" > "API Tokens", and click "New personal access token". The token will then appear in the green bar above, copy this into the field.</p><p><br></p><p><em><strong>Note: ONARKEN tokens have a number and a straight slash at the start, (i.e. </strong></em><strong>1</strong><strong>|_____</strong><em><strong>, </strong></em><strong>2</strong><strong>|_______</strong><em><strong>), do not include this first part when copying.</strong></em></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFkNjIxZjAxLTFhYmQtNGJiMC05ZDQ1LTIxMTQxZGQ3NDZlMiJ9.d_wbn2Dxl98x6JWqMBIVWUhHVLQAwP8NMGBK8HAifeI" class="fr-fic fr-fil fr-dib" width="989" style="width: 991px; height: 484.374px;" height="484"></p><p><strong><span style="font-size: 10pt;">Fig 3. Getting the API token from LapSafe</span></strong></p><p><br></p><p>You can then click the "Test Configuration" button. If the credentials are correct, it will say "Test successful", and you can continue to configure.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZmZTdmODk0LThkMjgtNDU2YS1iMTY5LWRiMWE2Y2ZlMjA3YyJ9.4yIB0-2tBrWZ1RMil1V_CArMrqgr3eSFA9CsIQ1W-xk" class="fr-fic fr-fil fr-dib" width="994" style="width: 996px; height: 486.044px;" height="486"></p><p><strong><span style="font-size: 10pt;">Fig 4. Testing LapSafe configuration</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Defaults tab</span></strong></p><p>In the "Defaults" tab, you can then configure the default configuration used for the integration, such as which installation and bay size.</p><p><br></p><p>Actions will need to be configured to use these, this will be covered in the next section of this guide.</p><p><br></p><p>From v2,236+, you can prevent User information from being sent to LapSafe by selecting the "Do not send User information to LapSafe" checkbox.</p><p><br></p><p>There are also email templates used when setting the asset drop off, collection and swap. By default, pre-made ones are set here, but these can be changed if you wish.</p><p><br></p><p><strong><em>Note: If using your own templates, make sure to include the $-LOCKERNAME and $-LOCKERCODE variables, as these are what will be populated with the information when sending the email.</em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM0MzhjODE5LTMwMjctNDE2NS1iZWJmLWU2NzY3ZDc3MmM2MSJ9.iPBtgwSO3l--ps5gvqrn4T4NxJNcUsigJBKVee-6kiY" class="fr-fic fr-fil fr-dib" width="998" style="width: 1000px; height: 438.191px;" height="438"></p><p><strong><span style="font-size: 10pt;">Fig 5. Defaults tab</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Webhooks tab</span></strong></p><p>In the "Webhooks" tab, you can put a secret for webhook creation if you wish LapSafe to automatically update. This can be configured in "Settings" > "Webhooks" in your LapSafe tenant.</p><p><br></p><p>From v2.236+, you can set a default status for Drop off and Collection expiry. This can be overridden per Ticket Type. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjgyZTI0NWFlLTZjZDQtNDg1Yy1hOWM4LThlZjk3NDhiYjU1MSJ9.AXed8bWg5Cv8gNWnp3EXj0Jft95eRFEdhW_qMKs9Zb0" class="fr-fic fr-fil fr-dib" width="1001" style="width: 1003px; height: 283.544px;" height="284"></p><p><strong><span style="font-size: 10pt;">Fig 6. Webhooks tab</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Creating Actions</span></strong></p><p>Actions with LapSafe-specific system uses need to be created for the drop-off/collection.</p><p><br></p><p>First, create an action for the drop-off function. Use the "Create Drop Off" system use, and set either a default installation or set to choose one when using.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAyN2E2NTQ3LWQzNDYtNGEwZi1iZDYwLTAzOTNlYmEwMTBiNyJ9.jptthrPUpR8o9kxn4LhbeTOrmk5mNVb4es7-znTJ-EU" class="fr-fic fr-fil fr-dib" width="996" style="width: 998px; height: 485.165px;" height="485"></p><p><strong><span style="font-size: 10pt;">Fig 7. Create Drop Off action</span></strong></p><p><br></p><p>Next, create an action with the "Create Collection" system use, and also set if you wish to use a default installation.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk5YjEyNzAxLTVlZGQtNGUxNS1iNjY2LWU5Zjc4NzY1MTg0OSJ9.2O81erhqdmRfqCl6NkqWXFW5E8Dmjor9DDyfXZdYf5E" class="fr-fic fr-fil fr-dib" width="994" style="width: 996px; height: 531px;" height="531"></p><p><strong><span style="font-size: 10pt;">Fig 8. Create Collection action</span></strong></p><p><br></p><p>Finally, create an action with the "Create Swap" system use if you use this function, and once again if a default installation is used.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhiYmZmMjI3LWU2YTMtNDE4Yy1iNWU2LTliZmU4YzRlMmY1MyJ9.7Zs4CCPYontT53ip4-ghH2i01h0IIUUuhit2sie_ABE" class="fr-fic fr-fil fr-dib" width="992" style="width: 994px; height: 444.813px;" height="445"></p><p><strong><span style="font-size: 10pt;">Fig 9. Create Swap action</span></strong></p><p><br></p><p>To each action, add the LapSafe fields to the field list. These can also be added to the ticket type.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBmZGFmOWJiLWFkOWYtNDBhMC1iZTZmLTQ0ZGE2ZGQ2MTAxNyJ9.l3sjdofv1UGp87dsUCZvp1uDOnZiLQwgrX66oaPTaZw" class="fr-fic fr-fil fr-dib" width="994" style="width: 996px; height: 366.98px;" height="367"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 10. LapSafe fields</span></strong></p><p><br></p><p>From v2.236+, Drop offs, collections, and swaps can be initiated when a ticket is logged. To set this, head to the integrations tab of the relevant Ticket Type (Configuration > Tickets > Ticket Types) and set the "LapSafe Action to do when logging Tickets of this Ticket Type" to the LapSafe action you would like to perform. </p><p><br></p><p>From this version there is also the option to set a "Default LapSafe Asset Type". This filters the Assets available for collection to the specified Asset Type.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjllYTk3Zjk4LWE4MWEtNDEyNi1hMzdmLWViY2M0ZTgzZTU1ZCJ9.s2RkFHrUwWELHbxCf98JVXjnbV1u0V8gXy7ynHB6TVk" class="fr-fic fr-fil fr-dib" width="992" style="width: 994px; height: 350.787px;" height="351"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 11. Ticket Type settings </span></strong></p><p><br></p><p data-pasted="true">This allows users to log tickets which will immediately link to LapSafe, rather than relying on an Agent or an automation. Users are also able to be granted access to actions with the system uses of "create drop off", "create collection", and "create swap", by selecting the "Allow Users to use this action" checkbox in the Details tab of the action.</p><p><br></p><p><strong><span style="font-size: 14pt;">Using LapSafe in Halo</span></strong></p><p>The configured actions can then be used on a ticket to arrange drop offs, collections, and swaps.</p><p><br></p><p>First, let's use the "Create Drop Off" action. Fill in the LapSafe fields added to the action, and upon saving, a separate email action will send off as well.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjYzMTdiZWE0LTRhYTItNDJjMS1iYjk2LTBkOWI1MjRiZWY3ZiJ9.2Q3tmkJUAVBX_fm1jKoX0sCuErw-fWHIsvd7JJ4GVgg" class="fr-fic fr-fil fr-dib" width="990" style="width: 992px; height: 484.357px;" height="484"></p><p><strong><span style="font-size: 10pt;">Fig 12. Create Drop Off action used</span></strong></p><p><br></p><p>This email will use the "Asset Drop Off Arranged" template (ID: 321) unless this was changed in the defaults tab of the integration.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcxMmMxMzQ3LWMyYjQtNDI5Ni1iYzI0LWRkNzZlNmJhZmQxOSJ9.TR5EVU44FV4a7iKWmSlw8EPl1kDtyQwGba0SCPpzTSk" class="fr-fic fr-fil fr-dib" width="989" style="width: 991px; height: 485.753px;" height="486"></p><p><strong><span style="font-size: 10pt;">Fig 13. Email template sent from drop off</span></strong></p><p><br></p><p>Upon first use of one of these actions on a ticket, a tab called "Drop offs and Collections" will appear. Here, a list of LapSafe requests associated with the ticket and their current status will show. You can also right click to complete/cancel these manually.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU4ZTFmMDFhLWE2NWYtNGU0Ni05OGUxLTU4MTNiNDNlYzM0NyJ9.kj8ae1APOGc89pYufMhxkYGb1btRaxOWvIyDJo-kjoQ" class="fr-fic fr-fil fr-dib" width="990" style="width: 992px; height: 484.345px;" height="484"></p><p><strong><span style="font-size: 10pt;">Fig 14. Drop offs and Collections tab</span></strong></p><p><br></p><p>Upon completion of the drop off, a "Drop Off Completed" action will automatically appear on the ticket.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg1ZTNjZDc3LWEyNWEtNDIxNS04MzY3LTU4ZDUyMTM4MjA1MyJ9.R2-xTooGBpeiXTH2Iuu8jV_h4POOnobtP8S8NrYhndY" class="fr-fic fr-fil fr-dib" width="988" style="width: 990px; height: 484.666px;" height="485"></p><p><strong><span style="font-size: 10pt;">Fig 15. Drop Off Completed action</span></strong></p><p><br></p><p>Next, let's use the "Create Collection" action. This will follow the same system - fill in the LapSafe fields, save the action, and an email will be sent out.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ0NDMzNmM3LTA1NzItNGJjZS1iZTY2LWMwYTgxOWM1ZTMxMCJ9.YV-BYZ41xUyFuiLCN7-EFrB8pr3bqnuXBs4FGNFIR5c" class="fr-fic fr-fil fr-dib" width="986" style="width: 988px; height: 482.919px;" height="483"></p><p><strong><span style="font-size: 10pt;">Fig 16. Create Collection action used</span></strong></p><p><br></p><p>The template used for this system use is "Asset Collection Arranged" (ID: 324) unless it was changed from the default in the integration configuration.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE0MmUwYWRjLWRlNjUtNGY2Yy1iYmFkLWQzZjVjZDBhOGMxNyJ9.u1eH1lWK6tp9dtu_yTvPP-oxbQRzr_XqkPXpuASAXMA" class="fr-fic fr-fil fr-dib" width="988" style="width: 990px; height: 484.402px;" height="484"></p><p><strong><span style="font-size: 10pt;">Fig 17. Email template sent from collection</span></strong></p><p><br></p><p>Upon completion, the "Collection Completed" action will automatically appear.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2NmQyN2EwLTMwMjctNDA3Yi04MWMwLTA3NGFlOTEzODE2ZiJ9.fjYmGYxXQ4jz7narI8LLg527p_Q-rDiRoR0nM1rxCEA" class="fr-fic fr-fil fr-dib" width="983" style="width: 985px; height: 481.715px;" height="482"></p><p><strong><span style="font-size: 10pt;">Fig 18. Collection Completed action</span></strong></p><p><br></p><p>Finally, let's use the "Create Swap" action. This will also follow the same process as the previous two - filling in the LapSafe fields, saving, and an email being sent.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMzMjg4YTc2LTg1N2QtNDU3YS1iMjMyLWUwYzMzMWQ4NmVmZSJ9.bEUYmyDnvDVgWkb3YKizNeHWDmbvAtSLJaVpt24Wac4" class="fr-fic fr-fil fr-dib" width="981" style="width: 983px; height: 480.988px;" height="481"></p><p><strong><span style="font-size: 10pt;">Fig 19. Create Swap action used</span></strong></p><p><br></p><p>The template sent out is the "Asset Swap Arranged" (ID: 333) unless changed from the default in the integration configuration.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjlhMDA5OTY0LWQyYjQtNDNhYi04OGY1LTkzYzQyZmViNzI3ZiJ9.EwFSXaKH-ZXBXDLb3ftxOAK8Ay8HsTIjO5DA_b0MVwM" class="fr-fic fr-fil fr-dib" width="978" style="width: 980px; height: 479.509px;" height="480"></p><p><strong><span style="font-size: 10pt;">Fig 20. Email template sent from swap</span></strong></p><p><br></p><p>The "Swap Completed" action will also automatically appear upon completion.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFiOTQ0NzgxLTI4NmQtNGEwYS05ZGY2LTdmNjM4ZDU1M2I1NyJ9.fMoidHf2zYFf0Z2b9g8AStZu3w4dWCJbYNGd1VF-3NA" class="fr-fic fr-fil fr-dib" width="981" style="width: 983px; height: 482.265px;" height="482"></p><p><strong><span style="font-size: 10pt;">Fig 21. Swap Completed action</span></strong></p><p><br></p><p id="isPasted">The swap action has been enhanced. An asset's name can be typed into the "LapSafe Asset" field, and then the "LapSafe Bay" field will only show fields with that asset for swapping. This requires an asset to be created in Halo with the <strong>same name as the one in LapSafe</strong>, as well as being assigned to an <strong>asset type that also matches the name of the one in LapSafe</strong>.</p><p><br></p><p>Here is an asset in Halo with the name "asset1" and the asset type "assetype1". </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBhNjUxY2RjLWMzOWQtNDU1My1iNmIwLWJmOWE3Zjk5ZDM2OSJ9.rGyzxHXtaKJHSNEzCEyVSFHKSGUZx_CL6A1DIqiChvk" width="109" height="75" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 22. Asset with asset type and name to match a LapSafe asset</span></strong></p><p><br></p><p>This matches to the ones in LapSafe, so when typing the asset name, the bay that appears is the one it is contained within. This reduces possibility of agent error by selecting the wrong bay.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQwZTNjM2Y1LWNjYzQtNDcwYS04NjkxLWZjODMwNGNjNmE3OCJ9.ItDdH6sNE2WQ6dHHidiTD9_OjNeMKQlM2YtGLFmAMfw" width="994" height="336" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 23. Bay that asset is contained in is the only one that appears</span></strong></p><p><br></p><p>However, what if a drop-off is cancelled for instance? Another drop-off action has been created and is pending as seen below.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNjMzYzNThiLTRmNTctNGFjZC05NGM5LWVlMzFlNjBkOGE0ZiJ9.qAav7jsmqrk8WMVnwKJa8Q_s46LCucPycHyO6eA_Qrw" class="fr-fic fr-fil fr-dib" width="981" style="width: 983px; height: 481.501px;" height="482"></p><p><strong><span style="font-size: 10pt;">Fig 24. Pending drop off</span></strong></p><p><br></p><p>If we then cancel this, a "Drop Off Cancelled" action will automatically appear.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZmNDMyMmY1LWIwNDUtNGZlMi04OTRkLThhZjE4ZThiZTk4MSJ9.0Khz4HqmnHtFDZlA1nUv4AHOUj49dbpHmilVENaDPrw" class="fr-fic fr-fil fr-dib" style="width: 983px; height: 479.45px;" width="981" height="479"></p><p><strong><span style="font-size: 10pt;">Fig 25. Drop Off Cancelled action</span></strong></p><p><br></p>
