Tikit Virtual Agent Recommended Setup Guide

The following setup guide will walk you through distributing Tikit VIrtual Agent (TVA) to your Teams users. From a high level, you will be publishing the Tikit Virtual Agent custom app to your organization’s app catalog (see Manage your apps in the Microsoft Teams admin center). Next we’ll be creating policies to control access to the app (see Manage app permission policies in Microsoft Teams) as well as pinning and installing Tikit Virtual Agent  for users (see Manage custom app policies and settings). Finally, we’ll go through the process of assigning our new policies to users to grant them permissions and start distributing Tikit Virtual Agent .

To make the Tikit Virtual Agent app available to users from your  organization’s Teams app store, you can either automatically install Tikit Virtual Agent from the Tikit web app or manually publish the Tikit Virtual Agent app package. We’ve detailed the steps for both paths below.

After publishing to your organization’s app store, you can create app permission and setup policies to control access to Tikit Virtual Agent and pin and install Tikit Virtual Agent for your users.

To automatically install the Tikit Virtual Agent to your organization’s app store in Teams:

  1. From Bot Configuration. select Install to Microsoft Teams and Tikit will upload the Tikit Virtual Agent to your organization’s app store. A Teams administrator will need to review and approve the app.
  2. Open Microsoft Teams admin center > Manage Apps and approve the Tikit Virtual Agent app.

See the following for detailed steps:

  1. Open the Tikit web app at https://web.tikit.ai
  2. In the header navigation, select the Settings gear and then open Bot Configuration.
  3. Once in Bot Configuration settings, select Install to Microsoft Teams
  • Tikit will upload the Tikit Virtual Agent to your organization’s app store, but an administrator will need to review and approve the app. We’ll cover those steps next.
  1. In the Microsoft Teams admin center, open Manage Apps then search for and select the Tikit Virtual Agent app. A newly submitted app like Virtual Agent will show a Status of Blocked.
  1. In the Virtual Agent app details, change the status to Allowed

The Tikit Virtual Agent has successfully been uploaded to your Microsoft teams app store and is ready for your users to install. Teams admins can also deploy Virtual Agent to users via a Setup Policy, make sure to pin Virtual Agentto your users sidebar! Check out the sections below on managing app permission policies and app setup policies.

App permissions policies control what apps are available to a user within the Teams app. You can allow or block all apps or specific apps published by Microsoft, third-parties, and your organization (custom apps). You can use the Global (Org-wide default) policy to customize permissions for all users at once or you can create custom permission policies and assign them to a set of users. By default, all users in your organization can access the Tikit Virtual Agent app in your organization’s app store. To restrict and control who has permission to use Tikit Virtual Agent, we will be creating an app permission policy. To learn more, see Manage app permission policies in Microsoft Teams.

In the next steps we will be updating the Global app permission policy to remove the default access to Tikit Virtual Agent and creating a new app permission policy to restrict access to specific users.

  1. Sign in to the Microsoft Teams admin center.
  2. In the left navigation, go to Teams apps > Permission policies.
  3. Select the Global (Org-wide default) policy.
  4. Under Custom apps, select Block all appsIf there are other custom apps in your organization’s app store you may want to change this to to Allow specific apps and block all others to better match your permission requirements. 
  5. Click Save to save the app permission policy.
  1. Sign in to the Microsoft Teams admin center.
  2. In the left navigation, go to Teams apps > Permission policies.
  3. Click Add.
  4. Enter a name and description.
  5. Leave Microsoft apps and Third-party apps as the default Allow all apps, unless your organization has specific permission requirements for those categories. 
  1. Add Tikit Virtual Agent to custom apps list:
    1. Under Custom apps, select Allow specific apps and block all others.
    2. Click Add apps.
    3.  In the Add custom apps pane, search for Tikit Virtual Agent, and then select Allow.
  1. Click Save to save the app permission policy.

We now have a custom app permission policy to control access to Tikit Virtual Agent.

Users who have permissions to Tikit Virtual Agent can find it in your organization’s app store under Built for Your Organization Name on the Apps page in Teams. To make it easy for users to get the app, you can pin the app to the app bar in teams. To do this, we will create an app setup policy.

App setup policies control how apps are made available to a user with the Teams app. You can use the Global (Org-wide default) policy to add and pin Tikit Vritual Agent for all users at once or you can create custom setup policies and assign them to a set of users (see Manage custom app policies and settings). We’ll be creating a new app setup policy for Tikit Virtual Agent and then we can start assigning policies to users.

  1. Sign in to the Microsoft Teams admin center.
  2. In the left navigation, go to Teams apps > Setup policies.
  3. Click Add.
  4. Enter a name and description.
  5. Optionally turn on or off Upload custom apps and Allow user pinning.
  1. To install Tikit Virtual Agent:
    1. Under Installed apps, click Add apps.
    2. In the Add installed apps pane, search for Tikit Virtual Agent, and then select Add.
  1. To pin Tikit Virtual Agent:
    1. Under Pinned apps, click Add apps.
    2. In the Add pinned apps pane, search for Tikit Virtual Agent, and then select Add.
    3. Arrange the apps in the order you want them to appear in Teams.
  1. Click Save to save the app setup policy.

We now have an app setup policy for Tikit Virtual Agent. In combination with the app permission policy we can now control access and easily pin and install Tikit Virtual Agent by assigning the policies to users next.

The Global (Org-wide default) app setup and app permission policies apply to all users in your organization. Custom app policies can be assigned on an individual user basis using the Microsoft Teams admin center. To learn more, see Assign policies to your users in Microsoft Teams.

You can assign the specific app setup or app permissions policies to users directly from the App setup policies or App permission policies pages or in bulk via the Users page. We recommend the Users page to assign both policy types at once for multiple users to make the process a bit simpler, but we do also include the steps for assigning just the app setup or permissions policies:

The easiest path to assigning app setup and app permissions policies to users at once is via the Users page in the Teams admin center:

  1. Sign in to the Microsoft Teams admin center.
  2. In the left navigation, go to Users.
  3. Select users to assign policy and click Edit Settings.
  1. In the Edit settings pane, select the Tikit Virtual Agent app setup and app permissions policies. If you did not create an app permission policy for Tikit Virtual Agent, feel free to keep the existing app permission policy.
  2. Click Apply.

To assign an app setup policy to a user from the App setup policies page:

  1. Sign in to the Microsoft Teams admin center.
  2. In the left navigation, go to Teams apps > Setup policies.
  3. Select the Tikit Virtual Agent policy and click Manage Users.
  1. In the Manage Users pane, search for user by display name or by user name, and then click Add
  2. When you’re finished with the list of users to add, click Apply.

Admins to customize the Tikit Virtual Agent app to enhance appearance and adhere to the organization’s branding. Teams admin can update the app properties based on the organizational needs in the Manage Apps page in Teams admin center. You may refer to Customize appearance of apps in your organization’s Teams store to know the details of which properties you can customize.

To customize the Tikit VIrtual Agent from the Manage Apps page:

  1. Sign in to the Microsoft Teams admin center.
  2. In the left navigation, go to Teams apps > Manage Apps.
  3. Select and click the Tikit Virtual Agent from the list
  1. In the Tikit Virtual Agent manage page, click on the pencil icon to open the Customize pane
  2. In the Customize pane, change up the details as needed 
  3. When you’re finished with changes, click Apply.
In this article