<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 data-pasted="true"><span style="font-size: 11pt;"><strong>In this guide we will cover:</strong></span></p><p><span style="font-size: 11pt;"><strong>- Pre-requisites</strong></span></p><p><span style="font-size: 11pt;"><strong>- Adding The Halo App To Your Zoom instance</strong></span></p><p><span style="font-size: 11pt;"><strong>- Configuring & Using The Zoom Integration</strong></span></p><p><span style="font-size: 11pt;"><strong>- Removing The App </strong></span></p><p><span style="font-size: 11pt;"><strong>- Troubleshooting</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">The Zoom integration in Halo can be used to call Users from a Ticket using Zoom phone, to send messages to Users from a Ticket using Zoom, and use shortcuts and slash commands inside of Zoom to carry out actions in Halo. </span></p><p><br></p><p><span style="font-size: 11pt;"><br></span></p><p><strong><span style="font-size: 14pt;">Pre-requisites</span></strong></p><ul><li style="font-size: 11pt;">If you need to use anything other than Call Management, you must ensure that you have <a href="https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060928" target="_blank" rel="noopener noreferrer" style="font-size: 11pt;">Zoom workplace</a> downloaded locally onto your device.</li><li style="font-size: 11pt;">Any User that you wish to chat with in Halo must be a contact within your Zoom instance.</li><li style="font-size: 11pt;">If you wish to use the Call Management feature of the Zoom integration then you must also have Zoom Phone.<span style="font-size: 11pt;"><br></span></li></ul><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong>Disclaimer: At the time of writing this guide (May 2026), only the Call Management feature is available for the current Zoom integration. The new version of the Integration outlined in this guide will be available in an upcoming version of Halo. </strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 14pt;"><strong>Adding The Halo App To Your Zoom Instance</strong></span></p><p><span style="font-size: 11pt;">Before configuring in the integration or using Zoom workplace with Halo, you must first connect your Zoom instance to your Halo instance. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Navigate to Configuration > Integrations > Zoom, and enable the module for the Integration by hovering over the module and selecting the "+" icon. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA4NWU1MTY4LTNlOWQtNDA1Yy04ZGMyLTE0OGMyNzM5MTkzNiJ9.N9WzN3-_SfBdbNV3I7upF1U_gDvd50OCq1w2CRxLupk" width="900" style="width: 902px; height: 488.115px;" height="488" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 1. Enabling the Zoom integration module</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once the module is enabled, click into it and you will see the four tabs illustrated in Figure 2. The first tab, Configuration, is where you can connect your Zoom instance to Halo. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEwNzU0ZDY5LThhOWQtNGUxNS1hOWQzLWM3ZTFmN2RiYmE2ZiJ9.-7mKtpE3jgJ1KNw7uLiXEl07VskJFbmolO15qg-jZ0U" width="896" style="width: 898px; height: 376.898px;" height="377" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 2. The configuration tabs for the new Zoom integration</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;" data-pasted="true"><strong><em>Note: If you only wish to use the Call Management functionality, you do not need to add the Halo App to your Zoom instance. If this applies to you please navigate to the next section of this guide, "Configuring The Zoom Integration", where you will find details on setting up Call Management.</em></strong></span></p><p><br></p><p><span style="font-size: 11pt;">Select the "Add the HaloITSM Zoom App" button to connect to your Zoom instance, this will bring up the Zoom login screen illustrated in Figure 3. You should ensure that you are logging in with an account that is able to authorise the connection - either an Owner or an Admin. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImViNzNhMTEwLWY5YTUtNGFiNi04M2ViLWE0YTJkNjM5N2FhNyJ9.lhjX0N0NnvQliJluCx_ajMnFAMvvt9XQ4mrBbORUBLI" width="764" style="width: 766px; height: 630.773px;" height="631" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 3. Connecting Zoom to Halo</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once you have successfully connected Zoom, you will see a success message in your Halo integration (Figure 4a), and you will see the Halo app appear within the "Apps" section of your Zoom workplace (Figure 4b). </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQzMGRhYTc2LWE2ZTMtNDRmNC05N2FiLWExNTE5ZWZlMzM2OSJ9.OBATtzmgj0TM8IkXXrKW3zYaiZyQ40Da0snM6lRmT84" width="714" style="width: 716px; height: 292.503px;" height="293" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 4a. The connection success message for the Zoom integration</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk0ZGMwMjZhLTRkY2QtNDUwMi04ODI4LTE0ZGRkZmFiZGZjNSJ9.vOieU93g5fwBovfHmTfOsme7TOcMQ9mvAsKxNXNw3oo" width="656" style="width: 658px; height: 390.749px;" height="391" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 4b. The Halo app that will appear in Zoom workplace after a successful connection</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once you can see the Halo app in your Zoom instance, you will need to then affirm the connection from the Zoom end. To do this, click into the Halo app shown in Figure 4b and run the slash command "/halo connect" into the message box (Figure 5). </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVmNmE3MWRlLTcyYjUtNDM0My1hYTFhLWU0MjExMTUxMTY2ZSJ9.f8R-3kJdZJ6NQZNZtUo_-Uz_TDKEua6CTGOELNnyBFE" width="761" style="width: 763px; height: 500.208px;" height="500" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 5. Connecting to Halo from the Zoom end of the integration</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once you run this command, an option will appear prompting you to log in to Halo.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2ZWVjMTVkLThjMzEtNGUyOC1iN2IyLTcxZTI5M2VhMTNlMCJ9.XC7J7uOnhcGjMKWXTxBP9Cm_g66z3KHzoeMR3GJvVm0" width="610" style="width: 612px; height: 274.322px;" height="274" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 6. Signing into Halo in Zoom</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Select "Log in" and you will be redirected to the Halo login screen. Once successfully logged in, you will be presented with the connection screen show in Figure 7.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjczYzhmYjNjLWYwZDUtNGI4Yi1hYzFjLTlkNWY2MGYyZGQ1MCJ9.aVMD4Ot-gdhEm_lH6j-LFFInuR3SdFXoAPXFO3FpsOY" width="572" style="width: 574px; height: 337.159px;" height="337" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 7. Successful connection message when affirming connection from the Zoom end of the integration</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong><em>Note: You will only need to complete the "/halo connect" command once - if you ever remove the app, then this command would be necessary as part of re-establishing the connection. Removing the app is detailed in the "Removing The App" section of this guide.</em></strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 14pt;"><strong>Configuring & Using The Zoom Integration</strong></span></p><p><span style="font-size: 11pt;">Once your Zoom instance is successfully connected to your Halo instance, you can configure the three main functionalities of the integration. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 12pt;"><strong>Call Management</strong></span></p><p><span style="font-size: 11pt;">Within the Call Management tab of the integration you can enable the ability to call Users on Zoom from within Halo.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJiMTMxMjJmLWI1MWQtNDViMS1iNjBjLTgzZmNlNzA3YTYwOSJ9.6aQowpVVudpollq6M_zR1oigOiU1kfQjuFUc1dlXWn0" width="971" style="width: 973px; height: 335.823px;" height="336" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 8. The Call Management Tab of the Zoom Integration</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">When the setting to "Show an option on a Ticket to call the User directly via Zoom" is enabled, a button will appear on Tickets beneath the User's email address labelled "Call on Zoom".</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFjNzA5NjkxLWUxODAtNDU2ZC1hMjAxLTExY2QyOGJhOWRkYiJ9.EtQacggs1J2iCGE3xGayVvRmlhBeTjs66Og8hJRgzHY" width="465" style="width: 467px; height: 397.973px;" height="398" class="fr-fic fr-dii"></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 10pt;"><strong>Fig 9. The button for calling Users directly from a Ticket</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong><em>Note: This button will only appear if the User has an email address set against them.</em></strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">If you also enable the setting to "add an Action when calling a User via Zoom" (Figure 5), an Action will be added to the Ticket whenever the "Call on Zoom" button is pressed - this provides an automatic record of the call. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJmOWY2OTBkLTU4NDctNGRlNC1hODFkLTA3OWE0MjZkOWQ4ZSJ9.quq4BzfiRgLFDz-dRzMYOay5DPxmYQaD4mliVC8euWY" width="383" style="width: 385px; height: 170.435px;" height="170" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 10. Action added when the "Call on Zoom" button is selected</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p data-pasted="true"><span style="font-size: 11pt;">Next, you will need to <a href="https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067257#:~:text=Enabling%20click%2Dto%2Ddial&text=Scroll%20down%20and%20click%20Choose,default%2C%20then%20select%20Zoom%20Meetings" target="_blank" rel="noopener noreferrer" style="font-size: 11pt;">change the default app on your device to Zoom</a>. To do this, via your windows search bar, navigate to "Default Apps".</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQxMDFhYzRmLTRjYjgtNGI5MS05MDI2LTdiNzQ1NGJkYTAxNSJ9.B6OShKymegyhr7nbNHgyL6PR3m2Hrx8RrJbnVSVMfbU" width="587" style="width: 587px; height: 337.125px;" height="337.125" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 11. Loading "Default Apps" on your Windows device</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">In the following box, search 'CALLTO'.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM3ODQzYjg3LWZjMjktNDA3Ny04ZWYxLTFkNDJhMGZiOGFhYiJ9.Ocor9YtL5EBaePGelTbPFNnV6KzPQWWR0qrwDoWrV_M" width="668" style="width: 668px; height: 224.543px;" height="224.543" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 12. CALLTO app</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Here, it will show you your default calling app. If it is not Zoom, you will need to change this. To do this, click onto the existing 'CALLTO' default, select Zoom and press 'select default'.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Next, head to Zoom. You will need to navigate to the 'Phone' settings, then ensure that </span><span style="font-size: 11pt;">launching a URL from a call</span><span style="font-size: 11pt;"> has been enabled.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">You will then need to copy the URL that is given in the 'Call Management' set up page, this is your Halo URL followed by /call?callerid=$phonenumber </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">E.G: <a data-fr-linked="true" href="https://yourhalourl.halocrm.io/call?showmenu=false&callerid=$phonenumber" target="_blank" style="font-size: 11pt;">https://yourhalourl.halocrm.io/call?showmenu=false&callerid=$phonenumber</a> </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">You can read the full details on parameters within Zoom by reading their guide <a href="https://support.zoom.us/hc/en-us/articles/360054844551" rel="noopener noreferrer" target="_blank" style="font-size: 11pt;">here</a>.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once saved, incoming external calls should now pop-up the Halo new call screen when answered.</span></p><p><br></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 12pt;"><strong>Direct Messaging</strong></span></p><p><span style="font-size: 11pt;">The Direct Messaging functionality of the Zoom integration allows Agents to initiate chats with the Ticket's User via the Ticket itself.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ3NGI3ODFhLTc4ZTktNDc1MS1iYWY0LWVlZTk4NjBjNjliOCJ9.nS8uGTNcK1BXdm5D88dNMVQwyqbXK9GK19E9gt8AEb8" width="770" style="width: 772px; height: 293.585px;" height="294" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 13. The setting to enable Chats via Zoom to be initiated on Tickets</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">When you enable the setting to "show an option on a Ticket to message the User directly via Zoom" you are provided with the additional option to default the text for the message - within this field you can use variables to default text such as the initial greeting, the Ticket ID or hyperlinks, Figure 13 shows an example of the type of text you could default here. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">With this setting enabled, there will now be a button available on Tickets beneath the User's email address (below the "Call on Zoom" button if enabled) to message the User on Zoom.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM0MmNiZDM4LWQyMTctNDY3YS05ZDlhLTA3YWEwZTJjNDdiMyJ9.Y5S8DdUADZqG5gI-akZrZ4eMWYcrhZ2q4cmY05Ih_gs" width="626" style="width: 628px; height: 497.815px;" height="498" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 14. The "Message on Zoom" button that appears once Direct Messaging is enabled</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">When I select this button, a modal screen pops up with the default text I set in Figure 10 already populated. I can then add any additional text into my message to the User.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEyYTQ1NjUwLTg0OGEtNDIwYS1hMDZkLTRlZjBjYTA1YTliYyJ9.6kKjr0Pqe-SYixfVj_3RhAzYhOqoIozn4UpmdMGVaY8" style="width: 852px; height: 427.196px;" width="850" height="427" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 15. Sending a Zoom message to a User via a Ticket in Halo</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once I hit save, the message sends and I can view the Chat from within my Zoom instance immediately.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIwOWM5NGVlLTA0ZGItNGM5ZS04MGVmLTY0MzhhNmFmNjE3OCJ9.pwBSUXQiPCsWzp0cA9FMP7qE_0dHUifO1mEWVR_b5NA" width="742" style="width: 744px; height: 562.093px;" height="562" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 16. Chat with the Ticket's User in Zoom</strong></span></p><p><br></p><p><span style="font-size: 11pt;">Please note that the message to the User will come from the Agent that selected "Message on Zoom", not the account that authorised the integration.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">If I want a record to be added to the Ticket whenever I message a User on Zoom, I can also set this up within the Direct Messaging tab of the integration by enabling the setting to show an action when the message is sent (Figure 17). </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVkZDRlMjVmLWQ4MmYtNGMyNy04OWE4LTcyOWNkNzVjNzk4NiJ9.t-Wj8fTkQrIZmXzaq1FEbyBs8vdUH1gcBZM1MFDyj0o" width="850" style="width: 852px; height: 511.934px;" height="512" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 17. Setting an Action to add to the Ticket when a Zoom message is sent to the User via the Ticket</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Now, whenever a Message is sent to the User, an Action will be added to the Ticket:</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg2NDI1NTI1LTRiNWItNGQ4OS1iNDcxLWRiYjEyMzNmMTk1MCJ9.ulSxEluVSeQEEUflqDoWFNRYcuTDRTC7zIu7bFPZvNc" width="877" style="width: 879px; height: 431.815px;" height="432" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 18. Record of a Zoom message sent via the Ticket</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 12pt;"><strong>Shortcuts & Slash Commands</strong></span></p><p><span style="font-size: 11pt;">Within this tab of the integration you can set certain defaults for when shortcuts or slash commands are used within Zoom. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQyZTdiOTRmLTA4NGItNDY3MC04MTdjLWNlNjg0MGQxNjg3YiJ9.DD2ai4du3voDsdd9r3zQlwmeaCJZMUX3SOmuCpoqnwk" width="932" style="width: 934px; height: 635.541px;" height="636" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 19. The Shortcuts & Slash Commands of the Zoom integration</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong>Shortcuts</strong></span></p><p><span style="font-size: 11pt;">The "shortcut" refers to the method of creating a new Ticket in Halo via the Zoom chat. As you can see in Figure 19, you are able to set what Ticket Type will be used for creating the new Ticket and who the Default User will be. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong><em>Note: If you are creating a new Ticket from a User's message then they will be the User of the new Ticket, not the default User. The default applies if you are creating a Ticket from your own message.</em></strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">The shortcut can be carried out using the 3 dots that appear when you hover over a message (Figure 20a) and select the "Create Ticket" option (Figure 20b).</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFmZTZmNTc2LTQyMDUtNGJhOC05ZjEyLTRlYjE0Nzc5NWEwOCJ9.ByalwBYk2R938plWPPWZ40rD6uUcWQoe83jQ8iCjv9A" width="531" style="width: 533px; height: 209.051px;" height="209" class="fr-fic fr-dii"></span></p><p><span style="font-size: 11pt;">Fig 20a. Options against a message in Zoom</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMxOGEwZGVlLTgzZWMtNGI0NS1hODAxLWFkODA3MmNjNWFjZiJ9.mlvtwN_CgyIYe5HcegMhw_MjqL31U4m7_3G21y43bLg" width="509" style="width: 511px; height: 300.368px;" height="300" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 20b. The shortcut in a Zoom chat to create a new Ticket</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once you select this, a modal screen will appear in which you can enter the summary and details of the Ticket you are logging. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJkMWE2YzJhLTk1NDQtNGQ4Mi1iZWU2LWRmNjlmYjJiZjZkZCJ9.GxEYhdNkXUzdggbUT7_r_hnEndsy7JAjJanDbavdIAk" width="796" style="width: 798px; height: 641.725px;" height="642" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 21. Creating a Ticket using the "Create Ticket" shortcut in a Zoom chat</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Once you select "Submit", the Ticket ID will be returned in the success message on the modal screen</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImViMzIwYWI3LTgyOGUtNDE3Ny04MDNiLTZiNjMxZDExNDY0MyJ9.vv-5whq4M9kXVoL3jKw96E9blqVCozv-JgyZrTGSxeE" width="783" style="width: 785px; height: 455.503px;" height="456" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 22. Zoom will return the Ticket ID once a new Ticket is logged</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">The Ticket will be logged with the summary and details you provided, and any additional defaults set by the Ticket Type set as the "Ticket Type for Tickets Created via Zoom shortcuts" in the shortcuts section in Figure 19. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJkMGY0YjA0LTRiZjktNGE4Ny04NDc5LTZhNjIzOGNhMjRhNiJ9.kLbTjGPQ66WnXcinPQ9lUW_KeTzOskpAU4vJ6r4tcaQ" width="840" style="width: 842px; height: 614.185px;" height="614" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 23. A Ticket logged in Halo via Zoom</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong><em>Note: The Ticket Type used for this should not have any mandatory fields. Please also be aware that only the summary and details is available to be filled in when creating Tickets using this shortcut.</em></strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong>Slash Commands</strong></span></p><p><span style="font-size: 11pt;">Slash commands can be used within your Zoom instance to perform certain functions in the Halo app - these always follow the format of " /halo [command] " and can be performed within any chat in your Zoom instance. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImIzYjkyNTg0LWUyNjItNGM0OS1hNDEyLTM2MmY4MzgyMjA4MyJ9.QqqcclhMAPy0uky29E86_G3Opqp_M93Lryj_XZSPo3I" width="850" style="width: 852px; height: 446.468px;" height="446" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 24. Zoom slash commands for the Halo app</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">For example, if I run the command "/halo update 3030", I am provided with an option to enter a note and a new status for the Ticket 3030. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVkNzcwNTQ5LTI0NDgtNDI3Yi04YmUxLWRkNTVmNmVhZjlmMyJ9.F5cpT4l_whwjYSSPlGHkTZ0vZEACgO-3-242eRQ5p00" width="777" style="width: 779px; height: 502.734px;" height="503" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 25. Updating an existing Ticket using the /halo update command in Zoom</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong><em>Note: The "/halo connect" and /halo disconnect" commands control the connection of your Zoom instance to your Halo instance, as such these should only be used if you wish to affirm your connection or break your connection.</em></strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">As illustrated in Figure 26, within the Shortcuts & Slash Commands tab of the integration you can default the Ticket Type used when creating Tickets with "/halo create", the User for those new Tickets, and what Action is used when a Ticket is updated using any of the commands that make a change to an existing Ticket. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVjODIwM2IzLTQ1MmYtNGM3Ny05ZTM4LWNmN2Y0OGEyZjg0ZCJ9.Aqvm0reB0wWjBaJ8isTVKgE0vfoKpIWw24pzkWDTtd4" width="826" style="width: 828px; height: 350.496px;" height="350" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 26. The Slash Commands section of the Zoom integration in Halo</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">For example, if I run the command "/halo unfollow 3032" then it will remove me as a follower of Ticket 3032 and it will add the "Zoom Note" action set in Figure 26 to the Ticket. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUzYTRmZWRkLWI3NWItNDhhZi05MDJmLTJjMWI3OGE5YmM0OCJ9.ybSiAyJMye9b-SoR85ULtNYVe7pM9j7qoazLO0c1OUk" width="563" style="width: 565px; height: 206.132px;" height="206" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 27. Action added when changing an existing Ticket.</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 14pt;"><strong>Removing The App</strong></span></p><p><span style="font-size: 11pt;">In the event that you need to remove the Halo app from your Zoom instance, there will be an option to do so in the Configuration tab of the integration once the integration is connected. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE4M2E3MTBhLWVlNWEtNGM2Yy1iMjE4LTA4ZGQwYmVkZmYxMyJ9.PbMY60nBneXBp9YNKwZ3NWtoR7D_gDCqtEwukStf1ZI" width="786" style="width: 788px; height: 328.333px;" height="328" class="fr-fic fr-dii"></span></p><p><span style="font-size: 10pt;"><strong>Fig 28. The method of removing the Halo app from your Zoom instance. </strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Selecting this button resets the configuration of the Direct Messaging and Shortcuts & Slash Commands tabs in the Zoom integration in Halo, it then also removes the Halo app from the Zoom instance. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong><em>Note: In the event that the removal of the app fails, you should manually remove all relevant configuration in the integration and then manually remove the app from your Zoom instance. </em></strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">All chats will remain, even if they were initiated from a Ticket in Halo. However, the shortcut and commands will no longer be available and no action can be taken in Halo via Zoom, nor in Zoom via Halo. </span></p><p><br></p><p><span style="font-size: 11pt;">Once the app has been removed, ensure you disable the Zoom integration module within Halo by navigating to Configuration > Integrations, locating the Zoom module and clicking the "x" icon on the module. </span></p><p><br></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQyZmNhODEyLTJlY2MtNDNmMi1hMjc2LWFjMDY5MzJjNmM1YyJ9.nuWulpnYSf8D_x8f3Dj8UnhQbba5PPADKcxGHC1E0wE" width="181" style="width: 183px; height: 184.494px;" height="184" class="fr-fic fr-dii"></span></p><p><br></p><p><br></p><p><strong>Fig 29. Disabling the Zoom integration module in Halo</strong></p><p><br></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 14pt;"><strong>Troubleshooting</strong></span></p><p><span style="font-size: 11pt;">This section provides some potential errors you may encounter with the Zoom integration, what their cause is, and how to resolve them. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">In the event that you encounter an error not documented here and you are unsure how to resolve it, please do reach out to our support team for guidance. </span></p><p><span style="font-size: 11pt;"><br></span></p><table><tbody><tr><td><div><span style="font-size: 12pt;"><strong>Error</strong></span></div></td><td><div><span style="font-size: 12pt;"><strong>Error image</strong></span></div></td><td><div><span style="font-size: 12pt;"><strong>Resolution</strong></span></div></td></tr><tr><td><span style="font-size: 11pt;">Token refresh failed - Error Code: 1001. Message: Invalid request body. Details: View logs for further information.<br></span></td><td><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE0MTQ1YmU3LWJlNmEtNDUxOC05M2FmLWVhMmJiZDM3NWU2ZSJ9.VDoVUjmLN1IB8QHe4Z_DiNaWbIAAsW6rTocEniIjTVc" width="530" style="width: 532px; height: 71.9531px;" height="72" class="fr-fic fr-dii"></span></td><td><p><span style="font-size: 11pt;">This error can happen if the "Message on Zoom" button is clicked but the integration is not connected. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">To resolve this error, connect the Zoom integration within Configuration > Integrations > Zoom and perform the "/halo connect" command within Zoom.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">If you have purposefully disconnected the integration and do not intend on using it, you should either reconnect the integration, disable the settings in the Direct Messaging tab, and then disconnect again, or you can just disable the Zoom integration module. </span></p></td></tr><tr><td><span style="font-size: 11pt;">Failed to send message User does not exist: [USER EMAIL]<br></span></td><td><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcxMTM5YjlkLTA0MWQtNGFjYy05M2NjLWExZDE2OGYxODlkYSJ9.VvR9rWJ1Ebjtx53YhhjIJrW8eF3fg6FWrDr5dMzBaPc" width="532" style="width: 534px; height: 98.4738px;" height="98" class="fr-fic fr-dii"></span></td><td><span style="font-size: 11pt;">This occurs when you have selected the "Message on Zoom" button on the Ticket, but the User is not a contact in your Zoom instance. <br><br>To resolve this error, add the User as a contact in your Zoom instance before re-attempting to message them.</span></td></tr><tr><td><span style="font-size: 11pt;">You cannot authorise Halo</span></td><td><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMyNTE5N2Q3LWI2OGEtNGY0ZC04NGE0LTk4ZmYzNjAwY2ZhMyJ9.rY-X06pu9fNxLQwGOiglMdx6jIXQjiAlDxoRaFaj30M" width="380" style="width: 382px; height: 129.826px;" height="130" class="fr-fic fr-dii"></span></td><td><span style="font-size: 11pt;">This can show as the error when attempting to add the Halo app to Zoom. It occurs due to a lack of permissions.<br><br>To resolve this error you will need to authorise the connection with an Owner or Admin account for Zoom.</span></td></tr></tbody></table><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p>
