Microsoft Teams Integration – HothBot Overview

The MS Teams HothBot application is a quick and easy way to raise tickets and communicate within House-on-the-Hill via the Teams app. HothBot is compatible across all formats of MS Teams (i.e Desktop, Web and Mobile). 

Note: You must be running the latest version of Teams and at least House-on-the-Hill version 2022 to use HothBot 

Click the links below to learn more information:


Installing HothBot

To get started, ensure that your system administrator has installed the bot in Teams and has made it accessible for all members of your organisation.

  • On MS Teams, navigate to Apps, and select the HothBot application:

  • Click Add to install the HothBot onto your MS Teams account:

  • You may want to pin HothBot for quick access from within Teams:

Click here for further information on how to install an app in Teams via the ‘Teams admin center


Signing Into HothBot

  • With HothBot now installed, begin a chat with the HothBot contact to present the Sign-in card, and click This way to Sign-in:

  • Enter your House-on-the-Hill URL in the browser window, and click Connect House-on-the-Hill:

  • Enter your HotH portal login details and click Sign in to link your HotH account to HothBot:

Note: Ensure the email you sign into MS Teams with matches the email account in your HotH system.

  • If all details have been inputted correctly, you’ll be presented with a successful connection screen:

Note: If the connection is unsuccessful (e.g. Incorrect username or password, poor connection), try calling the HotHBot, and attempt the sign-in process again, ensuring the URL, username and password are all correct to establish a connection correctly.


Signing into HothBot via SSO

To connect the HothBot via SSO:

  • Enter your SSO URL on the HothBot sign in page and click Connect House-on-the-Hill:

  • Once clicked, SSO will link your account with HothBot, and if successful, you’ll be presented with a successful connection screen

Note: Make sure you are signed into your Microsoft account on the device.


Creating Tickets via HothBot – End User

  • Begin a conversation with HothBot and click the Create a ticket button:

  • Enter your ticket subject and click Create ticket to raise a ticket in your system, with the Subject pre-populated on the form:

  • You’ll be presented with a unique reference number for your ticket with a link to view your ticket within HotH:

  • The ServiceDesk team will reply using the conversation tool within HotH
  • This reply will be presented within Teams, where you can write a reply and click OK to send:

Below is the subsequent ticket in HotH logged via the HothBot in Teams:


Activating Notifications on Email Templates

To activate notifications for the relevant templates, go to the Settings Cog >Email Settings:

Navigate to the template you would like to activate notifications for, e.g. ‘On New Call to Assignee’. Check the ‘MS Teams Notification’ box, allowing notifications to be sent whenever that template is active:

Note: Ensure the Subject of the email template relates to the action which will be taken as much as possible. For example, the ‘On New Call to Assignee’ template, the Subject for this should read something relevant, as this will come through on the notification to the user.

When the template is activated, in this case a ticket being assigned, a HothBot notification will be sent to the user:

If you have signed in on a mobile device, you will also receive notifications here, so you can keep up to date with your tickets on the go:


Still haven’t found what you’re looking for? Contact documentation@houseonthehill.com

Back to Top

Previous – Document ManagerNext – Active Directory User Setup