Package Installation

Deployment Requirements Microsoft Teams Desktop or Web App Developer Portal App for Teams SigningHub_App.zip from the installation package Configuration Follow these steps to install and configure

Deployment

Requirements

• Microsoft Teams Desktop or Web App

• Developer Portal App for Teams

• SigningHub_App.zip from the installation package

Configuration

Follow these steps to install and configure the app and bot.

1. Open Developer Portal in Teams

   • In Microsoft Teams, click the Apps icon on the left navigation bar.

   • Search for and open Developer Portal.

   • Right-click the Developer Portal icon and select Pin for easy access.

2. Create and Configure the Bot

   • In the Developer Portal, go to the Tools tab and click Bot Management.

   • Click + New bot.

   • Name the bot SigningHub and click Add.

   • Under the Configure section, set the URL to your bot.

     • For Ascertia's SaaS deployment, use: https://int-hub.signinghub.com/

     • For On-Premise deployments, use: https://__unityPortalHostname__/chat-sh/v1/teams/chat (replace __unityPortalHostname__ with your actual server name).

   • Click Save.

   • Click the Upload Icon link to add an icon for your bot.

   • Copy the Bot handle for later use, then click Save changes.

3. Enable Teams Channel and Generate Client Secret

   • Under the Channels section, select the checkbox for Microsoft Teams and click Save.

   • Under Client secrets, click New client secret and save the generated secret for later.

4. Select scopes Bot should be available in:

   1. Go to the Developer Portal and select the SigningHub app.

   2. Select App features from left panel.

   3. Select Bot.

   4. Scroll down to Select the scopes where people can use your bot and ensure the scopes you want the bot to be available in is selected.

   5. At the bottom of the page, click Save.

5. Import the SigningHub App

   • In the Developer Portal, go to the Apps tab.

   • Click Import App and select the SigningHub_App.zip file.

   • Note: If you receive an error message that the app package is a duplicate, you must rename the application before proceeding. See the Rename the Application subsection for details before returning.

6. Connect the App to the Bot

   • Once the app is imported, select it from the left menu and then click Bot.

   • Click Select and existing bot and choose the bot you created earlier from the dropdown menu.

   • Leave all other settings as default and click Save.

7. Install the App

   • Click the Install button to add the app to Teams.

   • Click Add, then Open. This will take you to a chat with the bot.

8. Copy the Bot ID

   • After saving the bot connection, copy the Bot ID from the Bot menu in the Developer Portal. This ID is required for the Azure Permissions step.

9. Start chat with bot

   • Click the Preview in Teams button.

   • Click Add to be taken to the bot chat.

Next Step

At this point, the bot is listening, but can't respond yet as some required configuration is outstanding, follow the Azure Permissions